무료GitHub에 공개한국어 소개

test

CI 설정에 맞춰 SkyWalking 단위 테스트, 통합 테스트 또는 별도의 느린 통합 테스트를 실행하는 방법을 안내합니다. 테스트 그룹이나 Maven 모듈을 선택하고 각 단계에서 실행되는 테스트와 이름 및 태그 규칙을 확인할 수 있습니다.

원문원문 설명 보기

Run unit tests, integration tests, or slow integration tests matching CI. Use to validate changes before submitting a PR.

apache/skywalking스타 24,978(GitHub 24,978 + cccskills 0)

실행 점수 미검증

설치 방법 보기

이럴 때 유용합니다

PR 제출 전에 단위 테스트 실행
느린 테스트를 제외하고 통합 테스트 실행
Maven 모듈 하나만 검증
Elasticsearch 또는 OpenSearch 느린 테스트 실행

한국어 소개

할 수 있는 일

이 스킬은 CI 설정에 맞춰 SkyWalking 단위 테스트, 통합 테스트, 느린 통합 테스트를 실행하는 방법을 안내합니다. 인수를 생략하거나 unit을 지정하면 단위 테스트를 실행하고, integration은 느린 테스트를 제외한 통합 테스트를 실행하며, slow는 느린 테스트 그룹을 실행합니다. 모듈 이름을 지정해 해당 모듈의 테스트만 실행할 수도 있습니다. 테스트 이름 규칙과 Maven 실행 단계, @Tag("slow")를 이용한 분류도 설명하므로 각 명령이 어떤 테스트를 실행하는지 파악할 수 있습니다.

이럴 때 유용합니다

PR 제출 전에 CI에서 사용하는 테스트 종류로 변경 사항을 확인할 때 사용할 수 있습니다. 전체 테스트 전에 특정 모듈만 검사하거나 일반 통합 테스트 작업에서 제외되는 Elasticsearch/OpenSearch 테스트를 따로 실행할 때도 유용합니다.

사용 예시

“변경 사항을 확인하도록 단위 테스트를 실행해 주세요.”
“느린 테스트를 빼고 통합 테스트를 실행하고 싶습니다.”
“지정한 모듈의 통합 테스트 명령을 알려 주세요.”

주의 사항

Maven Wrapper를 사용합니다. CI에서는 테스트 종류에 따라 JDK 버전과 운영 체제 조건이 다릅니다. 테스트가 실패하면 CI 재시도에 의존하지 말고 원인을 조사하도록 안내합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

문서 점검

AI가 SKILL.md의 내용에서 주의가 필요한 작업과 도입 전제를 확인했습니다. 점수는 실제로 실행한 결과(실행 검증)만으로 매깁니다.

안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호명령으로 테스트 범위를 지정하며 실패 원인을 조사하도록 안내합니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: B일부 부족Maven Wrapper를 사용하고 CI의 JDK 및 운영 체제 조건을 제시하지만 설치 절차는 없습니다.

점수에는 넣지 않았습니다. 2026년 10월 29일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(1)

SKILL.md2.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Tests

Run tests matching CI configuration.

Commands by argument

`unit` or no argument — unit tests

./mvnw clean test -q -B -D"checkstyle.skip"

CI runs this on:

JDK 11: ubuntu, macOS, Windows
JDK 17, 21, 25: ubuntu only

`integration` — integration tests (excludes slow)

./mvnw -B clean integration-test -Dcheckstyle.skip -DskipUTs=true -DexcludedGroups=slow

CI runs this on JDK 11, 17, 21, 25 (ubuntu only).

`slow` — slow integration tests

./mvnw -B clean integration-test -Dcheckstyle.skip -DskipUTs=true \
  -Dit.test=org.apache.skywalking.library.elasticsearch.ElasticSearchIT \
  -Dfailsafe.failIfNoSpecifiedTests=false

CI runs on JDK 11 (ubuntu only). Currently only ElasticSearch/OpenSearch IT is in the slow matrix.

Module name — single module tests

# Unit tests for a specific module
./mvnw clean test -pl oap-server/analyzer/<module-name> -D"checkstyle.skip"

# Integration tests for a specific module
./mvnw -B clean integration-test -pl oap-server/analyzer/<module-name> -Dcheckstyle.skip -DskipUTs=true

Test frameworks

JUnit 5 (org.junit.jupiter)
Mockito for mocking
AssertJ for assertions
PowerMock for reflection utilities

Test naming conventions

Type	Pattern	Maven phase
Unit tests	`*Test.java`	`test`
Integration tests	`IT.java` or `IT.java`	`integration-test`

Slow test tagging

Tests tagged with @Tag("slow") are excluded from the normal integration-test job and run separately in the slow-integration-test job. Use this tag for tests that spin up external services (Elasticsearch, etc.) and take significant time.

CI retry behavior

All three CI jobs retry on failure (run the same command twice with ||). This handles flaky tests but masks intermittent issues — if a test fails locally, investigate rather than relying on retries.

CI reference

CI workflow: .github/workflows/skywalking.yaml

Job	JDK	OS	Timeout
`unit-test`	11 (3 OS) + 17, 21, 25 (ubuntu)	ubuntu, macOS, Windows	30 min
`integration-test`	11, 17, 21, 25	ubuntu	60 min
`slow-integration-test`	11	ubuntu	60 min

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

ci-e2e-debug

무료요약 있음

GitHub Actions에서 실패한 E2E 테스트를 조사하는 스킬입니다. 실행 로그 산출물을 가져와 OAP와 다른 구성 요소의 오류를 확인하고, 별도 테스트 프로세스의 실패까지 포함해 원인 후보를 정리합니다.

GitHub Actions E2E 실패 조사
OAP, BanyanDB, UI 로그 확인
별도 테스트 프로세스의 실패 추적