Jira Cloud용 GitLab 앱을 사용하면 GitLab과 Jira Cloud를 연결하여 실시간으로 개발 정보를 동기화할 수 있습니다. 이 정보는 Jira 개발 패널에서 확인할 수 있습니다.

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

GitLab.com에서 Jira Cloud용 GitLab 앱을 설정하려면 Jira Cloud용 GitLab 앱을 설치합니다.

앱을 설정한 후 Atlassian이 개발 및 유지 관리하는 프로젝트 툴체인을 사용하여 GitLab 리포지터리를 Jira 프로젝트에 연결할 수 있습니다. 프로젝트 툴체인은 GitLab과 Jira Cloud 간의 개발 정보 동기화 방식에 영향을 미치지 않습니다.

Jira Data Center 또는 Jira Server의 경우 Atlassian이 개발 및 유지 관리하는 Jira DVCS 커넥터를 사용합니다.

Jira에 동기화되는 GitLab 데이터#

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

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

Jira Cloud용 GitLab 앱 설치#

사전 조건:

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

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

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

또는 Atlassian Marketplace에서 직접 앱을 받습니다.

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

개요는 GitLab.com의 Atlassian Marketplace에서 Jira Cloud용 GitLab 앱 설치를 참조하세요.

위의 비디오는 최신 Jira Cloud 인스턴스에서 사용할 수 없을 수 있는 이전 Universal Plugin Manager 인터페이스를 보여줍니다. 다음 지침은 이전 인터페이스와 새 앱 관리 인터페이스 모두를 다룹니다.

Jira Cloud용 GitLab 앱 구성#

히스토리

• 네임스페이스 추가가 GitLab 16.1에서 그룹 연결로 이름 변경.

사전 조건:

• GitLab 그룹의 Maintainer 또는 Owner 역할이 있어야 합니다.
• 특정 Jira 사용자 요구 사항을 충족해야 합니다.

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

1. Jira에서 앱 옆의 가로 줄임표([ellipsis_h])를 선택하고 앱 관리를 선택합니다.

2. 다음 방법 중 하나를 사용하여 앱으로 이동합니다:

   • 중앙화된 앱 관리가 있는 인스턴스의 경우:

     1. "앱 관리가 관리로 이동했습니다"가 표시되면 이동을 선택합니다. 그렇지 않으면 아래의 레거시 앱 관리가 있는 인스턴스 지침을 따릅니다.
     2. 설치된 앱 탭에서 Jira용 GitLab을 찾습니다. 앱을 설치한 방법에 따라 앱 이름은:
        • Atlassian Marketplace에서 앱을 설치한 경우 GitLab for Jira (gitlab.com).
        • 앱을 수동으로 설치한 경우 GitLab for Jira (<gitlab.example.com>).
     3. 가로 줄임표([ellipsis_h])를 선택한 다음 시작하기를 선택하여 통합을 구성합니다.

   • 레거시 앱 관리가 있는 인스턴스의 경우:

     1. Jira용 GitLab을 확장합니다. 앱을 설치한 방법에 따라 앱 이름은:
        • Atlassian Marketplace에서 앱을 설치한 경우 GitLab for Jira (gitlab.com).
        • 앱을 수동으로 설치한 경우 GitLab for Jira (<gitlab.example.com>).
     2. 시작하기를 선택하여 통합을 구성합니다.

3. 선택 사항. GitLab Self-Managed를 Jira와 연결하려면 GitLab 버전 변경을 선택합니다.

   1. 모든 체크박스를 선택한 다음 다음을 선택합니다.
   2. GitLab 인스턴스 URL을 입력한 다음 저장을 선택합니다.

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

   [!note] 그룹에 대해 비밀번호 인증이 비활성화된 엔터프라이즈 사용자는 먼저 그룹의 싱글 사인온 URL로 GitLab에 로그인해야 합니다.

   GitLab은 그룹을 연결하기 위해 로그인이 필요하지만, 구성을 특정 사용자에게 연결하지는 않습니다. GitLab 인스턴스는 Jira에서 정보를 업데이트하는 데 사용되는 토큰을 Jira로부터 받습니다. 자세한 내용은 Jira에 대한 GitLab 액세스를 참조하세요.

