• 통합 구성
• Jira 이슈 확인
  • Jira 이슈 필터링
• 취약점을위한 Jira 이슈 생성
• Jira Cloud API 토큰 생성
• Jira 서버에서 Jira Cloud로 마이그레이션

Jira 이슈 통합

Jira 이슈 통합은 하나 이상의 GitLab 프로젝트를 Jira 인스턴스에 연결합니다. Jira 인스턴스는 직접 호스팅하거나 Jira Cloud에서 호스팅할 수 있습니다. 지원되는 Jira 버전은 6.x, 7.x, 8.x, 및 9.x입니다.

통합 구성

• GitLab 16.0에서 도입된 Jira 개인 액세스 토큰을 사용하여 인증합니다.

전제 조건:

• GitLab 설치는 상대 URL을 사용하면 안 됩니다.
• Jira Cloud의 경우:
  • Jira Cloud API 토큰 생성 및 해당 토큰을 생성한 이메일 주소가 있어야 합니다.
  • 만약 IP 허용 디렉터리을 활성화했다면, GitLab.com IP 범위를 허용 디렉터리에 추가하여 GitLab에서 Jira 이슈를 확인할 수 있습니다.
• Jira Data Center 또는 Jira Server의 경우, 다음 중 하나가 있어야 합니다:
  • Jira 사용자 이름과 암호.
  • Jira 개인 액세스 토큰 (GitLab 16.0 이상).

Jira 이슈 통합은 GitLab의 프로젝트 설정을 구성하여 활성화할 수 있습니다. Self-managed GitLab에서는 프로젝트 설정뿐만 아니라 그룹 수준 및 인스턴스 수준 에서 통합을 구성할 수도 있습니다.

