Jira 이슈 관리

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

GitLab에서 Jira 이슈를 직접 관리할 수 있습니다(구성 방법). 그런 다음 GitLab의 커밋 및 병합 요청에서 Jira 이슈 ID를 참조할 수 있습니다. Jira 이슈 ID는 대문자여야 합니다.

GitLab 활동 및 Jira 이슈 교참참조

이 통합을 사용하면 GitLab 이슈, 병합 요청 및 Git에서 작업하는 동안 Jira 이슈를 상호 참조할 수 있습니다. GitLab 이슈, 병합 요청, 댓글 또는 커밋에서 Jira 이슈를 언급하면:

  • GitLab은 Jira 이슈로의 링크를 GitLab에서의 언급으로 추가합니다.
  • GitLab은 Jira 이슈에 형식 지정된 주석을 추가하여 GitLab의 이슈, 병합 요청 또는 커밋으로 돌아가는 링크를 추가합니다.

예를 들어, 해당 커밋이 GIT-1 Jira 이슈를 참조할 때: 

git commit -m "GIT-1 this is a test commit"

GitLab은 해당 Jira 이슈에 다음을 추가합니다:

  • 웹 링크 섹션에 참조.

  • 다음 형식의 활동 섹션에 주석을 추가합니다: 

    USER mentioned this issue in RESOURCE_NAME of [PROJECT_NAME|COMMENTLINK]:
ENTITY_TITLE
    • USER: Jira 이슈를 언급한 사용자 이름 및 그들의 GitLab 사용자 프로필로의 링크.
    • RESOURCE_NAME: Jira 이슈가 언급된 리소스 유형(GitLab 커밋, 이슈 또는 병합 요청)입니다.
    • PROJECT_NAME: GitLab 프로젝트 이름.
    • COMMENTLINK: Jira 이슈가 언급된 위치로의 링크.
    • ENTITY_TITLE: GitLab 커밋(첫 번째 줄), 이슈 또는 병합 요청의 제목.

Jira당 GitLab 이슈, 병합 요청 또는 커밋 당 하나의 상호 참조만 나타납니다. 예를 들어 Jira 이슈를 참조하는 여러 GitLab 병합 요청의 여러 댓글은 Jira에서 해당 병합 요청으로의 단일 상호 참조만 작성합니다.

이슈에서 댓글 비활성화할 수 있습니다.

병합 요청시 연관된 Jira 이슈 필요

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

이 통합을 통해 Jira 이슈를 참조하지 않은 경우 병합 요청이 병합되지 않도록 할 수 있습니다. 이 기능을 활성화하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 병합 요청을 선택합니다.
  3. 병합 검사 섹션에서 Jira로부터 연관된 이슈를 필요로 함을 선택합니다.
  4. 저장을 선택합니다.

이 기능을 활성화한 후에 Jira 이슈를 참조하지 않는 병합 요청은 병합할 수 없습니다. 병합 요청에는 다음 메시지가 표시됩니다 병합하려면 제목이나 설명에 Jira 이슈 키가 언급되어야 합니다.

GitLab에서 Jira 이슈 일치를 사용자 정의

  • 소개된 기능: GitLab 15.10.

당신은 GitLab이 Jira 이슈 키를 일치시키는 사용자 정의 규칙을 구성할 수 있습니다:

사용자 정의 규칙을 구성하지 않으면 기본 동작이 사용됩니다.

정규식 패턴 정의

정규식(Regex)을 사용하여 Jira 이슈 키를 일치시킬 수 있습니다. 정규식 패턴은 RE2 구문을 따라야 합니다.

Jira 이슈 키에 대한 정규식 패턴을 정의하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. Jira를 선택합니다.
  4. Jira 이슈 일치 섹션으로 이동합니다.
  5. Jira 이슈 정규식 텍스트 상자에 정규식 패턴을 입력합니다.
  6. 변경사항 저장을 선택합니다.

추가 정보는 아틀라시안 설명서를 참조하세요.

접두사 정의

접두사를 사용하여 Jira 이슈 키를 일치시킬 수 있습니다. 예를 들어, Jira 이슈 키가 ALPHA-1이고 JIRA# 접두사를 정의하는 경우, GitLab은 JIRA#ALPHA-1而 ALPHA-1을 일치시킵니다.

Jira 이슈 키에 대한 접두사를 정의하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. Jira를 선택합니다.
  4. Jira 이슈 일치 섹션으로 이동합니다.
  5. Jira 이슈 접두사 텍스트 상자에 접두사를 입력합니다.
  6. 변경사항 저장을 선택합니다.

