Jira 이슈 통합

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

Jira 이슈 통합은 하나 이상의 GitLab 프로젝트를 Jira 인스턴스에 연결합니다.
Jira 인스턴스를 직접 호스팅하거나 Jira Cloud에서 호스팅할 수 있습니다.
지원되는 Jira 버전은 6.x, 7.x, 8.x 및 9.x입니다.

통합 구성

  • Jira 개인 액세스 토큰을 사용한 인증은 GitLab 16.0에서 도입됨.
  • Jira 이슈 및 취약점에 대한 Jira 이슈 섹션은 GitLab 16.10에서 도입됨
    (플래그 이름: jira_multiple_project_keys). 기본적으로 비활성화됨.
  • Jira 이슈 및 취약점에 대한 Jira 이슈 섹션은 GitLab 17.0에서 일반적으로 사용 가능.
    기능 플래그 jira_multiple_project_keys가 제거됨.
  • Jira 이슈 활성화 체크 박스는 GitLab 17.0에서 이름 변경됨
    Jira 이슈 보기로.
  • 취약점에 대한 Jira 이슈 생성 활성화 체크 박스는 GitLab 17.0에서 이름 변경됨
    취약점에 대한 Jira 이슈 생성으로.
  • Jira 이슈 맞춤 설정 설정은 GitLab 17.5에서 도입됨.

사전 요구 사항:

GitLab에서 프로젝트 설정을 구성하여 Jira 이슈 통합을 활성화할 수 있습니다.
특정 그룹
또는 전체 인스턴스
에 대한 통합을 구성할 수도 있습니다.