GitLab에서 프로젝트 설정을 구성하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. 설정 > 통합을 선택합니다.
3. Jira를 선택합니다.
4. 통합 활성화 아래에서 활성 확인란을 선택합니다.
5. 연결 세부 정보를 제공합니다:
   • 웹 URL: 해당 GitLab 프로젝트에 연결할 Jira 인스턴스 웹 인터페이스의 기본 URL(예: https://jira.example.com).
   • Jira API URL: Jira 인스턴스 API의 기본 URL(예: https://jira-api.example.com). 이 URL이 설정되지 않은 경우 웹 URL 값이 기본으로 사용됩니다. Jira Cloud의 경우 Jira API URL을 비워둡니다.
   • 인증 방법:
     • 기본:
       • 이메일 또는 사용자 이름:
         • Jira Cloud의 경우 이메일을 입력합니다.
         • Jira Data Center 또는 Jira Server의 경우 사용자 이름을 입력합니다.
       • API 토큰 또는 암호:
         • Jira Cloud의 경우 API 토큰을 입력합니다.
         • Jira Data Center 또는 Jira Server의 경우 암호를 입력합니다.
     • Jira 개인 액세스 토큰 (Jira Data Center 및 Jira Server 전용): 개인 액세스 토큰을 입력합니다.
6. 트리거 설정을 제공합니다:
   • 커밋, Merge Request, 또는 둘 다를 트리거로 선택합니다. GitLab에서 Jira 이슈 ID를 언급하면 GitLab이 해당 이슈로 연결됩니다.
   • Jira 이슈에 연결된 GitLab으로부터 코멘트를 추가하려면 코멘트 활성화 확인란을 선택합니다.
   • GitLab에서 Jira 이슈를 자동으로 전환하려면, Jira 전환 활성화 확인란을 선택합니다.
7. Jira 이슈 매칭 섹션에서:
   • Jira 이슈 정규식에 정규식 패턴을 입력합니다.
   • Jira 이슈 접두어에 접두어를 입력합니다.
8. 옵션입니다. 이슈 섹션에서:
   • GitLab에서 Jira 이슈를 확인하려면:

     1. Jira 이슈 활성화 확인란을 선택합니다.

        이 설정을 활성화하면 GitLab 프로젝트에 액세스하는 모든 사용자가 지정한 Jira 프로젝트의 모든 이슈를 볼 수 있습니다.

     2. Jira 프로젝트 키를 입력합니다.

   • 취약점에 대한 Jira 이슈 생성를 하려면:

     1. 취약점으로부터 Jira 이슈 생성 활성화 확인란을 선택합니다.

        이 설정은 프로젝트 및 그룹 수준에서만 활성화할 수 있습니다.

     2. 생성할 Jira 이슈 유형을 선택합니다.

        이슈 유형을 선택하기 전에 Jira 프로젝트 키를 입력하고 변경 사항 저장을 선택해야 합니다.
9. 옵션입니다. 설정 테스트를 선택합니다.
10. 변경 사항 저장을 선택합니다.

이제 GitLab 프로젝트는 인스턴스의 모든 Jira 프로젝트와 상호 작용할 수 있습니다.

Jira 이슈 확인

• 그룹 수준에서 Jira 이슈 활성화가 가능해졌습니다(도입된 GitLab 16.9 참조).

전제 조건:

• Jira 이슈 통합이 구성되어 있으며 Jira 이슈 활성화 확인란이 선택되어 있어야 합니다.

단일 Jira 프로젝트에서 GitLab 프로젝트로부터 이슈를 확인하려면:

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
2. Plan > Jira 이슈를 선택합니다.

기본적으로, 이슈는 생성된 날짜순으로 정렬됩니다. 가장 최근에 생성된 이슈가 맨 위에 표시됩니다. 이슈를 필터링하고 특정 이슈를 선택하여 GitLab에서 해당 이슈를 확인할 수 있습니다.

이슈는 Jira 상태에 기반하여 다음과 같은 탭으로 그룹화됩니다:

• 열림: 완료 상태가 아닌 모든 Jira 상태를 가지는 이슈.
• 닫힘: 완료 Jira 상태를 가지는 이슈.
• 모든 것: 모든 Jira 상태를 가지는 이슈들.

Jira 이슈 필터링

사전 요구 사항:

• Jira 이슈 통합이 구성되었으며 Enable Jira issues 확인란이 선택되어 있는지 확인하십시오.

GitLab에서 Jira 이슈 보기를 할 때, 요약 및 설명에있는 텍스트로 이슈를 필터링 할 수 있습니다. 또한 다음과 같이 이슈를 필터링 할 수도 있습니다:

• 라벨: URL의 labels[] 매개변수에 하나 이상의 Jira 이슈 라벨을 지정합니다. 여러 라벨을 지정하면 지정된 모든 라벨이있는 이슈만 표시됩니다 (예: /-/integrations/jira/issues?labels[]=backend&labels[]=feature&labels[]=QA).
• 상태: URL의 status 매개변수에 Jira 이슈 상태를 지정합니다 (예: /-/integrations/jira/issues?status=In Progress).
• 보고자: URL의 author_username 매개변수에 Jira 표시 이름을 지정합니다 (예: /-/integrations/jira/issues?author_username=John Smith).
• 담당자: URL의 assignee_username 매개변수에 Jira 표시 이름을 지정합니다 (예: /-/integrations/jira/issues?assignee_username=John Smith).

취약점을위한 Jira 이슈 생성

사전 요구 사항:

• Jira 이슈 통합이 구성되었으며 Enable Jira issues 및 Enable Jira issue creation from vulnerabilities 확인란이 선택되어 있는지 확인하십시오.
• 대상 프로젝트에서 이슈를 생성할 권한이 있는 Jira 사용자 계정이 있어야합니다.

GitLab에서 취약점을 해결하거나 완화하기위한 모든 작업을 추적하기 위해 Jira 이슈를 생성 할 수 있습니다. 취약점에 대한 Jira 이슈를 생성하려면:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾으세요.
2. Secure > Vulnerability report를 선택합니다.
3. 취약점 설명을 선택합니다.
4. Jira 이슈 생성을 선택합니다.

이슈는 취약점 보고서의 정보와 함께 대상 Jira 프로젝트에 생성됩니다.

GitLab 이슈를 생성하려면 취약점을위한 GitLab 이슈 생성을 참조하십시오.

Jira Cloud API 토큰 생성

Jira Cloud의 Jira 이슈 통합을 구성하려면 Jira Cloud API 토큰이 필요합니다. Jira Cloud API 토큰을 생성하려면:

1. Jira 프로젝트에 쓰기 액세스 권한이있는 계정으로 Atlassian에 로그인합니다.

   링크를 클릭하여 API 토큰 페이지가 엽니다. 또는 Atlassian 프로필에서 계정 설정 > 보안 > API 토큰 생성 및 관리를 선택합니다.

2. API 토큰 생성을 선택합니다.
3. 대화 상자에서 토큰에 대한 라벨을 입력하고 생성을 선택합니다.

API 토큰을 복사하려면 복사를 선택합니다.

Jira 서버에서 Jira Cloud로 마이그레이션

Jira Server에서 Jira Cloud로 마이그레이션하고 Jira 통합을 유지하려면 다음을 수행하십시오:

1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾으세요.
2. 설정 > 통합을 선택합니다.
3. Jira를 선택합니다.
4. 웹 URL에 새 Jira 사이트 URL을 입력하십시오 (예: https://myjirasite.atlassian.net).
5. 이메일 또는 사용자 이름에 Jira 프로필에 등록된 이메일을 입력하십시오.
6. Jira Cloud API 토큰 생성하고 토큰 값을 복사합니다.
7. API 토큰 또는 비밀번호에 API 토큰 값을 붙여 넣습니다.
8. 선택 사항. 설정 테스트를 선택합니다.
9. 변경 사항 저장을 선택합니다.

GitLab에서 기존 Jira 이슈 참조를 새 Jira 사이트 URL을 사용하도록 업데이트하려면 Markdown 캐시 무효화해야합니다.