Easily connect your GitHub Actions CI workflows to BuildPulse to help you find and fix flaky tests.

1. Locate the BuildPulse credentials for your account at buildpulse.io

2. In the GitHub settings for your repository, create an encrypted secret named BUILDPULSE_ACCESS_KEY_ID and set its value to the BUILDPULSE_ACCESS_KEY_ID for your account

3. Create another encrypted secret named BUILDPULSE_SECRET_ACCESS_KEY and set its value to the BUILDPULSE_SECRET_ACCESS_KEY for your account

4. Add a step to your GitHub Actions workflow to use this action to send your test results to BuildPulse:

   steps:
   - name: Check out code
     uses: actions/checkout@v2
   
   - name: Run tests
     run: echo "Run your tests and generate XML reports for your test results"
   
   - name: Upload test results to BuildPulse for flaky test detection
     if: '!cancelled()' # Run this step even when the tests fail. Skip if the workflow is cancelled.
     uses: buildpulse/buildpulse-action@main
     with:
       account: <buildpulse-account-id>
       repository: <buildpulse-repository-id>
       path: |
         reports/junit.xml # <path-to-xml-reports>
         reports2/**/junit.xml # support double globbing (if your github-hosted runner OS uses bash 4+)
       key: ${{ secrets.BUILDPULSE_ACCESS_KEY_ID }}
       secret: ${{ secrets.BUILDPULSE_SECRET_ACCESS_KEY }}
       coverage-files: coverage/report.xml # IF PURCHASED
       tags: e2e team1 staging # OPTIONAL

Required The unique numeric identifier for the BuildPulse account that owns the repository.

Required The unique numeric identifier for the repository being built.

Required The path to the XML file(s) for the test results. Can be a directory (e.g., test/reports), a single file (e.g., reports/junit.xml), or a glob (e.g., app/*/results/*.xml).

Required The BUILDPULSE_ACCESS_KEY_ID for the account that owns the repository.

Required The BUILDPULSE_SECRET_ACCESS_KEY for the account that owns the repository.

Optional The SHA for the commit that produced the test results (default: the value of ${{ github.sha }}, which is the commit that triggered the workflow).

If your workflow checks out a different commit than the commit that triggered the workflow, then use this input to specify the commit SHA that your workflow checked out. For example, if your workflow is triggered by the pull_request event, but you customize the workflow to check out the pull request HEAD commit, then you'll want to set this input to the pull request HEAD commit SHA.

Optional The path to the local git clone of the repository (default: ".").

Optional The paths to the coverage file(s) for the test results (space-separated).

Optional Tags to apply to this build (space-separated).

Optional Quota ID to count this upload against. Please set on BuildPulse Dashboard first.