단위 테스트 보고서 예제

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

Unit test reports는 많은 언어와 패키지에 대해 생성할 수 있습니다. 나열된 언어 및 패키지에 대한 단위 테스트 보고서를 생성하기 위해 파이프라인을 구성하는 지침으로 이 예제를 사용하세요. 언어 또는 패키지 버전에 맞게 예제를 편집해야 할 수 있습니다.

루비

.gitlab-ci.yml에서 다음 작업을 사용하세요. 이것은 artifacts:paths 키워드를 포함하여 단위 테스트 보고서 출력 파일에 대한 링크를 제공합니다.

## rspec로 JUnit 보고서 형식의 XML 파일을 생성하기 위해 https://github.com/sj26/rspec_junit_formatter 사용
ruby:
  image: ruby:3.0.4
  stage: test
  before_script:
    - apt-get update -y && apt-get install -y bundler
  script:
    - bundle install
    - bundle exec rspec --format progress --format RspecJunitFormatter --out rspec.xml
  artifacts:
    when: always
    paths:
      - rspec.xml
    reports:
      junit: rspec.xml

Go

.gitlab-ci.yml에서 다음 작업을 사용하세요.

## go로 JUnit 보고서 형식의 XML 파일을 생성하기 위해 https://github.com/gotestyourself/gotestsum 사용
golang:
  stage: test
  script:
    - go install gotest.tools/gotestsum@latest
    - gotestsum --junitfile report.xml --format testname
  artifacts:
    when: always
    reports:
      junit: report.xml

자바

자바에서 JUnit 보고서 형식의 XML 파일을 생성할 수 있는 몇 가지 도구가 있습니다.

그레이들

다음 예시에서는 gradle을 사용하여 테스트 보고서를 생성합니다. 여러 테스트 작업이 정의된 경우, gradlebuild/test-results/ 하위에 여러 디렉터리를 생성합니다. 이 경우 다음 경로를 정의하여 glob 매칭을 활용할 수 있습니다: build/test-results/test/**/TEST-*.xml.

java:
  stage: test
  script:
    - gradle test
  artifacts:
    when: always
    reports:
      junit: build/test-results/test/**/TEST-*.xml

GitLab Runner 13.0 및 이후에는 **를 사용할 수 있습니다.

메이븐

SurefireFailsafe 테스트 보고서를 파싱하기 위해 다음 .gitlab-ci.yml 예제를 사용하세요.

java:
  stage: test
  script:
    - mvn verify
  artifacts:
    when: always
    reports:
      junit:
        - target/surefire-reports/TEST-*.xml
        - target/failsafe-reports/TEST-*.xml

파이썬 예시

이 예제는 pytest 및 --junitxml=report.xml 플래그를 사용하여 출력을 JUnit 보고서 XML 형식으로 포맷팅합니다.

pytest:
  stage: test
  script:
    - pytest --junitxml=report.xml
  artifacts:
    when: always
    reports:
      junit: report.xml

C/C++

C/C++에서 JUnit 보고서 형식의 XML 파일을 생성할 수 있는 몇 가지 도구가 있습니다.

GoogleTest

다음 예시에서는 gtest을 사용하여 테스트 보고서를 생성합니다. 다양한 아키텍처 (x86, x64 또는 arm)용으로 여러 gtest 실행 파일이 생성된 경우, 각 테스트를 실행하고 고유한 파일 이름을 제공해야 합니다. 그런 다음 결과를 모아서 사용합니다.

cpp:
  stage: test
  script:
    - gtest.exe --gtest_output="xml:report.xml"
  artifacts:
    when: always
    reports:
      junit: report.xml

CUnit

CUnitCUnitCI.h 매크로를 사용하여 실행될 때 JUnit 보고서 형식의 XML 파일을 자동으로 생성할 수 있습니다.

cunit:
  stage: test
  script:
    - ./my-cunit-test
  artifacts:
    when: always
    reports:
      junit: ./my-cunit-test.xml

.NET

.NET Framework 및 .NET Core 애플리케이션에 대한 테스트 보고서를 생성할 수 있는 JunitXML.TestLogger NuGet 패키지가 있습니다. 다음 예시는 저장소의 루트 폴더에 솔루션이 있고, 하위 폴더에 하나 이상의 프로젝트 파일이 있는 것으로 기대합니다. 각 테스트 프로젝트당 하나의 결과 파일이 생성되며, 각 파일은 artifacts 폴더에 배치됩니다. 이 예시에는 선택적 형식 지정 인수가 포함되어 있어서 테스트 위젯의 데이터 가독성을 향상시킵니다. 전체 .Net Core 예시를 사용할 수 있습니다.

