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 데이터

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

  • 이미 존재하는 프로젝트 데이터(그룹을 연결하기 전):
    • 마지막 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 그룹에 GitLab for Jira Cloud 앱을 연결하여 GitLab에서 Jira로 데이터를 동기화할 수 있습니다. GitLab for Jira Cloud 앱 구성 방법은 다음과 같습니다:

  1. Jira에서 상단 표시 줄에서 Apps > 앱 관리를 선택합니다.
  2. GitLab for Jira를 펼칩니다. 앱을 어떻게 설치했는지에 따라 앱의 이름은 다음과 같습니다.
    • Atlassian Marketplace에서 앱을 설치한 경우: GitLab for Jira (gitlab.com)
    • 수동으로 앱을 설치한 경우: GitLab for Jira (<gitlab.example.com>).
  3. 시작하기를 선택합니다.
  4. 선택 사항. Jira와 자체 관리형 GitLab 인스턴스를 연결하려면 GitLab 버전 변경을 선택합니다.
    1. 모든 확인란을 선택한 후 다음을 선택합니다.
    2. GitLab 인스턴스 URL을 입력한 후 저장을 선택합니다.

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

    note
    비밀번호 인증 비활성화된 그룹에 대한 엔터프라이즈 사용자는 먼저 그룹의 단일 사인온 URL로 GitLab에 로그인해야 합니다.
  6. 인증을 선택합니다. 이제 그룹 목록이 표시됩니다.
  7. 그룹 연결을 선택합니다. 그룹에 연결한 후:
  • 해당 그룹의 모든 프로젝트에 대해 Jira로 데이터가 동기화됩니다. 초기 데이터 동기화는 분당 20개 프로젝트씩 일어납니다. 많은 프로젝트를 가진 그룹은 일부 프로젝트의 데이터 동기화가 지연될 수 있습니다.
  • 그룹, 하위 그룹 또는 프로젝트에 대해 GitLab for Jira Cloud 앱 통합이 자동으로 활성화됩니다. 통합을 사용하여 Jira 서비스 관리를 구성할 수 있습니다.

Jira Service Management 구성

전제 조건:

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

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

구성은 GitLab의 GitLab for Jira Cloud 앱 통합에서 발생합니다. 통합은 GitLab의 그룹, 하위 그룹 및 프로젝트에 대해 활성화됩니다. 이는 GitLab 그룹이 연결된 후 GitLab에서 발생합니다.

GitLab for Jira Cloud 앱 통합의 활성화 및 비활성화는 전적으로 그룹 연결을 통해 자동으로 수행되며, GitLab 통합 양식이나 API를 통해 수행되지 않습니다.

Jira Service Management에서:

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

GitLab에서:

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

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

Jira에서 배포 추적에 대한 자세한 정보는 배포 추적 설정을 참조하십시오.

GitLab for Jira Cloud 앱 업데이트

앱의 대부분의 업데이트는 자동으로 수행됩니다. 자세한 정보는 Atlassian 문서를 참조하십시오.

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

보안 고려 사항

GitLab for Jira Cloud 앱은 GitLab과 Jira를 연결합니다. 데이터는 두 애플리케이션 간에 공유되어야 하며 접근 권한은 양방향으로 부여되어야 합니다.

Jira로부터 GitLab으로의 접근

GitLab이 GitLab for Jira Cloud 앱을 구성할 때, Jira로부터 공유 비밀 토큰을 받습니다. 토큰은 Jira 프로젝트에 대한 GitLab의 READ, WRITE, 및 DELETE 앱 스코프를 부여합니다. 이러한 스코프는 Jira 프로젝트의 정보를 업데이트하는 데 필요합니다. 토큰은 앱이 설치된 Jira 프로젝트 외 다른 Atlassian 제품에 GitLab이 액세스할 수 없습니다.

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

Jira로부터 GitLab으로의 데이터 전송

Jira에서 GitLab으로 데이터 전송 시 GitLab에 동기화된 데이터를 참조하십시오.

Jira에서 GitLab으로 데이터를 전송할 때 전송되는 특정 데이터 속성에 대한 자세한 정보는 데이터 동기화에 관여하는 직렬화 클래스를 참조하십시오.

GitLab로부터 Jira로의 데이터 전송

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

Atlassian Marketplace에서의 개인 정보 및 보안 세부 정보에 대한 자세한 정보는 Atlassian Marketplace 목록의 개인 정보 및 보안 세부 정보를 참조하십시오.

문제 해결

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

관리자용 문서에 대해서는 GitLab for Jira Cloud 앱 관리를 참조하십시오.

오류: 그룹 연결 실패

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

그룹 연결에 실패했습니다. 다시 시도하십시오.

사용자 정보를 가져올 수 없는 경우 403 금지 오류가 발생합니다.

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