FeaturesCI/CDOverview

CI/CD Integration

Run BugBrain tests automatically on every push, pull request, or on a schedule using your CI/CD platform.

How It Works

1. Developer pushes code
2. CI pipeline triggers
3. BugBrain tests run in parallel
4. Results returned to CI
5. Merge blocked if tests fail

Supported Platforms

  • GitHub Actions — Native webhook integration
  • GitLab CI — Native webhook integration
  • Jenkins — curl-based webhook
  • CircleCI — Generic webhook
  • Azure DevOps — Generic webhook
  • Any system — HTTP POST webhook support

Quick Start

1. Generate CI/CD Token

Go to Settings → CI/CD and click “Generate Token”. You’ll get:

  • Webhook URL
  • Webhook Secret

2. Add to CI Configuration

For GitHub Actions, add to .github/workflows/test.yml:

- name: Trigger BugBrain
  run: |
    curl -X POST ${{ secrets.BUGBRAIN_WEBHOOK_URL }} \
      -H "X-Gitlab-Token: ${{ secrets.BUGBRAIN_WEBHOOK_SECRET }}" \
      -d '{"ref":"${{ github.ref }}","commit":"${{ github.sha }}"}'

3. Watch Tests Run

Tests automatically trigger. View results in BugBrain dashboard or in your CI logs.

Configuration Options

  • Which test plan to run — Specify via env variable
  • When to trigger — On push, on PR, on schedule
  • Fail if tests fail — Block merge if tests don’t pass
  • Parallel execution — Run with other CI steps

Next Steps

GitHub Actions Setup — Full GitHub Actions guide

Knowledge MapsSetup Guide