Antithesis logomark
DOCS
Log in Book a demo

Launching tests

Once you’ve written a test, you’re ready to run it. Antithesis gives you several ways to launch a test:

  • from the web app
  • with the API
  • through your CI
  • with the Snouty CLI

Product surfaces

From the web app

In the web app, the Test launchers tab lets you configure test parameters and launch a test.

Configuring test parameters

Antithesis tests are all configurable using a standard set of parameters. Clicking on a test launcher opens a dialogue box with the available parameters for that test.

You must provide values for parameters in the main dialogue in order to launch the test. Less frequently used parameters are hidden in fold-down menus. All parameters come with sensible default values pre-filled where possible.

If you’d like to receive the triage report by email, make sure to specify a report recipient — the report is always accessible in the web app.

Illustration 0

You can also configure a test in the launcher, then copy the webhook code with one click.

Creating new tests

Every Antithesis tenant comes with several pre-written tests.

New tests can be added to customize elements like the hostility of the test environment, which containers are exposed to faults, or the types of faults injected.

Your Antithesis team can help you with this process. Please contact us at support@antithesis.com or ask on our Discord.

Once the test is created, you’ll be able to configure and launch it with a test launcher.

With the API

The Launch a test run endpoint lets you configure test parameters and start a test run programatically.

Through your CI

Antithesis integrates natively with GitHub Actions through the Antithesis Trigger Action. You can easily trigger a test run through your workflow and have the results reported back natively in GitHub. Follow the README to step it up.

With Snouty CLI

Install Snouty CLI, then run snouty launch to push your container images and start a test run.

What’s next

Once your test is running, Antithesis will setup and explore your system for the configuration duration of time. You can look at the logs stream in with the logs explorer. Once complete, Antithesis generates a triage report summarizing the test results. Understand your test results gives you several surfaces to consume your test results.