Jira 이슈 관리

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

GitLab에서 Jira 이슈를 직접 관리할 수 있습니다. configure.md에서 Jira 이슈를 관리할 수 있습니다. 그런 다음 GitLab 커밋 및 Merge Request에서 Jira 이슈를 ID로 참조할 수 있습니다. Jira 이슈 ID는 대문자여야 합니다.

GitLab 활동 및 Jira 이슈 상호 참조

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

  • GitLab은 Jira 이슈에 링크를 추가합니다.
  • GitLab은 Jira 이슈에 서식이 있는 코멘트를 추가하여 GitLab의 이슈, Merge Request 또는 커밋으로 연결됩니다.

예를 들어, 이 커밋이 GIT-1 Jira 이슈를 참조하는 경우: 

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

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

  • 웹 링크 섹션의 참조.

  • 다음 형식을 따르는 활동 섹션의 코멘트: 

    사용자가 PROJECT_NAME의 RESOURCE_NAME에 대해 이 문제를 언급했습니다. [PROJECT_NAME|COMMENTLINK]:
ENTITY_TITLE
    • USER: Jira 이슈를 언급한 사용자의 이름과 링크.
    • RESOURCE_NAME: Jira 이슈를 참조하는 리소스 유형(예: GitLab 커밋, 이슈 또는 Merge Request).
    • PROJECT_NAME: GitLab 프로젝트 이름.
    • COMMENTLINK: Jira 이슈가 언급된 위치로의 링크.
    • ENTITY_TITLE: GitLab 커밋(첫 번째 줄), 이슈 또는 Merge Request의 제목.

Jira에서 GitLab 이슈, Merge Request 또는 커밋당 단일 상호 참조만 나타납니다. 예를 들어 Jira 이슈를 참조하는 여러 개의 GitLab Merge Request의 코멘트는 Jira의 해당 Merge Request으로의 단일 상호 참조만 작성합니다.

이슈에 대한 코멘트를 비활성화할 수 있습니다. (Jira 이슈의 코멘트 비활성화)

Merge Request을 위한 연관 Jira 이슈 필요 사항

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

이 통합을 통해 Jira 이슈를 참조하지 않는 경우에는 Merge Request을 Merge하지 못하도록 할 수 있습니다. 이 기능을 활성화하려면:

  1. 측면 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > Merge Request을 선택합니다.
  3. Merge 확인 섹션에서 Jira와 관련된 이슈 필요을 선택합니다.
  4. 저장을 선택합니다.

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

GitLab에서 Jira 이슈 매칭 사용자 지정

GitLab에서 Jira 이슈 키의 일치 방법을 사용자 정의하는 사용자 정의 규칙을 구성할 수 있습니다:

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

정규 표현식 패턴 정의

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

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

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

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

접두어 정의

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

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

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

GitLab에서 Jira 이슈 닫기

GitLab 전환 ID를 구성한 경우 GitLab에서 Jira 이슈를 직접 닫을 수 있습니다. 커밋이나 Merge Request에 트리거 단어와 Jira 이슈 ID를 사용하여 커밋을 푸시하면 GitLab이:

  1. 언급된 Jira 이슈에 코멘트를 추가합니다.
  2. 해당 Jira 이슈를 닫습니다. Jira 이슈에 해상도가 있다면 전환되지 않습니다.

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

  • 해결 PROJECT-1
  • 닫기 PROJECT-1
  • 수정 PROJECT-1

커밋 또는 Merge Request은 프로젝트의 기본 브랜치를 대상으로해야 합니다. 이슈를 닫고 싶지 않은 경우 자동 이슈 닫기 비활성화 설정을 해제할 수 있습니다.

이슈 닫는 사용 사례

다음 예를 고려해보세요:

  1. 사용자가 Jira 이슈 PROJECT-7를 만들어 새로운 기능을 요청합니다.
  2. GitLab에서 요청된 기능을 빌드하기 위해 Merge Request을 생성합니다.
  3. Merge Request에 이슈 닫기 트리거 PROJECT-7을 추가합니다.
  4. Merge Request이 Merge되면:
    • GitLab은 사용자를 대신하여 Jira 이슈를 닫습니다.
    • GitLab은 코멘트를 추가하여 Jira에 리소스로 연결된 커밋으로 링크됩니다. 코멘트 비활성화가능합니다.

자동 이슈 전환

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

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

사용자 정의 이슈 전환

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

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

—ADD—

Translations of #disable-comments-on-jira-issues and #disable-automatic-issue-closing

Jira 이슈의 코멘트 비활성화

:: Tabs ### 자동 이슈 닫기 비활성화 :: EndTabs

Jira 이슈에서 댓글 비활성화

GitLab은 Jira 이슈에 댓글을 추가하지 않고도 소스 커밋 또는 Merge Request을 Jira 이슈와 상호 연결할 수 있습니다.

  1. GitLab 구성 지침을 참조하세요.
  2. 댓글 활성화 확인란을 선택 해제하세요.