GitLab for Jira Cloud 애플리케이션

Tier: Free, Premium, Ultimate

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

note
이 페이지에는 GitLab for Jira Cloud 애플리케이션에 대한 사용자 문서가 포함되어 있습니다. 관리 문서는 GitLab for Jira Cloud 애플리케이션 관리를 참조하세요.

GitLab for Jira Cloud 애플리케이션을 사용하면 GitLab과 Jira Cloud를 연결하여 개발 정보를 실시간으로 동기화할 수 있습니다. 이 정보를 Jira 개발 패널에서 볼 수 있습니다.

GitLab for Jira Cloud 애플리케이션을 사용하여 최상위 그룹 또는 하위 그룹을 연결할 수 있습니다. 프로젝트나 개인 네임스페이스를 직접 연결하는 것은 불가능합니다.

GitLab.com에서 GitLab for Jira Cloud 애플리케이션을 설정하려면 GitLab for Jira Cloud 애플리케이션 설치를 참조하세요.

앱을 설정한 후에는 Atlassian에서 개발 및 유지 관리하는 프로젝트 툴체인을 사용하여 GitLab 리포지토리를 Jira 프로젝트와 연결할 수 있습니다.

프로젝트 툴체인은 GitLab과 Jira Cloud 간의 개발 정보 동기화 방식에 영향을 미치지 않습니다.

Jira Data Center 또는 Jira Server의 경우, Atlassian에서 개발 및 유지 관리하는 Jira DVCS 커넥터를 사용하세요.

GitLab 데이터가 Jira에 동기화됨

그룹을 연결한 후, Jira 이슈 ID를 언급하면 해당 그룹의 모든 프로젝트에 대해 다음 GitLab 데이터가 Jira에 동기화됩니다:

  • 기존 프로젝트 데이터 (그룹을 연결하기 전):
    • 마지막 400개의 머지 요청
    • 마지막 400개의 브랜치와 각 브랜치의 마지막 커밋 (GitLab 15.11 이상)
  • 새로운 프로젝트 데이터 (그룹을 연결한 후):
    • 머지 요청
      • 머지 요청 작성자
    • 브랜치
    • 커밋
      • 커밋 작성자
    • 파이프라인
    • 배포
    • 기능 플래그

GitLab for Jira Cloud 애플리케이션 설치

Tier: Free, Premium, Ultimate

Offering: GitLab.com

Prerequisites:

  • 귀하의 네트워크는 GitLab과 Jira 간의 인바운드 및 아웃바운드 연결을 허용해야 합니다.
  • 특정 Jira 사용자 요건을 충족해야 합니다.

GitLab for Jira Cloud 애플리케이션을 설치하려면:

  1. Jira에서 상단 막대에서 Apps > Explore more apps를 선택하고 GitLab for Jira Cloud를 검색합니다.

  2. GitLab for Jira Cloud를 선택한 후 Get it now를 선택합니다.

또는 Atlassian Marketplace에서 직접 앱을 가져옵니다.

이제 GitLab for Jira Cloud 애플리케이션 구성을 할 수 있습니다.

개요는 Atlassian Marketplace에서 GitLab for Jira Cloud 애플리케이션 구성하기를 참조하세요.

Jira Cloud용 GitLab 구성 앱

Tier: Free, Premium, Ultimate

Offering: GitLab.com

  • 네임스페이스 추가 개명됨 링크 그룹을 GitLab 16.1에 추가했습니다.

사전 요구 사항:

  • GitLab 그룹에 대해 최소한 Maintainer 역할이 있어야 합니다.
  • 특정 Jira 사용자 요구 사항을 충족해야 합니다.

GitLab for Jira Cloud 앱을 하나 이상의 GitLab 그룹에 연결하여 GitLab에서 Jira로 데이터를 동기화할 수 있습니다.

GitLab for Jira Cloud 앱을 구성하려면:

  1. Jira에서 상단 바에서 앱 > 내 앱 관리를 선택합니다.
  2. GitLab for Jira를 확장합니다. 앱을 설치한 방법에 따라 앱의 이름은 다음과 같습니다:
  3. 시작하기를 선택합니다.
  4. 선택 사항. self-managed GitLab 인스턴스를 Jira와 연결하려면 GitLab 버전 변경을 선택합니다.
    1. 모든 체크박스를 선택한 후 다음을 선택합니다.
    2. GitLab 인스턴스 URL을 입력한 후 저장을 선택합니다.

  5. GitLab에 로그인을 선택합니다.

    참고:

    Enterprise 사용자는 그룹에 대한 비밀번호 인증이 비활성화된 경우

    먼저 그룹의 SSO(Single Sign-On) URL로 GitLab에 로그인을 해야 합니다.

  6. 허가하기를 선택합니다. 이제 그룹 목록이 표시됩니다.
  7. 링크 그룹을 선택합니다.
  8. 그룹에 링크하려면 링크를 선택합니다.

GitLab 그룹에 링크한 후:

  • 해당 그룹의 모든 프로젝트에 대해 데이터가 Jira로 동기화됩니다. 초기 데이터 동기화는 분당 20개 프로젝트 배치로 진행됩니다. 프로젝트가 많은 그룹의 경우 일부 프로젝트에 대한 데이터 동기화는 지연됩니다.
  • GitLab for Jira Cloud 앱 통합이 그룹 및 해당 그룹의 모든 하위 그룹 또는 프로젝트에 대해 자동으로 활성화됩니다. 이 통합을 통해 Jira 서비스 관리 구성을 할 수 있습니다.

