Jira 개발 패널
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
Jira 개발 패널을 사용하면 Jira 이슈에 대한 GitLab 활동을 Jira에서 직접 확인할 수 있습니다. 개요는 Jira 개발 패널 통합을 참고합니다. 다음 표는 Jira DVCS 커넥터와 GitLab for Jira Cloud 앱에서 사용할 수 있는 기능을 보여줍니다:
Jira 개발 패널을 사용하면 Jira 이슈에 대한 GitLab 활동을 Jira에서 직접 확인할 수 있습니다. Jira 개발 패널을 설정하려면 다음과 같이 진행합니다:
- Jira Cloud의 경우 GitLab에서 개발하고 유지 관리하는 GitLab for Jira Cloud 앱을 사용합니다.
- Jira Data Center 또는 Jira Server의 경우 Atlassian에서 개발하고 유지 관리하는 Jira DVCS 커넥터를 사용합니다.
개요는 Jira 개발 패널 통합을 참고합니다.
기능 가용성#
히스토리
- 브랜치 삭제 기능이
jira_connect_remove_branches라는 기능 플래그와 함께 GitLab 17.1에서 도입되었습니다. 기본값은 비활성화입니다. - 브랜치 삭제 기능이 GitLab 17.2에서 일반 공급되었습니다.
jira_connect_remove_branches기능 플래그가 제거되었습니다.
다음 표는 Jira DVCS 커넥터와 GitLab for Jira Cloud 앱에서 사용할 수 있는 기능을 보여줍니다:
| 기능 | Jira DVCS 커넥터 | GitLab for Jira Cloud 앱 |
|---|---|---|
| 스마트 커밋 | ✅ | ✅ |
| 머지 리퀘스트 동기화 | ✅ | ✅ |
| 브랜치 동기화 | ✅ | ✅ |
| 커밋 동기화 | ✅ | ✅ |
| 기존 데이터 동기화 | ✅ | ✅ (Jira에 동기화되는 GitLab 데이터 참고) |
| 빌드 동기화 | ❌ | ✅ |
| 배포 동기화 | ❌ | ✅ |
| 기능 플래그 동기화 | ❌ | ✅ |
| 동기화 주기 | 최대 60분 | 실시간 |
| 브랜치 삭제 | ❌ | ✅ |
| 브랜치에서 머지 리퀘스트 생성 | ✅ | ✅ |
| Jira 이슈에서 브랜치 생성 | ❌ | ✅ |
GitLab에서 연결된 프로젝트#
Jira 개발 패널은 Jira 인스턴스와 그 안의 모든 프로젝트를 다음에 연결합니다:
- GitLab for Jira Cloud 앱의 경우, 연결된 GitLab 그룹 또는 하위 그룹과 해당 프로젝트
- Jira DVCS 커넥터의 경우, 연결된 GitLab 그룹, 하위 그룹 또는 개인 네임스페이스와 해당 프로젝트
개발 패널에 표시되는 정보#
GitLab에서 Jira 이슈를 ID로 참조하면 Jira 개발 패널에서 Jira 이슈에 대한 GitLab 활동을 확인 할 수 있습니다. 개발 패널에 표시되는 정보는 GitLab에서 Jira 이슈 ID를 언급한 위치에 따라 달라집니다.
GitLab for Jira Cloud 앱의 경우 다음 정보가 표시됩니다.
| GitLab: Jira 이슈 ID를 언급하는 위치 | Jira 개발 패널: 표시되는 정보 |
|---|---|
| 머지 리퀘스트 제목 또는 설명 | 머지 리퀘스트로 연결되는 링크 배포로 연결되는 링크 머지 리퀘스트 제목을 통한 파이프라인으로 연결되는 링크 머지 리퀘스트 설명을 통한 파이프라인으로 연결되는 링크 브랜치로 연결되는 링크 리뷰어 정보 및 승인 상태 |
| 브랜치 이름 | 브랜치로 연결되는 링크 배포로 연결되는 링크 |
| 커밋 메시지 | 커밋으로 연결되는 링크 환경에 대한 마지막 성공적인 배포 이후 최대 2,000개 커밋에서의 배포로 연결되는 링크 |
| Jira 스마트 커밋 | 사용자 지정 댓글, 기록된 시간 또는 워크플로 전환 |
Jira 이슈 키 제한#
Jira는 단일 커밋, 브랜치, 머지 리퀘스트, 빌드, 배포 또는 기능 플래그에 대해 Jira 이슈 키를 최대 500개까지 허용합니다. GitLab이 이러한 엔터티 하나에서 서로 다른 Jira 이슈 키를 500개보다 많이 추출하면 처음 500개만 Jira로 전송합니다. 나머지 이슈 키는 개발 패널에 연결되지 않습니다. 배포의 경우 GitLab은 목록을 자를 때 커밋 및 머지 리퀘스트 연결보다 이슈 키를 우선합니다. 이 제한은 GitLab이 아니라 Jira가 정한 것입니다.
Jira 스마트 커밋#
사전 요구 사항:
- GitLab과 Jira 사용자 계정이 동일한 이메일 주소 또는 사용자 이름을 사용해야 합니다.
- 명령은 커밋 메시지의 첫 번째 줄에 있어야 합니다.
- 커밋 메시지는 한 줄을 초과할 수 없습니다.
Jira 스마트 커밋은 Jira 이슈를 처리하기 위한 특수 명령입니다. 이 명령을 사용하면 GitLab에서 다음을 수행할 수 있습니다:
- Jira 이슈에 사용자 지정 댓글을 추가합니다.
- Jira 이슈에 대해 시간을 기록합니다.
- Jira 이슈를 프로젝트 워크플로에 정의된 모든 상태로 전환합니다.
스마트 커밋은 다음 구문을 따라야 합니다:
<ignored text> #<command> <optional command parameters>
하나의 커밋에서 하나 이상의 명령을 실행할 수 있습니다.
스마트 커밋 구문#
| 명령 | 구문 |
|---|---|
| 댓글 추가 | KEY-123 #comment Bug is fixed |
| 시간 기록 | KEY-123 #time 2w 4d 10h 52m Tracking work time |
| 이슈 닫기 | KEY-123 #close Closing issue |
| 시간 기록 및 이슈 닫기 | KEY-123 #time 2d 5h #close |
| 댓글 추가 및 In-progress로 전환 | KEY-123 #comment Started working on the issue #in-progress |
스마트 커밋의 작동 방식과 사용 가능한 명령에 대한 자세한 내용은 다음을 참고합니다:
Jira 배포#
Jira 배포를 사용하면 소프트웨어 릴리스의 진행 상황을 Jira에서 직접 추적하고 시각화할 수 있습니다.
GitLab은 다음 조건을 만족하면 환경 및 배포에 대한 정보를 Jira로 전송합니다:
- 프로젝트의
.gitlab-ci.yml파일에environment키워드가 포함되어 있습니다. - GitLab의 특정 위치에서 Jira 이슈 ID가 언급되고 파이프라인이 트리거됩니다.
자세한 내용은 환경 및 배포를 참고합니다.