5. 권한 부여를 선택합니다. 이제 그룹 목록이 표시됩니다.

6. 그룹 연결을 선택합니다.

7. 그룹에 연결하려면 연결을 선택합니다.

GitLab 그룹에 연결한 후:

• 해당 그룹의 모든 프로젝트에 대한 데이터가 Jira에 동기화됩니다. 초기 데이터 동기화는 분당 20개 프로젝트 배치로 이루어집니다. 많은 프로젝트가 있는 그룹의 경우 일부 프로젝트의 데이터 동기화가 지연될 수 있습니다.
• Jira Cloud용 GitLab 앱 통합이 해당 그룹과 해당 그룹의 모든 서브그룹 또는 프로젝트에 대해 자동으로 활성화됩니다. 이 통합을 통해 Jira Service Management를 구성할 수 있습니다.

Jira Service Management 구성#

히스토리

• GitLab 17.2에서 enable_jira_connect_configuration이라는 플래그와 함께 도입. 기본적으로 비활성화.
• GitLab 17.4에서 일반 가용성. 기능 플래그 enable_jira_connect_configuration 제거.

사전 조건:

• Jira Cloud용 GitLab 앱이 설치되어 있어야 합니다.
• Jira Cloud용 GitLab 앱 구성에서 연결할 GitLab 그룹.

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

구성은 GitLab의 Jira Cloud용 GitLab 앱 통합에서 이루어집니다. GitLab 그룹이 연결된 후 통합이 GitLab의 그룹, 서브그룹 및 프로젝트에 대해 활성화됩니다.

Jira Cloud용 GitLab 앱 통합의 활성화 및 비활성화는 그룹 연결을 통해 자동으로 이루어지며, GitLab 통합 양식 또는 API를 통해 이루어지지 않습니다.

Jira Service Management에서:

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

GitLab에서:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 설정 > 통합을 선택합니다.
3. Jira Cloud용 GitLab 앱을 선택합니다. 통합이 비활성화된 경우 먼저 GitLab 그룹을 연결하여 해당 그룹, 서브그룹 및 프로젝트에 대해 Jira Cloud용 GitLab 앱 통합을 활성화합니다.
4. 서비스 ID 필드에 이 프로젝트에 매핑할 서비스 ID를 입력합니다. 여러 서비스 ID를 사용하려면 각 서비스 ID 사이에 쉼표를 추가합니다.

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

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

GitLab로 배포 게이팅 설정#

히스토리

• GitLab 17.6에서 도입.

배포 게이팅을 설정하여 GitLab에서 Jira Service Management로 변경 요청을 가져와 승인을 받을 수 있습니다. 배포 게이팅을 사용하면 선택한 환경에 대한 GitLab 배포가 자동으로 Jira Service Management에 전송되며 승인된 경우에만 배포됩니다.

서비스 계정 토큰 생성#

GitLab에서 서비스 계정 토큰을 생성하려면 먼저 개인 액세스 토큰을 생성해야 합니다. 이 토큰은 Jira Service Management에서 GitLab 배포를 관리하는 데 사용되는 서비스 계정 토큰을 인증합니다.

서비스 계정 토큰을 생성하려면:

1. 서비스 계정 사용자를 생성합니다.
2. 개인 액세스 토큰을 사용하여 그룹 또는 프로젝트에 서비스 계정을 추가합니다.
3. 보호된 환경에 서비스 계정을 추가합니다.
4. 개인 액세스 토큰을 사용하여 서비스 계정 토큰을 생성합니다.
5. 서비스 계정 토큰 값을 복사합니다.

배포 게이팅 활성화#

배포 게이팅을 활성화하려면:

