Jira Cloud 앱용 GitLab

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

이 페이지에는 Jira Cloud 앱용 사용자 설명서가 포함되어 있습니다. 관리자 설명서는 Jira Cloud 앱용 GitLab 관리를 참조하세요.

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

GitLab for Jira Cloud 앱을 사용하여 최상위 그룹 또는 하위 그룹을 링크할 수 있습니다. 프로젝트 또는 개인 네임스페이스를 직접 연결할 수는 없습니다.

GitLab.com에 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개의 Merge Request
    • 마지막 400개의 브랜치 및 각 브랜치의 마지막 커밋(GitLab 15.11 버전 이후)
  • 그룹을 링크한 후 새로운 프로젝트 데이터:
    • Merge Request
    • 브랜치
    • 커밋
    • 빌드
    • 배포
    • 피처 플래그

Jira Cloud 앱용 GitLab 설치

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

전제 조건:

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

Jira Cloud 앱을 설치하려면 다음을 수행하세요:

  1. Jira에서 상단 표시줄에서 앱 > 더 많은 앱 찾기를 선택하고 GitLab for Jira Cloud를 검색합니다.
  2. GitLab for Jira Cloud를 선택한 후 지금 가져오기를 선택합니다.

또는 직접 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 for Jira Cloud 앱을 구성하려면 GitLab for Jira Cloud 앱을 하나 이상의 GitLab 그룹에 링크하여 GitLab에서 Jira로 데이터를 동기화할 수 있습니다.

다음을 수행하여 GitLab for Jira Cloud 앱을 구성하세요:

  1. Jira에서 상단 표시줄에서 앱 > 내 앱 관리를 선택합니다.
  2. GitLab for Jira를 확장합니다. 앱을 어떻게 설치했는지에 따라 앱의 이름은 다음과 같습니다:
  3. 시작하기를 선택합니다.
  4. 선택 사항. Jira와 자체 호스팅되는 GitLab 사이를 연결하려면 GitLab 버전 변경을 선택합니다.
    1. 모든 확인란을 선택한 후 다음을 선택합니다.
    2. 자신의 GitLab 인스턴스 URL을 입력한 후 저장을 선택합니다.
  5. GitLab에 로그인을 선택한 후 자격 증명을 입력합니다.
  6. 인증을 선택합니다. 이제 그룹 디렉터리이 표시됩니다.
  7. 링크 그룹을 선택합니다.
  8. 그룹을 링크하려면 링크를 선택합니다.

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

Jira Cloud 앱용 GitLab 업데이트

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

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

보안 고려 사항

Jira Cloud 앱용 GitLab은 GitLab과 Jira를 연결합니다. 두 응용 프로그램 간에 데이터를 공유하고 양방향으로 액세스가 허용되어야 합니다.

접근 토큰을 통한 Jira 액세스

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

문제 해결

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

관리자 설명서는 Jira Cloud 앱용 GitLab 관리를 참조하세요.

앱 연결 시 오류

GitLab for Jira Cloud 앱을 연결하는 경우 다음과 같은 오류가 발생할 수 있습니다: 

그룹을 링크할 수 없습니다. 다시 시도하세요.

그룹 정보가 부족한 사용자 정보를 가져 올 수 없는 경우 403 금지됨이 반환됩니다.

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