Jira DVCS 커넥터 문제 해결

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

Jira DVCS 커넥터를 사용할 때 다음 문제가 발생할 수 있습니다.

Jira가 GitLab 서버에 접근할 수 없음

새 계정 추가 양식을 작성하고 액세스 권한을 승인하면 다음 오류가 발생하면서 Jira와 GitLab이 연결할 수 없습니다. 다른 오류 메시지는 어떤 로그에도 표시되지 않습니다. 

액세스 토큰을 가져올 수 없음. Jira에서 https://gitlab.example.com에 접근할 수 없음.

Jira에서의 세션 토큰 버그

GitLab 15.0 이상을 Jira Server와 함께 사용하는 경우, Jira의 세션 토큰 버그를 만날 수 있습니다. 이 버그는 Jira Server 8.20.8, 8.22.3, 8.22.4, 9.4.6 및 9.4.14에 영향을 줍니다.

이 문제를 해결하려면 Jira Server 8.20.11 이상 또는 9.1.0 이상을 사용해야 합니다.

SSL 및 TLS 문제

SSL 및 TLS 문제로 다음 오류 메시지가 발생할 수 있습니다. 

액세스 토큰을 가져올 수 없음. Jira에서 https://gitlab.example.com에 접근할 수 없음.
  • Jira 통합은 GitLab이 Jira에 연결되도록 해야 합니다. 사설 인증 기관 또는 자체 서명된 인증서에서 발생하는 모든 TLS 문제는 GitLab 서버에서 해결됩니다. GitLab이 TLS 클라이언트이기 때문입니다.
  • Jira 개발 패널은 Jira가 GitLab에 연결되도록 해야 하기 때문에 Jira가 TLS 클라이언트가 됩니다. GitLab 서버의 인증서가 공개된 인증 기관에 의해 발급되지 않은 경우, 해당 인증서(예: 귀하의 조직의 루트 인증서)를 Jira Server의 Java Truststore에 추가하십시오.

Jira 설정에 대한 자세한 내용은 Atlassian 문서 및 Atlassian 지원을 참조하십시오.

  • Trust store에 인증서 추가
    • 가장 간단한 방법은 keytool을 사용하는 것입니다.
    • Jira가 공개 인증 기관을 신뢰하도록 Java의 기본 Truststore(cacerts)에 추가적인 루트를 추가하십시오.
    • Jira Java 런타임을 업그레이드한 후 통합이 작동을 멈출 경우, cacerts Truststore가 업그레이드 중 교체되었을 수 있습니다.
  • SSLPoke Java 클래스를 사용하여 TLS 핸드셰이크를 포함한 연결 문제를 문제 해결합니다.
  • 해당 클래스를 Atlassian 지식 기반에서 Jira Server의 디렉토리(예: /tmp)에 다운로드합니다.
  • Jira와 동일한 Java 런타임을 사용하십시오.
  • Jira에 호출된 망 관련 매개변수(예: 프록시 설정 또는 대체 루트 Truststore(-Djavax.net.ssl.trustStore))를 전달하십시오.

메시지 Successfully connected는 성공적인 TLS 핸드셰이크를 나타냅니다.

문제가 있으면 Java TLS 라이브러리가 자세한 내용을 찾을 수 있도록 오류를 발생시킵니다.

Jira와 DVCS 연결 시 Scope 오류 

요청된 스코프가 잘못되었거나 알 수 없거나 형식이 잘못되었습니다.

가능한 해결 방법:

  1. Jira DVCS 커넥터 설정 후 브라우저에 표시되는 URL에서 쿼리 문자열에 scope=api가 포함되어 있는지 확인합니다.
  2. URL에서 scope=api가 누락된 경우 GitLab 계정 구성을 편집합니다. Scopes 필드를 검토하고 api 확인란이 선택되어 있는지 확인하십시오.

오류: 410 Gone

Jira로 연결하여 저장소를 동기화하면 410 Gone 오류가 발생할 수 있습니다. 이 문제는 Jira DVCS 커넥터를 사용하고 통합이 GitHub Enterprise를 사용하도록 구성된 경우 발생합니다.

자세한 내용은 이슈 340160을 확인하십시오.

동기화 문제

Jira가 삭제된 브랜치와 같은 부정확한 정보를 표시하는 경우 해당 정보를 다시 동기화해야 합니다:

  1. Jira에서 Jira 관리 > 응용 프로그램 > DVCS 계정을 선택합니다.
  2. 계정(그룹 또는 하위 그룹) 옆에서 (생략) 메뉴를 선택합니다.
  3. 각 프로젝트에 대해 마지막 활동 날짜 옆:
    • 소프트 동기화를 수행하려면 동기화 아이콘을 선택합니다.
    • 전체 동기화를 완료하려면 Shift를 누른 채로 동기화 아이콘을 선택합니다.

자세한 내용은 Atlassian 문서를 참조하십시오.

오류: 동기화 실패

특정 프로젝트의 저장소 데이터를 새로 고침할 때 Jira에서 동기화 실패 오류가 발생하면 Jira DVCS 커넥터 로그를 확인하십시오. GitLab의 API 리소스에 대한 요청을 실행하는 중에 발생하는 오류를 찾습니다. 예를 들어: 

요청 실행 실패 [https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 GET https://gitlab.com/api/v4/projects/:id/merge_requests?page=1&per_page=100 returned a response status of 403 Forbidden] 오류:
{"message":"403 Forbidden"}

403 Forbidden 오류가 발생하면 해당 프로젝트에 대해 일부 GitLab 기능이 비활성화되어 있을 수 있습니다. 이 경우에는 병합 요청 기능이 비활성화되어 있습니다.

이 문제를 해결하려면 관련 기능을 활성화하십시오:

  1. 왼쪽 사이드바에서 검색 또는 이동하여 프로젝트를 찾습니다.
  2. 설정 > 일반을 선택합니다.
  3. 가시성, 프로젝트 기능, 권한을 확장합니다.
  4. 필요한 대로 기능을 활성화하도록 토글을 사용합니다.

DVCS 연결 프로젝트에서 웹훅 로그 찾기

DVCS 연결 프로젝트에서 웹훅 로그를 찾으려면:

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 웹훅을 선택합니다.
  3. 프로젝트 훅으로 스크롤합니다.
  4. Jira 인스턴스를 가리키는 로그 옆에서 편집을 선택합니다.
  5. 최근 이벤트로 스크롤합니다.

프로젝트에서 웹훅 로그를 찾을 수 없는 경우 DVCS 설정을 확인하세요.