GitLab에서 직접 Jira 이슈를 관리할 수 있습니다. 그런 다음 GitLab 커밋 및 머지 리퀘스트에서 ID로 Jira 이슈를 참조할 수 있습니다. Jira 이슈 ID는 대문자여야 합니다.

GitLab 활동과 Jira 이슈 상호 참조#

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

• GitLab은 GitLab의 언급에서 Jira 이슈로 연결합니다.
• GitLab은 Jira 이슈로 다시 연결되는 서식이 지정된 댓글을 Jira 이슈에 추가합니다.

예를 들어 이 커밋이 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: GitLab 사용자 프로필 링크가 있는 Jira 이슈를 언급한 사용자의 이름.
  • RESOURCE_NAME: Jira 이슈를 참조한 리소스 유형(예: GitLab 커밋, 이슈 또는 머지 리퀘스트).
  • PROJECT_NAME: GitLab 프로젝트 이름.
  • COMMENTLINK: Jira 이슈가 언급된 위치의 링크.
  • ENTITY_TITLE: GitLab 커밋의 제목(첫 번째 줄), 이슈 또는 머지 리퀘스트.

GitLab 이슈, 머지 리퀘스트 또는 커밋당 Jira에 단일 상호 참조만 표시됩니다. 예를 들어 Jira 이슈를 참조하는 GitLab 머지 리퀘스트의 여러 댓글은 Jira의 해당 머지 리퀘스트에 대한 단일 상호 참조만 생성합니다.

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

머지 리퀘스트 병합 시 연결된 Jira 이슈 요구#

이 통합을 사용하면 Jira 이슈를 참조하지 않는 머지 리퀘스트의 병합을 방지할 수 있습니다. 이 기능을 활성화하려면:

1. 상단 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 설정 > 머지 리퀘스트를 선택합니다.
3. 머지 확인 섹션에서 Jira의 연결된 이슈 필요를 선택합니다.
4. 저장을 선택합니다.

이 기능을 활성화하면 연결된 Jira 이슈를 참조하지 않는 머지 리퀘스트를 병합할 수 없습니다. 머지 리퀘스트에는 병합하려면 Jira 이슈 키가 제목이나 설명에 언급되어야 합니다라는 메시지가 표시됩니다.

GitLab에서 Jira 이슈 매칭 커스터마이즈#

다음을 정의하여 GitLab이 Jira 이슈 키를 매칭하는 방법에 대한 커스텀 규칙을 구성할 수 있습니다:

• 정규식 패턴
• 접두사

커스텀 규칙을 구성하지 않으면 기본 동작이 사용됩니다.

정규식 패턴 정의#

정규식(regex)을 사용하여 Jira 이슈 키를 매칭할 수 있습니다. 정규식 패턴은 RE2 구문을 따라야 합니다.

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

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

자세한 내용은 Atlassian 문서를 참조하세요.

접두사 정의#

접두사를 사용하여 Jira 이슈 키를 매칭할 수 있습니다. 예를 들어 Jira 이슈 키가 ALPHA-1이고 JIRA# 접두사를 정의하면 GitLab은 ALPHA-1 대신 JIRA#ALPHA-1을 매칭합니다.

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

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

GitLab에서 Jira 이슈 닫기#

GitLab 전환 ID를 구성한 경우 GitLab에서 직접 Jira 이슈를 닫을 수 있습니다. 커밋이나 머지 리퀘스트에서 트리거 단어 뒤에 Jira 이슈 ID를 사용합니다. 트리거 단어와 Jira 이슈 ID가 포함된 커밋을 푸시하면 GitLab은:

1. 언급된 Jira 이슈에 댓글을 추가합니다.
2. Jira 이슈를 닫습니다. Jira 이슈에 해결이 있는 경우 전환되지 않습니다.

예를 들어 다음 트리거 단어를 사용하여 Jira 이슈 PROJECT-1을 닫습니다:

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

커밋이나 머지 리퀘스트는 프로젝트의 기본 브랜치를 대상으로 해야 합니다. 프로젝트 설정에서 프로젝트의 기본 브랜치를 변경할 수 있습니다.

브랜치 이름이 Jira 이슈 ID와 일치하는 경우 기존 머지 리퀘스트 템플릿에 Closes 가 자동으로 추가됩니다. 이슈를 닫지 않으려면 자동 이슈 닫기를 비활성화합니다.

이슈 닫기 사용 사례#

이 예를 고려하세요:

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. 댓글 활성화 확인란을 해제합니다.