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 for Jira Cloud 앱을 GitLab.com에 설치하려면 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개의 Merge Request
    • 마지막 400개의 브랜치 및 해당 브랜치의 마지막 커밋(GitLab 15.11 이상)
  • 그룹을 링크한 후에 생성된 프로젝트 데이터:
    • Merge Request
    • 브랜치
    • 커밋
    • 빌드
    • 배포
    • 피처 플래그

GitLab for Jira Cloud 앱 설치

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

사전 요구 조건:

  • 네트워크는 GitLab과 Jira 간의 들어오는 및 나가는 연결을 허용해야 합니다.
  • 일부 Jira 사용자 요구 사항을 충족해야 합니다.

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

  1. Jira에서 상단 바에서 Apps > Explore more 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 그룹의 유지관리자(Maintainer) 역할 이상이어야 합니다.
  • 일부 Jira 사용자 요구 사항을 충족해야 합니다.

GitLab for Jira Cloud 앱을 구성하려면, GitLab for Jira Cloud 앱을 한 개 이상의 GitLab 그룹에 링크하여 GitLab에서 Jira로 데이터를 동기화할 수 있습니다.

  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 앱을 연결할 때 다음과 같은 오류가 발생할 수 있습니다. 

그룹을 링크하는 데 실패했습니다. 다시 시도해 주십시오.

사용자 정보가 충분한 권한 부족으로 인해 Jira에서 가져올 수 없으면 403 금지됨 오류가 반환됩니다.

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