This repository is a practical JUnit + Jira integration example using @testream/junit-reporter. It shows how to run JUnit 5 tests, generate Maven Surefire XML, and upload results to Jira through Testream from local runs and GitHub Actions.

If you are searching for "JUnit Jira reporter", "Maven test results to Jira", or "GitHub Actions JUnit Jira integration", this repo is the implementation template.

• Maven-based flow: Uses standard Surefire XML output.
• CI-safe upload pattern: Keeps upload step running even when tests fail.
• Minimal wiring: Reporter auto-detects most CI metadata.
• Real triage demo: Intentional failing tests show Jira-side failure handling.

Testream is an automated test management and reporting platform for Jira teams. It ingests test results from JUnit and many other frameworks, then provides failure diagnostics, trends, and release-level quality views in Jira.

If this sample repository is not the framework you need, browse all native reporters in the Testream docs: https://docs.testream.app/.

Click to see how Testream turns raw CI test results into actionable Jira insights (failures, trends, and release visibility):

Install Testream Automated Test Management and Reporting for Jira in your Jira workspace to view uploaded runs.

src/
  main/java/com/example/shoppingcart/
    Cart.java
    CartItem.java
    Product.java
    Discount.java
  test/java/com/example/shoppingcart/
    CartTest.java     - Passing + intentional failure
    ProductTest.java  - Passing + intentional failure
    DiscountTest.java - Passing + intentional failure
pom.xml
.github/workflows/junit.yml
.env.example

The intentional failures help you verify how failed JUnit tests appear in Testream/Jira.

1. Sign in at testream.app.
2. Create a project.
3. Copy your API key.

mvn test -DskipTests

Requires Java 17+ and Maven 3.8+.

For local uploads:

export TESTREAM_API_KEY=<your key>

For CI uploads, add it as a GitHub Actions secret.

mvn test

Surefire writes XML reports to target/surefire-reports/.

npx @testream/junit-reporter \
  --api-key "$TESTREAM_API_KEY" \
  --app-name junit-jira-reporter-example \
  --test-environment local \
  --test-type unit \
  --fail-on-error

This repo uses the CLI uploader, which reads JUnit XML and uploads to Testream.

Key behavior:

• Default XML path matches Surefire output (target/surefire-reports/TEST-*.xml).
• You can override report path with --junit-path.
• --fail-on-error is enabled in CI upload step.
• CI metadata (branch, commit-sha, repository-url, build-number, build-url) is auto-detected.

Reporter docs: https://docs.testream.app/reporters/junit

The workflow at .github/workflows/junit.yml runs on pushes, pull requests, and manual dispatch.

Add this repository secret:

Settings -> Secrets and variables -> Actions -> New repository secret

Important CI pattern used in this repo:

• Maven runs with -Dmaven.test.failure.ignore=true so upload still executes even if tests fail.

After connecting Testream to Jira, you get:

• Dashboard summaries for run health
• Failure diagnostics with stack traces and assertion details
• Trend analytics over time
• Jira issue creation directly from failed tests

• Ensure TESTREAM_API_KEY is set in env/secrets.
• Confirm JUnit XML exists in target/surefire-reports/.

• Pass explicit glob with --junit-path, for example: --junit-path "./build/test-results/**/*.xml"

• Verify Testream project is connected to the correct Jira workspace.

It is an example repository with production-style CI and upload wiring intended for adaptation.

To demonstrate end-to-end failure triage in Jira.

Yes, as long as you produce JUnit XML and point @testream/junit-reporter at that path.

• Testream app: https://testream.app
• Testream Automated Test Management and Reporting for Jira: https://marketplace.atlassian.com/apps/3048460704/testream-automated-test-management-and-reporting-for-jira
• JUnit reporter docs: https://docs.testream.app/reporters/junit
• JUnit docs: https://junit.org/junit5/