• GitLab에서:

  1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. Jira Cloud용 GitLab 앱을 선택합니다.
  4. 배포 게이팅 아래에서 배포 게이팅 활성화 체크박스를 선택합니다.
  5. 환경 계층 텍스트 상자에 배포 게이팅을 활성화할 환경의 이름을 입력합니다. 쉼표로 구분하여 여러 환경 이름을 입력할 수 있습니다(예: production, staging, testing, development). 소문자만 사용합니다.
  6. 변경 사항 저장을 선택합니다.

• Jira Service Management에서:

  1. 배포 게이팅을 설정합니다.
  2. 서비스 계정 토큰 텍스트 상자에 GitLab에서 복사한 서비스 계정 토큰 값을 붙여넣습니다.

보호된 환경에 서비스 계정 추가#

GitLab에서 보호된 환경에 서비스 계정을 추가하려면:

1. 상단 표시줄에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
3. 보호된 환경을 확장하고 환경 보호를 선택합니다.
4. 환경 선택 드롭다운 목록에서 보호할 환경을 선택합니다(예: staging).
5. 배포 허용 드롭다운 목록에서 이 환경에 배포할 수 있는 사람을 선택합니다(예: Developers + Maintainers).
6. 승인자 드롭다운 목록에서 생성한 서비스 계정을 선택합니다.
7. 보호를 선택합니다.

API 요청 예시#

• 서비스 계정 사용자 생성:

  curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "name=<name_of_your_choice>&username=<username_of_your_choice>"  "<https://gitlab.com/api/v4/groups/<group_id>/service_accounts"
  

• 개인 액세스 토큰을 사용하여 그룹 또는 프로젝트에 서비스 계정 추가:

  curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
       --data "user_id=<service_account_id>&access_level=30" "https://gitlab.com/api/v4/groups/<group_id>/members"
  curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
       --data "user_id=<service_account_id>&access_level=30" "https://gitlab.com/api/v4/projects/<project_id>/members"
  

• 개인 액세스 토큰을 사용하여 서비스 계정 토큰 생성:

  curl --request POST --header "PRIVATE-TOKEN: <your_access_token>"
  "https://gitlab.com/api/v4/groups/<group_id>/service_accounts/<service_account_id>/personal_access_tokens" --data "scopes[]=api,read_user,read_repository" --data "name=service_accounts_token"
  

Jira Cloud용 GitLab 앱 업데이트#

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

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

Atlassian Connect에서 Forge로 마이그레이션#

히스토리

• GitLab 18.10에서 도입.

Jira Cloud용 GitLab 앱이 Atlassian Connect에서 Atlassian Forge로 마이그레이션되었습니다. 이 변경은 Atlassian의 Connect 앱에 대한 지원 종료 발표를 따릅니다.

다음을 포함하여 기존 모든 기능이 계속 작동합니다:

• Jira 개발 패널에 브랜치, 커밋, 머지 리퀘스트, 파이프라인, 배포, 기능 플래그 동기화.
• Jira 이슈에서 GitLab 브랜치 생성.
• 시간 추적 및 이슈 전환을 위한 Smart Commit 사용.
• GitLab.com 및 GitLab Self-Managed 인스턴스 지원.

Atlassian Marketplace에서 Jira Cloud용 GitLab 앱을 설치한 경우:

• Forge 버전이 기존 앱의 주요 업그레이드로 표시됩니다.
• Jira 관리자가 업그레이드를 승인해야 합니다.
• 이전에 동기화된 모든 개발 데이터가 자동으로 보존됩니다. Forge 앱은 동일한 앱 식별자를 사용하므로 데이터를 마이그레이션할 필요가 없습니다.
• GitLab 구성을 변경할 필요가 없습니다.