이 통합을 통해 GitLab 프로젝트는 인스턴스의 모든 Jira 프로젝트와 상호작용할 수 있습니다.
GitLab에서 프로젝트 설정을 구성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. Jira를 선택합니다.
  4. 통합 활성화에서 활성 체크 박스를 선택합니다.
  5. 연결 세부 정보를 제공합니다:
    • 웹 URL: 이 GitLab 프로젝트에 연결할 Jira 인스턴스 웹 인터페이스의 기본 URL
      (예: https://jira.example.com).
    • Jira API URL: Jira 인스턴스 API의 기본 URL(예: https://jira-api.example.com).
      이 URL이 설정되지 않으면 기본적으로 웹 URL 값이 사용됩니다.
      Jira Cloud의 경우 Jira API URL은 비워두십시오.
    • 인증 방법:
      • 기본:
        • 이메일 또는 사용자 이름:
          • Jira Cloud의 경우 이메일을 입력하십시오.
          • Jira Data Center 또는 Jira Server의 경우 사용자 이름을 입력하십시오.
        • API 토큰 또는 비밀번호:
          • Jira Cloud의 경우 API 토큰을 입력하십시오.
          • Jira Data Center 또는 Jira Server의 경우 비밀번호를 입력하십시오.
      • Jira 개인 액세스 토큰(Jira Data Center 및 Jira Server에서만 사용 가능):
        개인 액세스 토큰을 입력하십시오.
  6. 트리거 설정을 제공합니다:
    • 커밋, 병합 요청 또는 둘 다를 트리거로 선택합니다.
      GitLab에서 Jira 이슈 ID를 언급하면 GitLab은 해당 이슈에 링크를 생성합니다.
    • GitLab에 다시 연결되는 Jira 이슈에 주석을 추가하려면,
      주석 활성화 체크 박스를 선택합니다.
    • GitLab에서 Jira 이슈를 자동으로 전환하려면,
      Jira 전환 활성화 체크 박스를 선택합니다.
  7. Jira 이슈 일치 섹션에서:
  8. 선택 사항입니다. GitLab에서 Jira 이슈 보기 활성화:
    Jira 이슈 섹션에서:

    1. Jira 이슈 보기 체크 박스를 선택합니다.

      경고:
      이 설정을 활성화하면 GitLab 프로젝트에 액세스할 수 있는 모든 사용자가
      지정한 Jira 프로젝트의 모든 이슈를 볼 수 있습니다.

    2. 하나 이상의 Jira 프로젝트 키를 입력합니다.
      모든 사용 가능한 키를 포함하려면 비워두십시오.

  9. 선택 사항입니다. 취약점에 대한 Jira 이슈 생성 활성화:
    취약점에 대한 Jira 이슈 섹션에서:

    1. 취약점에 대한 Jira 이슈 생성 체크 박스를 선택합니다.

      참고:
      이 설정은 개별 프로젝트와 그룹에 대해서만 활성화할 수 있습니다.

    2. Jira 프로젝트 키를 입력합니다.
    3. 이 프로젝트 키에 대한 이슈 유형 가져오기( )를 선택하고,
      생성할 Jira 이슈 유형을 선택합니다.
    4. 선택 사항입니다. Jira 이슈 맞춤 설정 체크 박스를 선택하여
      취약점에 대해 생성된 Jira 이슈의 세부 정보를 검토, 수정 또는 추가할 수 있습니다.
  10. 선택 사항입니다. 설정 테스트를 선택합니다.
  11. 변경 사항 저장을 선택합니다.

Jira 이슈 보기

Tier: Premium, Ultimate
  • GitLab 16.9에서 그룹에 대해 Jira 이슈를 활성화합니다.
  • GitLab 16.10에서 여러 Jira 프로젝트의 이슈를 보기합니다. jira_multiple_project_keys라는 플래그가 필요합니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 17.0에서 여러 Jira 프로젝트의 이슈를 일반적으로 사용 가능합니다. 기능 플래그 jira_multiple_project_keys가 제거되었습니다.

사전 요구 사항:

  • Jira 이슈 통합이 구성되어 있고
    Jira 이슈 보기 확인란이 선택되어 있는지 확인하세요.

특정 그룹이나 프로젝트에 대해 Jira 이슈를 활성화할 수 있지만, GitLab 프로젝트에서만 이슈를 볼 수 있습니다.

하나 이상의 Jira 프로젝트의 이슈를 GitLab 프로젝트에서 보려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 계획 > Jira 이슈를 선택합니다.

기본적으로 이슈는 생성일로 정렬됩니다.
가장 최근에 생성된 이슈가 가장 위에 표시됩니다.
이슈를 필터링하고 특정 이슈를 선택하여 GitLab에서 해당 이슈를 볼 수 있습니다.

이슈는 다음과 같은 탭으로 그룹화됩니다.
Jira 상태에 기반하여:

  • 열림: 완료가 아닌 모든 Jira 상태의 이슈.
  • 닫힘: 완료 Jira 상태의 이슈.
  • 모두: 모든 Jira 상태의 이슈.

Jira 이슈 필터링

Tier: Premium, Ultimate
  • GitLab 16.10에서 프로젝트별로 Jira 이슈를 필터링합니다. jira_multiple_project_keys라는 플래그가 필요합니다. 기본적으로 비활성화되어 있습니다.
  • GitLab 17.0에서 프로젝트별로 Jira 이슈를 일반적으로 사용 가능합니다. 기능 플래그 jira_multiple_project_keys가 제거되었습니다.

사전 요구 사항:

  • Jira 이슈 통합이 구성되어 있고
    Jira 이슈 보기 확인란이 선택되어 있는지 확인하세요.

GitLab에서 Jira 이슈를 보기할 때,
요약 및 설명의 텍스트로 이슈를 필터링할 수 있습니다.
다음 기준으로 이슈를 필터링할 수도 있습니다:

  • 라벨: URL의 labels[] 매개변수에 하나 이상의 Jira 이슈 라벨을 지정합니다.
    여러 라벨을 지정하면, 지정한 모든 라벨을 가진 이슈만 나타납니다
    (예: /-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA).
  • 상태: URL의 status 매개변수에 Jira 이슈 상태를 지정합니다
    (예: /-/integrations/jira/issues?status=In Progress).
  • 보고자: URL의 author_username 매개변수에 Jira 표시 이름을 지정합니다
    (예: /-/integrations/jira/issues?author_username=John Smith).
  • 담당자: URL의 assignee_username 매개변수에 Jira 표시 이름을 지정합니다
    (예: /-/integrations/jira/issues?assignee_username=John Smith).
  • 프로젝트: URL의 project 매개변수에 Jira 프로젝트 키를 지정합니다
    (예: /-/integrations/jira/issues?project=GTL).

취약점에 대한 Jira 이슈 생성하기

Tier: Ultimate

전제 조건:

  • Jira 이슈 통합이 구성되어 있고 취약점에 대한 Jira 이슈 생성 체크박스가 선택되어 있어야 합니다.
  • 대상 프로젝트에서 이슈를 생성할 수 있는 권한이 있는 Jira 사용자 계정이 필요합니다.

GitLab에서 취약점을 해결하거나 완화하기 위한 조치를 추적하기 위해 Jira 이슈를 생성할 수 있습니다.
취약점에 대한 Jira 이슈를 생성하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 안전성 > 취약점 보고서를 선택합니다.

  3. 취약점 설명을 선택합니다.

  4. Jira 이슈 생성을 선택합니다.

    Jira 이슈 사용자화 설정이 선택된 경우, 취약점 데이터로 미리 채워진 Jira 인스턴스의 이슈 생성 양식으로 리디렉션됩니다. Jira 이슈를 생성하기 전에 세부 정보를 검토, 수정 또는 추가할 수 있습니다.

이슈는 취약점 보고서의 정보와 함께 대상 Jira 프로젝트에 생성됩니다.

GitLab 이슈를 생성하려면 취약점에 대한 GitLab 이슈 생성하기를 참조하세요.

Jira Cloud API 토큰 생성하기

Jira Cloud에 대한 Jira 이슈 통합을 구성하려면 Jira Cloud API 토큰이 필요합니다.
Jira Cloud API 토큰을 생성하려면:

  1. Atlassian에 Jira 프로젝트에 대한 쓰기 접근 권한이 있는 계정으로 로그인합니다.

    링크를 클릭하면 API tokens 페이지가 열립니다. 또는 Atlassian 프로필에서 계정 설정 > 보안 > API 토큰 생성 및 관리를 선택합니다.

  2. API 토큰 생성을 선택합니다.

  3. 대화 상자에 토큰에 대한 레이블을 입력하고 생성을 선택합니다.

API 토큰을 복사하려면 복사를 선택합니다.

Jira Server에서 Jira Cloud로 마이그레이션하기

GitLab에서 Jira Server에서 Jira Cloud로 마이그레이션하고 Jira 통합을 유지하려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.

  2. 설정 > 통합을 선택합니다.

  3. Jira를 선택합니다.

  4. 웹 URL에 새 Jira 사이트 URL을 입력합니다(예: https://myjirasite.atlassian.net).

  5. 이메일 또는 사용자 이름에 Jira 프로필에 등록된 이메일을 입력합니다.

  6. Jira Cloud API 토큰 생성하기하고 토큰 값을 복사합니다.

  7. API 토큰 또는 비밀번호에 API 토큰 값을 붙여넣습니다.

  8. 선택 사항. 설정 테스트를 선택합니다.

  9. 변경 사항 저장을 선택합니다.

GitLab에서 기존 Jira 이슈 참조를 새 Jira 사이트 URL로 업데이트하려면 Markdown 캐시 무효화를 해야 합니다.