- Jira로 동기화된 GitLab 데이터
- Jira Cloud 앱용 GitLab 설치
- Jira Cloud 앱용 GitLab 구성
- Jira Cloud 앱용 GitLab 업데이트
- 보안 고려 사항
- 문제 해결
Jira Cloud 앱용 GitLab
Offering: GitLab.com, Self-Managed, GitLab Dedicated
이 페이지에는 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 설치
Offering: GitLab.com
전제 조건:
- 네트워크가 GitLab과 Jira 사이의 들어오고 나가는 연결을 허용해야 합니다.
- 특정 Jira 사용자 요구 사항을 충족해야 합니다.
Jira Cloud 앱을 설치하려면 다음을 수행하세요:
- Jira에서 상단 표시줄에서 앱 > 더 많은 앱 찾기를 선택하고
GitLab for Jira Cloud
를 검색합니다. - GitLab for Jira Cloud를 선택한 후 지금 가져오기를 선택합니다.
또는 직접 Atlassian Marketplace에서 앱을 가져올 수 있습니다.
이제 GitLab for Jira Cloud 앱 구성을 할 수 있습니다.
개요는 Atlassian Marketplace에서 GitLab for Jira Cloud 앱 구성을 참조하세요.
Jira Cloud 앱용 GitLab 구성
Offering: GitLab.com
- 네임스페이스 추가는 GitLab 16.1에서 링크 그룹으로 이름 변경되었습니다.
전제 조건:
- GitLab 그룹의 메인터 역할 이상이 있어야 합니다.
- 특정 Jira 사용자 요구 사항을 충족해야 합니다.
GitLab for Jira Cloud 앱을 구성하려면 GitLab for Jira Cloud 앱을 하나 이상의 GitLab 그룹에 링크하여 GitLab에서 Jira로 데이터를 동기화할 수 있습니다.
다음을 수행하여 GitLab for Jira Cloud 앱을 구성하세요:
- Jira에서 상단 표시줄에서 앱 > 내 앱 관리를 선택합니다.
- GitLab for Jira를 확장합니다. 앱을 어떻게 설치했는지에 따라 앱의 이름은 다음과 같습니다:
- 시작하기를 선택합니다.
- 선택 사항. Jira와 자체 호스팅되는 GitLab 사이를 연결하려면 GitLab 버전 변경을 선택합니다.
- 모든 확인란을 선택한 후 다음을 선택합니다.
- 자신의 GitLab 인스턴스 URL을 입력한 후 저장을 선택합니다.
- GitLab에 로그인을 선택한 후 자격 증명을 입력합니다.
- 인증을 선택합니다. 이제 그룹 디렉터리이 표시됩니다.
- 링크 그룹을 선택합니다.
- 그룹을 링크하려면 링크를 선택합니다.
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 사용자 요구 사항을 충족하는지 확인하세요.