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 커넥터를 사용하십시오.

Jira에 동기화된 GitLab 데이터

그룹을 연결한 후에는 다음과 같은 GitLab 데이터가 Jira에 모든 해당 그룹의 프로젝트에 대해 동기화됩니다. 이는 Jira 이슈 ID를 언급할 때 적용됩니다:

  • 그룹을 연결하기 전에 있는 프로젝트 데이터:
    • 마지막 400개의 머지 리퀘스트
    • 마지막 400개의 브랜치 및 해당 브랜치의 마지막 커밋 (GitLab 15.11 이후)
  • 그룹을 연결한 후에 생성된 프로젝트 데이터:
    • 머지 리퀘스트
    • 브랜치
    • 커밋
    • 빌드
    • 배포
    • 피처 플래그

GitLab for Jira Cloud 앱 설치

Tier: Free, Premium, Ultimate Offering: GitLab.com

전제 조건:

  • 네트워크에서 GitLab과 Jira 사이의 들어오고 나가는 연결을 허용해야 합니다.
  • 특정한 Jira 사용자 요구 사항을 충족해아 합니다.

GitLab for Jira Cloud 앱을 설치하려면:

  1. Jira에서 상단 표시줄에서 Apps > 더 많은 앱 탐색을 선택하고 GitLab for Jira Cloud를 검색하십시오.
  2. GitLab for Jira Cloud를 선택한 다음 지금 받기를 선택하십시오.

또는, Atlassian Marketplace에서 앱을 직접 가져올 수 있습니다.

이제 GitLab for Jira Cloud 앱을 구성할 수 있습니다.

개요는 Atlassian Marketplace에서 GitLab for Jira Cloud 앱 구성을 참조하십시오.

GitLab for Jira Cloud 앱 구성

Tier: Free, Premium, Ultimate Offering: GitLab.com
  • 네임스페이스 추가가 이름이 변경됨을 가지고 있는 것은 GitLab 16.1에서 그룹 연결로 변경되었습니다.

전제 조건:

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

  1. Jira에서 상단 표시줄에서 Apps > 앱 관리를 선택합니다.
  2. GitLab for Jira (gitlab.com)을 확장합니다.
  3. 시작하기를 선택합니다.
  4. 선택 사항. Jira에서 사용할 GitLab 인스턴스를 설정하려면 GitLab 버전 변경을 선택합니다.
  5. GitLab에 로그인을 선택합니다.
  6. 연결할 수 있는 그룹 목록을 보려면 그룹 연결을 선택합니다.
  7. 그룹에 연결하려면 연결을 선택합니다.

GitLab 그룹에 연결한 후에는 해당 그룹의 모든 프로젝트에 대해 Jira로 데이터가 동기화됩니다. 초기 데이터 동기화는 분당 20개의 프로젝트로 일어납니다. 많은 프로젝트를 가진 그룹의 경우, 일부 프로젝트의 데이터 동기화가 지연됩니다.

GitLab for Jira Cloud 앱 업데이트

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

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

보안 고려 사항

GitLab for Jira Cloud 앱은 GitLab과 Jira를 연결합니다. 데이터는 두 애플리케이션 간에 공유되어야 하며 양방향으로 액세스가 허용되어야 합니다.

액세스 토큰을 통한 Jira 액세스

Jira는 GitLab과의 데이터 푸시를 인증하고 승인하기 위해 액세스 토큰을 공유합니다. 앱 설치 프로세스의 일환으로, Jira는 액세스 토큰을 포함한 핸드쉐이크 요청을 GitLab로 보냅니다. 이 핸드쉐이크는 비대칭 JWT로 서명되며, 액세스 토큰은 GitLab에 AES256-GCM으로 암호화되어 저장됩니다.

문제 해결

GitLab for Jira Cloud 앱을 사용하다가 다음과 같은 문제가 발생할 수 있습니다.

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

앱 연결 시 오류

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

Failed to link group. Please try again.

사용자 정보가 충분한 권한 때문에 Jira에서 검색되지 않아 403 Forbidden가 반환됩니다.

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