이전에 Connect 기반 App descriptor URL 방식으로 Jira Cloud용 GitLab 앱을 수동으로 설치한 경우, Forge 기반 방법을 사용하여 앱을 재설치해야 합니다. Atlassian이 2026년 3월 31일에 Connect 기반 비공개 설치를 중단하여 기존 방식이 더 이상 작동하지 않습니다. 재설치하려면 Forge 기반 수동 설치 지침을 따르세요. 이 방식은 자체 Atlassian 개발자 계정 하에 Jira Cloud용 GitLab Forge 앱의 비공개 복사본을 게시합니다.

Connect에서 Forge로의 전환에 대한 자세한 내용은 Forge 도입 방법에 대한 Atlassian 가이드를 참조하세요.

보안 고려 사항#

Jira Cloud용 GitLab 앱은 GitLab과 Jira를 연결합니다. 두 애플리케이션 간에 데이터를 공유하고 양방향으로 액세스 권한을 부여해야 합니다.

Jira에 대한 GitLab 액세스#

Jira Cloud용 GitLab 앱을 구성할 때 GitLab은 Jira로부터 공유 비밀 토큰을 받습니다. 이 토큰은 GitLab에 Jira 프로젝트에 대한 READ, WRITE, DELETE 앱 범위를 부여합니다. 이러한 범위는 Jira 프로젝트의 개발 패널에서 정보를 업데이트하는 데 필요합니다. 이 토큰은 앱이 설치된 Jira 프로젝트 외의 다른 Atlassian 제품에 대한 GitLab 액세스를 부여하지 않습니다.

토큰은 AES256-GCM으로 암호화되어 GitLab에 저장됩니다. Jira Cloud용 GitLab 앱이 Jira 프로젝트에서 제거되면 GitLab은 토큰을 삭제합니다.

GitLab에 대한 Jira 액세스#

Jira는 GitLab에 대한 액세스 권한을 얻지 않습니다.

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

Jira로 전송되는 모든 데이터는 Jira에 동기화되는 GitLab 데이터를 참조하세요.

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

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

Jira Cloud용 GitLab 앱이 설치되거나 제거될 때 GitLab은 Jira로부터 라이프사이클 이벤트를 받습니다. 이 이벤트에는 후속 라이프사이클 이벤트를 확인하고 Jira에 데이터를 전송할 때 인증하기 위한 토큰이 포함됩니다. Jira의 라이프사이클 이벤트 요청은 검증됩니다.

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

Jira에 저장된 데이터#

Jira로 전송된 데이터는 Jira에 저장되며 Jira 개발 패널에 표시됩니다.

Jira Cloud용 GitLab 앱이 제거되면 Jira는 이 데이터를 영구적으로 삭제합니다. 이 프로세스는 비동기적으로 실행되며 최대 몇 시간이 걸릴 수 있습니다.

Atlassian Marketplace의 개인 정보 보호 및 보안 세부 정보#

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

문제 해결#

Jira Cloud용 GitLab 앱으로 작업할 때 다음 문제가 발생할 수 있습니다.

관리자 문제 해결은 Jira Cloud용 GitLab 앱 관리를 참조하세요.

오류: Failed to link group#

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

Failed to link group. Please try again.

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

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

GitLab 그룹에 연결한 후 Jira Code가 작동하지 않음#

Jira Code가 Jira Cloud용 GitLab 앱을 GitLab 그룹에 연결한 후 작동하지 않을 수 있습니다. 이 문제를 해결하려면 Bitbucket과 Jira를 모두 구성해야 합니다.

Bitbucket에서:

1. Atlassian 계정에 로그인합니다.
2. 워크스페이스를 생성하고 이름을 입력합니다.

Jira에서:

1. 프로젝트에서 프로젝트를 선택합니다.
2. 개발 > 코드를 선택합니다.
3. Bitbucket 연결 > Bitbucket Cloud 워크스페이스 연결을 선택합니다.
4. Bitbucket에서 생성한 워크스페이스를 선택합니다.
5. 액세스 권한 부여를 선택합니다.

이제 리포지터리가 Jira Code에 표시됩니다.

자세한 내용은 이슈 JRACLOUD-95847을 참조하세요.