## 소스 코드 및 문서는 여기에 있습니다: https://github.com/spekt/junit.testlogger/

Test:
  stage: test
  script:
    - 'dotnet test --test-adapter-path:. --logger:"junit;LogFilePath=..\artifacts\{assembly}-test-result.xml;MethodFormat=Class;FailureBodyFormat=Verbose"'
  artifacts:
    when: always
    paths:
      - ./**/*test-result.xml
    reports:
      junit:
        - ./**/*test-result.xml

JavaScript

JavaScript에서 JUnit 보고서 형식의 XML 파일을 생성할 수 있는 몇 가지 도구가 있습니다.

Jest

jest-junit npm 패키지는 JavaScript 애플리케이션에 대해 테스트 보고서를 생성할 수 있습니다. 다음 .gitlab-ci.yml 예제에서 javascript 작업은 Jest를 사용하여 테스트 보고서를 생성합니다.

javascript:
  image: node:latest
  stage: test
  before_script:
    - 'yarn global add jest'
    - 'yarn add --dev jest-junit'
  script:
    - 'jest --ci --reporters=default --reporters=jest-junit'
  artifacts:
    when: always
    reports:
      junit:
        - junit.xml

.test.js 파일에 단위 테스트가 없을 때 작업을 통과하려면 script: 섹션의 jest 명령 끝에 --passWithNoTests 플래그를 추가하면 됩니다.

Karma

Karma-junit-reporter npm 패키지는 JavaScript 애플리케이션을 위한 테스트 보고서를 생성할 수 있습니다. 다음 .gitlab-ci.yml 예제에서 javascript 작업은 테스트 보고서를 생성하기 위해 Karma를 사용합니다:

javascript:
  stage: test
  script:
    - karma start --reporters junit
  artifacts:
    when: always
    reports:
      junit:
        - junit.xml

Mocha

Mocha를 위한 JUnit Reporter NPM 패키지는 JavaScript 애플리케이션을 위한 테스트 보고서를 생성할 수 있습니다. 다음 .gitlab-ci.yml 예제에서 javascript 작업은 테스트 보고서를 생성하기 위해 Mocha를 사용합니다:

javascript:
  stage: test
  script:
    - mocha --reporter mocha-junit-reporter --reporter-options mochaFile=junit.xml
  artifacts:
    when: always
    reports:
      junit:
        - junit.xml

Flutter 또는 Dart

이 예제 .gitlab-ci.yml 파일은 flutter test 출력을 JUnit 보고서 XML 형식으로 변환하기 위해 JUnit Report 패키지를 사용합니다:

test:
  stage: test
  script:
    - flutter test --machine | tojunit -o report.xml
  artifacts:
    when: always
    reports:
      junit:
        - report.xml

PHP

이 예제는 --log-junit 플래그와 함께 PHPUnit을 사용합니다. 또한 이 옵션을 phpunit.xml 구성 파일에서 추가할 수 있습니다.

phpunit:
  stage: test
  script:
    - composer install
    - vendor/bin/phpunit --log-junit report.xml
  artifacts:
    when: always
    reports:
      junit: report.xml

Rust

이 예제는 현재 디렉토리에 설치된 cargo2junit를 사용합니다. cargo test에서 JSON 출력을 검색하려면 nightly 컴파일러를 활성화해야 합니다.

run unittests:
  image: rust:latest
  stage: test
  before_script:
    - cargo install --root . cargo2junit
  script:
    - cargo test -- -Z unstable-options --format json --report-time | bin/cargo2junit > report.xml
  artifacts:
    when: always
    reports:
      junit:
        - report.xml

Helm

이 예제는 -t junit 플래그를 사용하여 JUnit 보고서를 XML 형식으로 포맷하는 Helm Unittest 플러그인을 사용합니다.

helm:
  image: helmunittest/helm-unittest:latest
  stage: test
  script:
    - '-t JUnit -o report.xml -f tests/*[._]test.yaml .'
  artifacts:
    reports:
      junit: report.xml

-f tests/*[._]test.yaml 플래그는 helm-unittesttests/ 디렉토리에 있는 다음 중 하나로 끝나는 파일을 찾도록 구성합니다:

  • .test.yaml
  • _test.yaml