Specmatic Insights Github Build Reporter
This package runs as part of your CI pipeline to ship Specmatic reports to Specmatic Insights.
Please contact Specmatic team for more info.
Docker Usage in GitHub Actions
- name: Run Specmatic Insights Github Build Reporter
run: |
docker run \
-v ${{ github.workspace }}:/workspace \
specmatic/specmatic-insights-github-build-reporter:latest \
--specmatic-insights-host https://insights.specmatic.io \
--specmatic-reports-dir /workspace/build/reports/specmatic \
--org-id ${{ secrets.SPECMATIC_ORG_ID }} \
--branch-name ${{ github.ref_name }} \
--repo-name ${{ github.event.repository.name }} \
--repo-id ${{ github.repository_id }} \
--repo-url ${{ github.event.repository.html_url }}
Direct NPM Usage in GitHub Actions
- name: Run Specmatic Insights Github Build Reporter
run: |
npx specmatic-insights-github-build-reporter \
--org-id ${{ secrets.SPECMATIC_ORG_ID }} \
--branch-name ${{ github.ref_name }} \
--repo-name ${{ github.event.repository.name }} \
--repo-id ${{ github.repository_id }} \
--repo-url ${{ github.event.repository.html_url }}
Testing locally
Before you're able to test locally, you'll have to link the specmatic-insights-github-build-reporter
package to your local npm
registry.
Run the following command in the root directory of the specmatic-insights-github-build-reporter
package:
npm link
Next, link the specmatic-insights-github-build-reporter
package to your local npm
registry in the root directory of your specmatic project, e.g. specmatic-order-api-java
:
npm link specmatic-insights-github-build-reporter
Now you can run the build reporter locally to send builds to your local insights server using the following command:
npx specmatic-insights-github-build-reporter \
--specmatic-insights-host=http://localhost:8080 \
--org-id <org-id> \
--branch-name <branch-name> \
--repo-name <repo-name> \
--repo-id <repo-id> \
--repo-url <repo-url>
To revert the changes, run the following commands:
npm unlink specmatic-insights-github-build-reporter
npm unlink