CI / CD Integration

Running tests on every change you introduce to your software is crucial to ensure your application behaves as expected. Stably allows you to run your tests from any CI / CD environment. You can either use our GitHub Action or call our API to execute a test programmatically.

Get API Key

Go to the settings page on the Web UI to get your API key.

Add to CI / CD

Create a secret for your API Key: Go to your GitHub repository, click on “Settings” > “Secrets and variables” > “Actions”. Then create a new Repository Secret named STABLY_API_KEY and paste your API Key into the secret value.
From a test group’s page, click on the Add to CI button to get the code snippet that contains the test group ID.
After copying the code snippet, create the file .github/workflows/stably.yaml in your GitHub repository and paste the code snippet there.

The code snippet should look like this example:

name: Stably Test Runner Example

on:
  pull_request:
  push:
    branches:
      - master

# You need to set these permissions if using the `github-comment` option
permissions:
  pull-requests: write
  contents: write

jobs:
  stably-test-action:
    name: Stably Test Runner
    runs-on: ubuntu-latest

    steps:
      - name: Global Setup
        run: echo "Running global setup tasks"

      - name: Stably Runner Action
        id: stably-runner
        uses: stablyhq/stably-runner-action@v3
        with:
          api-key: ${{ secrets.STABLY_API_KEY }}
          test-group-id: xxxxxxxxxxxxxxx # REPLACE WITH YOUR TEST GROUP ID

      - name: Global Tear Down
        run: echo "Running global tear down tasks"

The Stably API enables you to execute test groups programmatically. To authenticate and run tests, you’ll need two required information:

A Stably API key for authentication
A test group ID that specifies which tests to run

To execute a test, simply run this curl command:

export TEST_GROUP_ID=your-group-id
export STABLY_API_KEY=your-api-key # Prefer to use secrets

curl -X 'POST' \
"https://api.stably.ai/testGroup/$TEST_GROUP_ID/run" \
-H "accept: application/json" \
-H "x-stably-api-key: $STABLY_API_KEY"

Get Started

Run Tests

Trouble Shooting

CI / CD Integration