Jira 서비스 관리 구성

사전 요구 사항:

GitLab을 IT 서비스 프로젝트에 연결하여 배포를 추적할 수 있습니다.

구성은 GitLab에서 GitLab for

Jira Cloud 앱 통합에서 이루어집니다. GitLab 그룹이 링크된 후 그룹과 해당 하위 그룹 및 GitLab의 프로젝트에 대해 통합이 활성화됩니다.

GitLab for Jira Cloud 앱 통합의 활성화 및 비활성화는 그룹 링크를 통해 완전히 자동으로 이루어지며,

GitLab 통합 양식 또는 API를 통해 이루어지지 않습니다.

Jira 서비스 관리에서:

  1. 서비스 프로젝트에서 프로젝트 설정 > 변경 관리로 이동합니다.
  2. 연결 파이프라인 > GitLab을 선택한 다음 설정 흐름의 끝에서 서비스 ID를 복사합니다.

GitLab에서:

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

  3. Jira Cloud 앱용 GitLab을 선택합니다. 통합이 비활성화된 경우, 먼저 GitLab 그룹을 링크

    하면 해당 그룹에 대한 GitLab for Jira Cloud 앱 통합이 활성화됩니다.

  4. 서비스 ID 필드에 이 프로젝트에 매핑할 서비스 ID를 입력합니다. 여러 서비스 ID를 사용하려면,

    각 서비스 ID 사이에 쉼표를 추가합니다.

최대 100개의 서비스를 매핑할 수 있습니다.

Jira에서 배포 추적에 대한 자세한 내용은 배포 추적 설정을 참조하세요.

GitLab for Jira Cloud 앱 업데이트

앱의 대부분 업데이트는 자동으로 이루어집니다. 자세한 내용은 Atlassian 문서를 참조하세요.

앱에 추가 권한이 필요한 경우, Jira에서 수동으로 업데이트를 승인해야 합니다.

보안 고려 사항

GitLab for Jira Cloud 앱은 GitLab과 Jira를 연결합니다. 데이터는 두 응용 프로그램 간에 공유되어야 하며, 양방향으로 접근이 허용되어야 합니다.

GitLab의 Jira 접근

GitLab for Jira Cloud 앱을 구성하면, GitLab은 Jira로부터 공유 비밀 토큰을 받습니다.

이 토큰은 GitLab에 Jira 프로젝트에 대한 READ, WRITE, 및 DELETE 앱 범위를 부여합니다.

이 범위는 Jira 프로젝트의 개발 패널에서 정보를 업데이트하는 데 필요합니다.

토큰은 앱이 설치된 Jira 프로젝트 외 다른 Atlassian 제품에 대한 GitLab 접근을 허용하지 않습니다.

토큰은 AES256-GCM으로 암호화되어 GitLab에 저장됩니다.

GitLab for Jira Cloud 앱이 Jira 프로젝트에서 제거되면, GitLab은 토큰을 삭제합니다.

Jira의 GitLab 접근

Jira는 GitLab에 대한 접근 권한을 얻지 않습니다.

GitLab에서 Jira로 전송되는 데이터

Jira로 전송되는 모든 데이터에 대한 내용은 Jira에 동기화된 GitLab 데이터를 참조하세요.

Jira로 전송되는 특정 데이터 속성에 대한 자세한 내용은 데이터 동기화에 관련된 직렬화 클래스를 참조하세요.

Jira에서 GitLab로 전송되는 데이터

GitLab은 GitLab for Jira Cloud 앱이 설치되거나 제거될 때 Jira로부터 라이프사이클 이벤트를 받습니다.

이 이벤트는 후속 라이프사이클 이벤트를 확인하고 Jira로 데이터 전송 시 인증하기 위한 토큰을 포함합니다.

Jira로부터의 라이프사이클 이벤트 요청은 검증됩니다.

Atlassian Marketplace에서 GitLab for Jira Cloud 앱을 사용하는 자체 관리 인스턴스의 경우, GitLab.com이 라이프사이클 이벤트를 처리하고 이를 자체 관리 인스턴스로 전달합니다. 자세한 내용은 GitLab.com의 앱 라이프사이클 이벤트 처리를 참조하세요.

Atlassian Marketplace의 개인 정보 및 보안 세부 사항

자세한 내용은 Atlassian Marketplace 목록의 개인 정보 및 보안 세부 사항을 참조하세요.

문제 해결

GitLab for Jira Cloud 앱을 사용하면서 다음과 같은 문제에 직면할 수 있습니다.

관리자 문서는 GitLab for Jira Cloud 앱 관리를 참조하세요.

오류: 그룹 연결 실패

GitLab for Jira Cloud 앱을 연결할 때 이 오류가 발생할 수 있습니다:

그룹 연결 실패. 다시 시도하세요.

사용자 정보가 권한 부족으로 인해 Jira에서 가져올 수 없는 경우 403 Forbidden이 반환됩니다.

이 문제를 해결하려면 특정 Jira 사용자 요구 사항을 충족하는지 확인하세요.