Jira DVCS 커넥터 트러블슈팅

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

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

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

새 계정 추가 양식을 완료하고 액세스를 승인하면 다음 오류가 표시되며 Jira와 GitLab이 연결할 수 없게 됩니다. 다른 오류 메시지는 로그에 나타나지 않습니다: 

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.

Jira에서 세션 토큰 버그

Jira Server에서 GitLab 15.0 이상을 사용하는 경우 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 문제로 다음 오류 메시지가 발생할 수 있습니다: 

Error obtaining access token. Cannot access https://gitlab.example.com from Jira.
  • Jira 통합은 GitLab이 Jira에 연결하도록 요구합니다. 사설 인증 기관 또는 자체 서명된 인증서에서 발생하는 모든 TLS 문제는 GitLab 서버에서 해결됩니다. GitLab이 TLS 클라이언트이기 때문입니다.
  • Jira 개발 패널은 Jira가 GitLab에 연결하도록 요구하므로 Jira가 TLS 클라이언트가 되게 합니다. GitLab 서버의 인증서가 공개 인증 기관에 의해 발급되지 않았다면(조직의 루트 인증서와 같은) 적절한 인증서를 Jira Server의 Java Truststore에 추가하십시오.

Jira 설정에 대한 자세한 정보는 Atlassian 설명서 및 Atlassian 지원을 참조하세요.

  • 인증서 추가
    • 가장 간단한 접근 방법은 keytool입니다.
    • Java의 기본 Truststore(cacerts)에 추가적인 루트를 추가하여 Jira가 공개 인증 기관을 신뢰하도록 합니다.
    • Jira Java 런타임을 업그레이드한 후 통합이 작동을 멈추면,cacerts Truststore가 업그레이드 중에 교체되었을 수 있습니다.
  • SSLPoke Java 클래스를 사용하여 연결 문제 및 TLS 핸드셰이킹을 해결하십시오.
  • Atlassian 지식 베이스에서 클래스를 Jira Server의 디렉터리(예: /tmp)에 다운로드하십시오.
  • Jira가 사용하는 Java 런타임과 동일한 것을 사용하십시오.
  • Jira에서 호출하는 모든 네트워크 관련 매개변수를 전달하십시오(프록시 설정 또는 대체 루트 Truststore(-Djavax.net.ssl.trustStore)와 같은 것): 
${JAVA_HOME}/bin/java -Djavax.net.ssl.trustStore=/var/atlassian/application-data/jira/cacerts -classpath /tmp SSLPoke gitlab.example.com 443

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

문제가 있는 경우, Java TLS 라이브러리가 자세한 내용을 찾을 수 있는 오류를 생성합니다.

DVCS를 사용하여 Jira에 연결할 때 scope 오류 

The requested scope is invalid, unknown, or malformed.

가능한 해결 방법:

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

Jira에서 계정 추가시 오류

Jira에서 새 계정 추가 양식을 완료하고 액세스를 승인한 후 다음과 같은 문제가 발생할 수 있습니다:

  • Error! Failed adding the account: [Error retrieving list of repositories] 오류.
  • 다시 시도를 선택하면 Account is already integrated with JIRA 오류가 나타납니다.
  • DVCS 계정은 표시되지만 저장소가 나열되지 않습니다.

이 문제를 해결하려면:

  • GitLab Free를 사용하는 경우 GitLab 13.4 이상을 사용하십시오.
  • GitLab 버전 11.10-12.7을 사용하는 경우 식별된 문제를 해결하려면 GitLab 12.8.10 이상으로 업그레이드하십시오.

위의 이유 중 어느 것도 해당되지 않는 경우 GitLab 지원팀에 문의하십시오.

Jira에 연결 시 410 Gone 오류

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

자세한 정보는 이슈 340160를 참조하세요.

동기화 문제

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

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

자세한 정보는 Atlassian 문서를 참조하세요.

저장소 데이터 새로 고침 시 Sync Failed

특정 프로젝트의 저장소 데이터를 새로 고침할 때 Jira에서 Sync Failed 오류가 발생하는 경우 Jira DVCS 커넥터 로그를 확인하세요. GitLab의 API 리소스에 대한 요청을 실행할 때 발생하는 오류를 찾아보세요. 예를 들어: 

Failed to execute request [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] errors:
{"message":"403 Forbidden"}

403 Forbidden 오류가 발생하는 경우 이 프로젝트에서 GitLab 기능이 비활성화되어 있을 수 있습니다. 이전 예제에서는 병합 요청 기능이 비활성화되어 있습니다.

이 문제를 해결하려면 관련 기능을 활성화하세요:

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

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

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

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

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