GitLab에서 Jira 이슈 닫기

만약 GitLab 전이 ID를 구성했다면, GitLab에서 Jira 이슈를 직접 닫을 수 있습니다. 커밋이나 병합 요청에 포함된 트리거 단어와 Jira 이슈 ID를 사용하세요.

커밋에 트리거 단어와 Jira 이슈 ID가 포함되어 있을 때, GitLab은 다음을 수행합니다:

  1. 언급된 Jira 이슈에 주석을 추가합니다.
  2. Jira 이슈를 닫습니다. Jira 이슈에 해결 방법이 있다면, 전환되지 않습니다.

예를 들어, PROJECT-1 Jira 이슈를 닫으려면 다음 중 하나의 트리거 단어를 사용하세요:

  • Resolves PROJECT-1
  • Closes PROJECT-1
  • Fixes PROJECT-1

커밋이나 병합 요청은 프로젝트의 기본 브랜치를 대상으로 해야 합니다. 프로젝트의 기본 브랜치를 프로젝트 설정에서 변경할 수 있습니다.

브랜치 이름이 Jira 이슈 ID와 일치하면, Closes <JIRA-ID>가 기존의 병합 요청 템플릿에 자동으로 추가됩니다. 이슈를 닫고 싶지 않다면, 자동 이슈 닫기 비활성화를 선택하세요.

이슈 닫기 사용 사례

다음 예시를 고려해보세요:

  1. 사용자가 새로운 기능을 요청하는 Jira 이슈 PROJECT-7를 생성합니다.
  2. GitLab에서 요청된 기능을 구축하기 위해 병합 요청을 생성합니다.
  3. 병합 요청에 이슈 닫기 트리거 Closes PROJECT-7를 추가합니다.
  4. 병합 요청이 병합되면:
    • GitLab은 이를 해결한 커밋에 연결된 Jira 이슈를 닫습니다.
    • GitLab은 Jira에 포맷에 맞춘 주석을 추가하고, 이슈를 해결한 커밋에 이르는 링크를 제공합니다. 주석 비활성화를 선택할 수 있습니다.

자동 이슈 전환

자동 이슈 전환을 구성하면, 참조된 Jira 이슈를 완료 카테고리의 다음 가능한 상태로 전환할 수 있습니다. 이 설정을 구성하려면 다음을 수행하세요:

  1. GitLab 구성 지침을 참조합니다.
  2. Jira 전환 활성화 확인란을 선택합니다.
  3. 완료로 이동 옵션을 선택합니다.

사용자 정의 이슈 전환

고급 워크플로우를 위해 사용자 지정 Jira 전이 ID를 지정할 수 있습니다:

  1. Jira 가입 상태에 따라 해당하는 방법을 사용하세요:
    • (Jira Cloud 사용자의 경우) 텍스트 뷰에서 워크플로를 편집하여 전이 ID를 얻습니다. 전이 ID는 전이 열에 표시됩니다.
    • (Jira Server 사용자의 경우) 다음 중 하나의 방법으로 전이 ID를 얻을 수 있습니다:
      • 적절한 “오픈” 상태에 있는 이슈를 사용하여 https://yourcompany.atlassian.net/rest/api/2/issue/ISSUE-123/transitions와 같이 요청을 통해 API를 사용합니다.
      • 원하는 전이를 가리키는 링크 위에 마우스를 올려 URL의 action 매개변수를 찾습니다. 상태가 동일하더라도 전이 ID는 워크플로에 따라 다를 수 있습니다 (예: 이야기 대신 버그).
  2. GitLab 구성 지침을 참조합니다.
  3. Jira 전환 활성화 설정을 선택합니다.
  4. 사용자 정의 전환 옵션을 선택합니다.
  5. 텍스트 필드에 전이 ID를 입력합니다. 여러 전이 ID를 삽입하면 (, 또는 ;로 구분), 지정한 순서대로 각 상태로 이슈가 이동합니다. 전이가 실패하면 순서가 중단됩니다.

Jira 이슈에 대한 주석 비활성화

GitLab은 Jira 이슈에 주석을 추가하지 않고 소스 커밋이나 병합 요청을 Jira 이슈와 연결할 수 있습니다:

  1. GitLab 구성 지침을 참조합니다.
  2. 주석 활성화 확인란을 해제합니다.