Skip to content
cccskills
FreePublished on GitHub

ats-build

Handle common Apache Traffic Server build tasks with CMake: choose a preset, configure a build directory, build a target, run unit tests or AuTest, format code, and install. The guide also points to options for enabling features such as HTTP/3 and experimental plugins.

OriginalShow the original description

Basic skills; formatting, compiling, testing, installing.

apache/trafficserver1,994 stars(GitHub 1,994 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Configuring an ATS development build with CMake
  • Building a specific executable or library target
  • Running unit tests or AuTest
  • Formatting code or installing a build

Files included (1)

  • SKILL.md1.3 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Build Process

  1. Which cmake --list-presets?
  • Need HTTP3? ci-fedora-quiche
  • Not sure? Ask.
  1. No build directory yet? Configure one.
  2. Which target?
  3. Execute.

Reference

Configure Development Build

cmake --preset <name> [-B <build_dir>] -DENABLE_AUTEST=ON

Build Code Target

cmake --build <build_dir> --target <executable_or_library_target>

Run Unit Test

ctest --test-dir <build_dir> [-R <filter>]

Format

cmake --build <build_dir> --target format

Run AuTest

Options correct? Check:

grep "^AUTEST_OPTIONS" <build_dir>/CMakeCache.txt

Correct? Run:

cmake --build <build_dir> --target autest

Example: Configure Build for Specific AuTest

cmake -B <build_dir> -DAUTEST_OPTIONS="-f <autest_name>"

Install

Install location OK? Check:

grep "^CMAKE_INSTALL_PREFIX" <build_dir>/CMakeCache.txt

Correct? Run:

cmake --install <build_dir>

Key CMake Options

  • BUILD_EXPERIMENTAL_PLUGINS=ON - Enable experimental plugins
  • ENABLE_QUICHE=ON - QUIC/HTTP3 support
  • ENABLE_CRIPTS=ON - Cripts scripting API
  • BUILD_REGRESSION_TESTING=ON - Enable test suite
  • ENABLE_ASAN=ON - Configure ASan instrumentation

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

convert-autest-to-urtest

FreeSummary

Migrate Apache Traffic Server AuTests to pytest-based Uranium tests while preserving cases, assertions, traffic behavior, and process lifecycle. Guidance covers choosing replay or native Python tests, retaining controls and diagnostics, handling rebase changes, and verifying collection and execution.

  • Migrating AuTest cases to Uranium tests
  • Preserving assertions and process behavior during conversion
  • Reviewing test changes during a requested branch rebase
apache/trafficserver2KUpdated Oct 29, 2026

See all skills by apache

Report a problem with this skill