Using Launchable GitHub Actions

This guide explains connecting your GitHub Actions workflow to your Launchable workspace. When complete, data from your test runs will be sent to your Launchable workspace so you can use Launchable's features.

Note: this guide does not cover Requesting and running a subset of tests. You'll need to use the Launchable CLI for that.

Create and set your API key

Create an API key on the Settings page of your Launchable workspace. (Click the cog ⚙️ icon in the sidebar.)

Then create an encrypted secret called LAUNCHABLE_TOKEN with your Launchable API key as its value.

Add the Launchable action

Then, locate the step in your workflow where you run tests. It might look something like this:

jobs:
  tests:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
        with:
          fetch-depth: 0
      - name: Test
        run: <YOUR TEST COMMAND HERE>

After this, add the Launchable record build and test results action (lines 6-12 below).

The Use latest version button on the GitHub Marketplace page only adds the name: and uses: lines.

Add the with:, if:, and env: lines as shown below:

1steps:
2      - uses: actions/checkout@v3
3        with:
4          fetch-depth: 0
5      - name: Test
6        run: <YOUR TEST COMMAND HERE>
7      - name: Record test results to Launchable workspace
8        uses: launchableinc/record-build-and-test-results-action@v1.0.0
9        with:
10          report_path: <PATH TO TEST REPORT XML FILES>
11          test_runner: <YOUR TEST RUNNER HERE>
12        if: always()
13        env:
14          LAUNCHABLE_TOKEN: ${{ secrets.LAUNCHABLE_TOKEN }}

Then, based on your test runner, set test_runner and report_path values as shown below.

You may need to modify the report_path value to match your setup, so the values below are just suggestions.

test_runner: raw
report_path: <PATH TO YOUR REPORT FILES>

Run tests

Run your workflow once you've added the action and set the variables.

If successful, you'll see Launchable output in your build logs, and you'll see your build and test session in the Launchable web app at app.launchableinc.com.

If unsuccessful, you might need to modify your test runner command to ensure it creates test reports that Launchable accepts ⤵️

Update your test runner command

Some tools need to be run in a special way to generate reports that Launchable can read:

Next steps

• Get Test Notifications via Slack, and

• See Trends in your test sessions,

• Find Unhealthy Tests,

• Save time running tests and run tests earlier with Predictive Test Selection

Example implementation

1name: Maven test process
2
3on:
4  push:
5    branches: [main]
6  pull_request:
7
8jobs:
9  tests:
10    runs-on: ubuntu-latest
11    steps:
12      - uses: actions/checkout@v3
13        with:
14          fetch-depth: 0
15      - name: Test
16        run: mvn test
17      - name: Record test results to Launchable workspace
18        uses: launchableinc/record-build-and-test-results-action@v1.0.0
19        with:
20          test_runner: maven
21          report_path: './**/target/surefire-reports'
22        if: always()
23        env:
24          LAUNCHABLE_TOKEN: ${{ secrets.LAUNCHABLE_TOKEN }}