이 문서는 Jira Cloud에서 Xray애드온을 사용하여 테스트를 실행을 자동화하고 Xray 테스트 플랜에서 결과를 확인하는 방법을 설명합니다.
사전 준비 사항
GitLab 프로젝트 설정 완료
Xray에서 테스트 플랜 생성
단계별 가이드
1. API 생성
앱 관리 > Xray > API Keys로 이동합니다.
API 키를 생성한 후, Client ID와 Client Secret을 저장합니다.
2. GitLab 토큰 생성
Gitlab 프로젝트 Settings > CI/CD로 이동합니다.
Pipeline trigger tokens에서 트리거 토큰을 생성합니다.
3. Xray로 연결 설정
Variables에서 다음 변수를 추가합니다.
client_id (API 키에서 제공된 id)
client_secret (API 키에서 제공된 secret code)
xray_endpoint (Xray의 기본 URL)
GitLab의 프로젝트 리포지토리에 파이프라인 설정 파일(.gitlab-ci.yml)을 생성합니다.
4. Jira의 Automation기능을 사용하여 트리거 생성
Jira 프로젝트 설정 > Automation으로 이동합니다.
새 규칙을 만들고 “When”을 “이슈에서 수동 트리거”로 설정합니다.
다음으로, 이 규칙이 테스트 플랜 이슈에만 실행될 수 있도록 조건을 정의합니다.
“Then”을 “웹 요청 전송”으로 설정 후 다음과 같이 필드를 정의합니다.
웹 요청 URL : https://gitlab.com/api/v4/projects/<project_id_in_gitlab>/trigger/pipeline
HTTP 메서드 : POST
웹 요청 본문 : 사용자 정의 데이터
사용자 정의 데이터 : token=<Gitlad에서 생성한 토큰>&ref=<브랜치 이름>&variables[TESTPLAN]={{issue.key}}
5. 트리거 실행
테스트 플랜 “상태”를 “진행 중”으로 변경 후, “작업”에서 트리거 실행 후 통과(Passed) 또는 실패(Failing) 결과를 확인할 수 있습니다.
통과 시, 테스트와 테스트 실행 페이지가 생성됩니다.
테스트 실행(execution) 페이지에서 연결된 테스트 플랜을 확인할 수 있습니다.
