Jira 이슈 통합 문제 해결

요약

Jira 이슈 통합을 사용할 때 다음과 같은 문제가 발생할 수 있습니다. GitLab에서 Jira 이슈 ID를 언급할 때 이슈 링크가 누락될 수 있습니다. 이 문제를 해결하려면 Jira 이슈 통합을 위해 생성한 Jira 사용자에게 이슈 연결 권한이 있는지 확인하세요.

Jira 이슈 통합을 사용할 때 다음과 같은 문제가 발생할 수 있습니다.

GitLab에서 Jira 이슈에 연결할 수 없음#

GitLab에서 Jira 이슈 ID를 언급할 때 이슈 링크가 누락될 수 있습니다. sidekiq.log에 다음과 같은 예외가 포함될 수 있습니다:

No Link Issue Permission for issue 'JIRA-1234'

이 문제를 해결하려면 Jira 이슈 통합을 위해 생성한 Jira 사용자에게 이슈 연결 권한이 있는지 확인하세요.

GitLab에서 Jira 이슈에 댓글을 달 수 없음#

GitLab에서 Jira 이슈에 댓글을 달 수 없는 경우, Jira 이슈 통합을 위해 생성한 Jira 사용자에게 다음 권한이 있는지 확인하세요:

Jira 이슈에 댓글 작성 권한
Jira 이슈 전환 권한

GitLab 이슈 트래커가 비활성화되면 Jira 이슈 참조와 댓글이 작동하지 않습니다. Jira 액세스에 대한 IP 주소를 제한하는 경우, GitLab Self-Managed IP 주소 또는 GitLab IP 주소를 Jira의 허용 목록에 추가하세요.

근본 원인을 확인하려면 integrations_json.log 파일을 확인하세요. GitLab이 Jira 이슈에 댓글을 달려고 할 때 Error sending message 로그 항목이 나타날 수 있습니다.

GitLab 16.1 이상에서는 오류가 발생할 때 integrations_json.log 파일에 Jira로 나가는 API 요청의 client_* 키가 포함됩니다. client_* 키를 사용하여 오류가 발생한 이유를 Atlassian API 문서에서 확인할 수 있습니다.

다음 예시에서 Jira는 404 Not Found로 응답합니다. 이 오류는 다음과 같은 경우에 발생할 수 있습니다:

Jira 이슈 통합을 위해 생성한 Jira 사용자에게 이슈를 볼 권한이 없는 경우
지정한 Jira 이슈 ID가 존재하지 않는 경우

{
  "severity": "ERROR",
  "time": "2023-07-25T21:38:56.510Z",
  "message": "Error sending message",
  "client_url": "https://my-jira-cloud.atlassian.net",
  "client_path": "/rest/api/2/issue/ALPHA-1",
  "client_status": "404",
  "exception.class": "JIRA::HTTPError",
  "exception.message": "Not Found",
}

반환된 상태 코드에 대한 자세한 내용은 Jira Cloud 플랫폼 REST API 문서를 참조하세요.

`curl`을 사용하여 Jira 이슈 액세스 확인#

특정 Jira 이슈에 대한 Jira 사용자 액세스를 확인하려면 다음 스크립트를 실행하세요:

curl --verbose --user "$USER:$API_TOKEN" "https://$ATLASSIAN_SUBDOMAIN.atlassian.net/rest/api/2/issue/$JIRA_ISSUE"

사용자가 이슈에 액세스할 수 있으면 Jira는 200 OK로 응답하고 반환된 JSON에 Jira 이슈 세부 정보가 포함됩니다.

GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인#

Warning

데이터를 변경하는 명령은 올바르게 또는 적절한 조건에서 실행되지 않으면 손상을 일으킬 수 있습니다. 항상 먼저 테스트 환경에서 명령을 실행하고 복원할 수 있는 백업 인스턴스를 준비해 두세요.

Jira 이슈 통합 문제를 해결하는 데 도움이 되도록, 프로젝트의 Jira 통합 설정을 사용하여 GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인할 수 있습니다.

방법:

Rails 콘솔에서 다음을 실행하세요:

jira_issue_id = "ALPHA-1" # Jira 이슈 ID로 변경하세요
project = Project.find_by_full_path("group/project") # 프로젝트 경로로 변경하세요

integration = project.integrations.find_by(type: "Integrations::Jira")
jira_issue = integration.client.Issue.find(jira_issue_id)
jira_issue.comments.build.save!(body: 'This is a test comment from GitLab via the Rails console')

명령이 성공하면 Jira 이슈에 댓글이 추가됩니다.

GitLab에서 Jira 이슈를 생성할 수 없음#

취약점에서 Jira 이슈를 생성하려고 할 때 "field is required" 오류가 나타날 수 있습니다. 예를 들어, "Components"라는 필드가 없어서 Components is required 오류가 발생합니다. 이는 GitLab이 전달하지 않는 일부 필수 필드가 Jira에 구성되어 있기 때문에 발생합니다. 이 문제를 해결하려면:

Jira 인스턴스에서 새 "Vulnerability" 이슈 유형을 만드세요.
새 이슈 유형을 프로젝트에 할당하세요.
프로젝트의 모든 "취약점"에 대한 필드 스키마를 변경하여 누락된 필드가 필수가 되지 않도록 하세요.

GitLab에서 Jira 이슈를 닫을 수 없음#

GitLab에서 Jira 이슈를 닫을 수 없는 경우:

Jira 설정에서 설정한 전환 ID가 프로젝트에서 이슈를 닫기 위해 필요한 것과 일치하는지 확인하세요. 자세한 내용은 자동 이슈 전환 및 사용자 지정 이슈 전환을 참조하세요.
Jira 이슈가 이미 해결된 상태로 표시되어 있지 않은지 확인하세요:
- Jira 이슈 해결 필드가 설정되지 않았는지 확인하세요.
- Jira 목록에서 이슈에 취소선이 표시되지 않았는지 확인하세요.

로그인 실패 후 CAPTCHA#

연속적인 로그인 실패 후 CAPTCHA가 트리거될 수 있습니다. 이러한 실패 시도로 인해 Jira 이슈 통합 설정을 테스트할 때 401 Unauthorized 오류가 발생할 수 있습니다. CAPTCHA가 트리거된 경우 Jira REST API를 사용하여 Jira 사이트에 인증할 수 없습니다.

이 문제를 해결하려면 Jira 인스턴스에 로그인하고 CAPTCHA를 완료하세요.

가져온 프로젝트에서 통합이 작동하지 않음#

가져온 프로젝트의 경우 Jira 이슈 통합이 작동하지 않을 수 있습니다. 자세한 내용은 이슈 341571을 참조하세요.

이 문제를 해결하려면 통합을 비활성화한 다음 다시 활성화하세요.

오류: `certificate verify failed`#

Jira 이슈 통합 설정을 테스트할 때 다음 오류가 발생할 수 있습니다:

Connection failed. Check your integration settings. SSL_connect returned=1 errno=0 peeraddr=<jira.example.com> state=error: certificate verify failed (unable to get local issuer certificate)

이 오류는 integrations_json.log 파일에도 나타날 수 있습니다:

{
  "severity":"ERROR",
  "integration_class":"Integrations::Jira",
  "message":"Error sending message",
  "exception.class":"OpenSSL::SSL::SSLError",
  "exception.message":"SSL_connect returned=1 errno=0 peeraddr=x.x.x.x:443 state=error: certificate verify failed (unable to get local issuer certificate)",
}

이 오류는 Jira 인증서가 공개적으로 신뢰받지 않거나 인증서 체인이 불완전하기 때문에 발생합니다. 이 문제가 해결될 때까지 GitLab은 Jira에 연결되지 않습니다.

이 문제를 해결하려면 일반적인 SSL 오류를 참조하세요.

모든 Jira 프로젝트를 인스턴스 수준 또는 그룹 수준 값으로 변경#

Warning

인스턴스의 모든 프로젝트 변경#

인스턴스 수준 통합 설정을 사용하도록 모든 Jira 프로젝트를 변경하려면:

Rails 콘솔에서 다음을 실행하세요:

Integrations::Jira.where(active: true, instance: false, inherit_from_id: nil).find_each do |integration|
  default_integration = Integration.default_integration(integration.type, integration.project)

  integration.inherit_from_id = default_integration.id

  if integration.save(context: :manual_change)
    if Gitlab.version_info >= Gitlab::VersionInfo.new(16, 9)
      Integrations::Propagation::BulkUpdateService.new(default_integration, [integration]).execute
    else
      BulkUpdateIntegrationService.new(default_integration, [integration]).execute
    end
  end
end

UI에서 인스턴스 수준 통합을 수정하고 저장하여 변경 사항을 모든 그룹 수준 및 프로젝트 수준 통합에 전파하세요.

그룹의 모든 프로젝트 변경#

그룹(및 해당 하위 그룹)의 모든 Jira 프로젝트가 그룹 수준 통합 설정을 사용하도록 변경하려면:

Rails 콘솔에서 다음을 실행하세요:

def reset_integration(target)
  integration = target.integrations.find_by(type: Integrations::Jira)

  return if integration.nil? # Jira 이슈 통합이 없는 프로젝트 건너뛰기
  return unless integration.inherit_from_id.nil? # 이미 상속 중인 통합 건너뛰기

  default_integration = Integration.default_integration(integration.type, target)

  integration.inherit_from_id = default_integration.id

  if integration.save(context: :manual_change)
    if Gitlab.version_info >= Gitlab::VersionInfo.new(16, 9)
      Integrations::Propagation::BulkUpdateService.new(default_integration, [integration]).execute
    else
      BulkUpdateIntegrationService.new(default_integration, [integration]).execute
    end
  end
end

parent_group = Group.find_by_full_path('top-level-group') # 최상위 그룹의 전체 경로 추가
current_user = User.find_by_username('admin-user') # 관리자 액세스 권한을 가진 사용자의 사용자 이름 추가

unless parent_group.nil?
  groups = GroupsFinder.new(current_user, { parent: parent_group, include_parent_descendants: true }).execute

  # 하위 그룹의 프로젝트를 상위 그룹 통합 설정을 사용하도록 재설정
  groups.find_each do |group|
    reset_integration(group)

    group.projects.find_each do |project|
      reset_integration(project)
    end
  end

  # 상위 그룹의 직접 프로젝트를 상위 그룹 통합 설정을 사용하도록 재설정
  parent_group.projects.find_each do |project|
    reset_integration(project)
  end
end

모든 프로젝트의 통합 비밀번호 업데이트#

Warning

활성 Jira 이슈 통합이 있는 모든 프로젝트에 대한 Jira 사용자 비밀번호를 재설정하려면, Rails 콘솔에서 다음을 실행하세요:

p = Project.find_by_sql("SELECT p.id FROM projects p LEFT JOIN integrations i ON p.id = i.project_id WHERE i.type_new = 'Integrations::Jira' AND i.active = true")

p.each do |project|
  project.jira_integration.update_attribute(:password, '<your-new-password>')
end

Jira 이슈 목록#

GitLab에서 Jira 이슈를 볼 때 다음과 같은 문제가 발생할 수 있습니다.

오류: `500 We're sorry`#

GitLab에서 Jira 이슈에 액세스할 때 500 We're sorry. Something went wrong on our end 오류가 발생할 수 있습니다. production.log에서 다음 예외가 포함되어 있는지 확인하세요:

:NoMethodError (undefined method 'duedate' for #)

그런 경우 통합된 Jira 프로젝트의 이슈에서 만기일 필드가 표시되도록 설정되어 있는지 확인하세요.

오류: `An error occurred while requesting data from Jira`#

GitLab에서 Jira 이슈 목록을 보거나 Jira 이슈를 만들려고 할 때 다음 오류 중 하나가 발생할 수 있습니다:

An error occurred while requesting data from Jira

An error occurred while fetching issue list. Connection failed. Check your integration settings.

이러한 오류는 Jira 이슈 통합의 인증이 완전하지 않거나 올바르지 않을 때 발생합니다.

이 문제를 해결하려면 Jira 이슈 통합을 다시 구성하세요. 인증 세부 정보가 올바른지 확인하고 API 토큰 또는 비밀번호를 다시 입력한 다음 변경 사항을 저장하세요.

프로젝트 키에 예약된 JQL 단어가 포함된 경우 Jira 이슈 목록이 로드되지 않습니다. 자세한 내용은 이슈 426176을 참조하세요. Jira 프로젝트 키에는 제한된 단어 및 문자가 포함되어서는 안 됩니다.

Jira 자격 증명 오류#

GitLab에서 Jira 이슈 목록을 보려고 할 때 다음 오류 중 하나가 나타날 수 있습니다.

오류: `The value '<project>' does not exist for the field 'project'`#

Jira 설치에 잘못된 인증 자격 증명을 사용하는 경우 다음 오류가 나타날 수 있습니다:

An error occurred while requesting data from Jira:
The value '<project>' does not exist for the field 'project'.
Check your Jira issues integration configuration and try again.

인증 자격 증명은 Jira 설치 유형에 따라 다릅니다:

Jira Cloud의 경우 Jira Cloud API 토큰과 토큰을 만드는 데 사용한 이메일 주소가 필요합니다.
Jira Data Center 또는 Jira Server의 경우 Jira 사용자 이름과 비밀번호 또는 GitLab 16.0 이상에서는 Jira 개인 액세스 토큰이 필요합니다.

자세한 내용은 Jira 이슈 통합을 참조하세요.

이 문제를 해결하려면 Jira 설치에 맞는 인증 자격 증명을 업데이트하세요.

오류: `The credentials for accessing Jira are not allowed to access the data`#

Jira 이슈 통합에서 지정한 Jira 프로젝트 키에 Jira 자격 증명이 액세스할 수 없는 경우 다음 오류가 나타날 수 있습니다:

The credentials for accessing Jira are not allowed to access the data.
Check your Jira issues integration credentials and try again.

Warning

Atlassian은 2024년 10월 31일에 Jira Cloud의 이전 JQL 검색 엔드포인트(GET/POST /rest/api/2/search)를 폐기했으며, 2025년 5월 1일에 제거될 예정입니다. Jira Server와 Data Center는 계속 /rest/api/2/search 엔드포인트를 사용합니다. 자세한 내용은 Atlassian 폐기 안내를 참조하세요.

이 문제를 해결하려면 Jira 이슈 통합에서 구성한 Jira 사용자가 지정된 Jira 프로젝트 키와 관련된 이슈를 볼 권한이 있는지 확인하세요.

Jira 사용자에게 이 권한이 있는지 확인하려면 다음 중 하나를 수행하세요:

브라우저에서 Jira 이슈 통합에서 구성한 사용자로 Jira에 로그인하세요. Jira API는 쿠키 기반 인증을 지원하므로 브라우저에서 이슈가 반환되는지 확인할 수 있습니다:
```
https://.atlassian.net/rest/api/3/search/jql?jql=project=
```

HTTP 기본 인증을 위해 curl을 사용하여 API에 액세스하고 이슈가 반환되는지 확인하세요:

curl --verbose --user "$JIRA_EMAIL:$JIRA_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --request POST \
  --data '{"jql":"project='$JIRA_PROJECT_KEY'"}' \
  "https://$ATLASSIAN_SUBDOMAIN.atlassian.net/rest/api/3/search/jql" | jq

API 응답은 JSON 응답을 반환합니다:

issues는 Jira 프로젝트 키와 일치하는 이슈 배열을 포함합니다.
nextPageToken은 가져올 결과가 더 있는 경우 제공됩니다.

반환된 상태 코드 및 API 세부 정보에 대한 자세한 내용은 JQL 향상된 검색을 사용한 이슈 검색 (POST)을 참조하세요.

브라우저에서 Jira 이슈 통합에서 구성한 사용자로 Jira에 로그인하세요. Jira API는 쿠키 기반 인증을 지원하므로 브라우저에서 이슈가 반환되는지 확인할 수 있습니다:
```
/rest/api/2/search?jql=project=
```

HTTP 기본 인증을 위해 curl을 사용하여 API에 액세스하고 이슈가 반환되는지 확인하세요:

curl --verbose --header 'Authorization: Bearer '$JIRA_API_TOKEN'' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --request POST \
  --data '{"jql":"project='$JIRA_PROJECT_KEY'"}' \
  "$JIRA_SERVER_URL/rest/api/2/search" | jq

API 응답은 JSON 응답을 반환합니다:

issues는 Jira 프로젝트 키와 일치하는 이슈 배열을 포함합니다.
total은 가져올 결과가 더 있는 경우 제공됩니다.

반환된 상태 코드 및 API 세부 정보에 대한 자세한 내용은 JQL을 사용한 검색 수행 (POST)을 참조하세요.

Jira 이슈 통합 문제 해결

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

원문 보기

번역일: 2026-05-22

요약

Jira 이슈 통합을 사용할 때 다음과 같은 문제가 발생할 수 있습니다.

GitLab에서 Jira 이슈에 연결할 수 없음#

GitLab에서 Jira 이슈 ID를 언급할 때 이슈 링크가 누락될 수 있습니다. sidekiq.log에 다음과 같은 예외가 포함될 수 있습니다:

No Link Issue Permission for issue 'JIRA-1234'

이 문제를 해결하려면 Jira 이슈 통합을 위해 생성한 Jira 사용자에게 이슈 연결 권한이 있는지 확인하세요.

GitLab에서 Jira 이슈에 댓글을 달 수 없음#

GitLab에서 Jira 이슈에 댓글을 달 수 없는 경우, Jira 이슈 통합을 위해 생성한 Jira 사용자에게 다음 권한이 있는지 확인하세요:

Jira 이슈에 댓글 작성 권한
Jira 이슈 전환 권한

다음 예시에서 Jira는 404 Not Found로 응답합니다. 이 오류는 다음과 같은 경우에 발생할 수 있습니다:

Jira 이슈 통합을 위해 생성한 Jira 사용자에게 이슈를 볼 권한이 없는 경우
지정한 Jira 이슈 ID가 존재하지 않는 경우

{
  "severity": "ERROR",
  "time": "2023-07-25T21:38:56.510Z",
  "message": "Error sending message",
  "client_url": "https://my-jira-cloud.atlassian.net",
  "client_path": "/rest/api/2/issue/ALPHA-1",
  "client_status": "404",
  "exception.class": "JIRA::HTTPError",
  "exception.message": "Not Found",
}

반환된 상태 코드에 대한 자세한 내용은 Jira Cloud 플랫폼 REST API 문서를 참조하세요.

`curl`을 사용하여 Jira 이슈 액세스 확인#

특정 Jira 이슈에 대한 Jira 사용자 액세스를 확인하려면 다음 스크립트를 실행하세요:

curl --verbose --user "$USER:$API_TOKEN" "https://$ATLASSIAN_SUBDOMAIN.atlassian.net/rest/api/2/issue/$JIRA_ISSUE"

사용자가 이슈에 액세스할 수 있으면 Jira는 200 OK로 응답하고 반환된 JSON에 Jira 이슈 세부 정보가 포함됩니다.

GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인#

Warning

Jira 이슈 통합 문제를 해결하는 데 도움이 되도록, 프로젝트의 Jira 통합 설정을 사용하여 GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인할 수 있습니다.

방법:

Rails 콘솔에서 다음을 실행하세요:

jira_issue_id = "ALPHA-1" # Jira 이슈 ID로 변경하세요
project = Project.find_by_full_path("group/project") # 프로젝트 경로로 변경하세요

integration = project.integrations.find_by(type: "Integrations::Jira")
jira_issue = integration.client.Issue.find(jira_issue_id)
jira_issue.comments.build.save!(body: 'This is a test comment from GitLab via the Rails console')

명령이 성공하면 Jira 이슈에 댓글이 추가됩니다.

GitLab에서 Jira 이슈를 생성할 수 없음#

Jira 인스턴스에서 새 "Vulnerability" 이슈 유형을 만드세요.
새 이슈 유형을 프로젝트에 할당하세요.
프로젝트의 모든 "취약점"에 대한 필드 스키마를 변경하여 누락된 필드가 필수가 되지 않도록 하세요.

GitLab에서 Jira 이슈를 닫을 수 없음#

GitLab에서 Jira 이슈를 닫을 수 없는 경우:

Jira 설정에서 설정한 전환 ID가 프로젝트에서 이슈를 닫기 위해 필요한 것과 일치하는지 확인하세요. 자세한 내용은 자동 이슈 전환 및 사용자 지정 이슈 전환을 참조하세요.
Jira 이슈가 이미 해결된 상태로 표시되어 있지 않은지 확인하세요:
- Jira 이슈 해결 필드가 설정되지 않았는지 확인하세요.
- Jira 목록에서 이슈에 취소선이 표시되지 않았는지 확인하세요.

로그인 실패 후 CAPTCHA#

이 문제를 해결하려면 Jira 인스턴스에 로그인하고 CAPTCHA를 완료하세요.

가져온 프로젝트에서 통합이 작동하지 않음#

가져온 프로젝트의 경우 Jira 이슈 통합이 작동하지 않을 수 있습니다. 자세한 내용은 이슈 341571을 참조하세요.

이 문제를 해결하려면 통합을 비활성화한 다음 다시 활성화하세요.

오류: `certificate verify failed`#

Jira 이슈 통합 설정을 테스트할 때 다음 오류가 발생할 수 있습니다:

Connection failed. Check your integration settings. SSL_connect returned=1 errno=0 peeraddr=<jira.example.com> state=error: certificate verify failed (unable to get local issuer certificate)

이 오류는 integrations_json.log 파일에도 나타날 수 있습니다:

{
  "severity":"ERROR",
  "integration_class":"Integrations::Jira",
  "message":"Error sending message",
  "exception.class":"OpenSSL::SSL::SSLError",
  "exception.message":"SSL_connect returned=1 errno=0 peeraddr=x.x.x.x:443 state=error: certificate verify failed (unable to get local issuer certificate)",
}

이 문제를 해결하려면 일반적인 SSL 오류를 참조하세요.

모든 Jira 프로젝트를 인스턴스 수준 또는 그룹 수준 값으로 변경#

Warning

인스턴스의 모든 프로젝트 변경#

인스턴스 수준 통합 설정을 사용하도록 모든 Jira 프로젝트를 변경하려면:

Rails 콘솔에서 다음을 실행하세요:

Integrations::Jira.where(active: true, instance: false, inherit_from_id: nil).find_each do |integration|
  default_integration = Integration.default_integration(integration.type, integration.project)

  integration.inherit_from_id = default_integration.id

  if integration.save(context: :manual_change)
    if Gitlab.version_info >= Gitlab::VersionInfo.new(16, 9)
      Integrations::Propagation::BulkUpdateService.new(default_integration, [integration]).execute
    else
      BulkUpdateIntegrationService.new(default_integration, [integration]).execute
    end
  end
end

UI에서 인스턴스 수준 통합을 수정하고 저장하여 변경 사항을 모든 그룹 수준 및 프로젝트 수준 통합에 전파하세요.

그룹의 모든 프로젝트 변경#

그룹(및 해당 하위 그룹)의 모든 Jira 프로젝트가 그룹 수준 통합 설정을 사용하도록 변경하려면:

Rails 콘솔에서 다음을 실행하세요:

def reset_integration(target)
  integration = target.integrations.find_by(type: Integrations::Jira)

  return if integration.nil? # Jira 이슈 통합이 없는 프로젝트 건너뛰기
  return unless integration.inherit_from_id.nil? # 이미 상속 중인 통합 건너뛰기

  default_integration = Integration.default_integration(integration.type, target)

  integration.inherit_from_id = default_integration.id

  if integration.save(context: :manual_change)
    if Gitlab.version_info >= Gitlab::VersionInfo.new(16, 9)
      Integrations::Propagation::BulkUpdateService.new(default_integration, [integration]).execute
    else
      BulkUpdateIntegrationService.new(default_integration, [integration]).execute
    end
  end
end

parent_group = Group.find_by_full_path('top-level-group') # 최상위 그룹의 전체 경로 추가
current_user = User.find_by_username('admin-user') # 관리자 액세스 권한을 가진 사용자의 사용자 이름 추가

unless parent_group.nil?
  groups = GroupsFinder.new(current_user, { parent: parent_group, include_parent_descendants: true }).execute

  # 하위 그룹의 프로젝트를 상위 그룹 통합 설정을 사용하도록 재설정
  groups.find_each do |group|
    reset_integration(group)

    group.projects.find_each do |project|
      reset_integration(project)
    end
  end

  # 상위 그룹의 직접 프로젝트를 상위 그룹 통합 설정을 사용하도록 재설정
  parent_group.projects.find_each do |project|
    reset_integration(project)
  end
end

모든 프로젝트의 통합 비밀번호 업데이트#

Warning

활성 Jira 이슈 통합이 있는 모든 프로젝트에 대한 Jira 사용자 비밀번호를 재설정하려면, Rails 콘솔에서 다음을 실행하세요:

p = Project.find_by_sql("SELECT p.id FROM projects p LEFT JOIN integrations i ON p.id = i.project_id WHERE i.type_new = 'Integrations::Jira' AND i.active = true")

p.each do |project|
  project.jira_integration.update_attribute(:password, '<your-new-password>')
end

Jira 이슈 목록#

GitLab에서 Jira 이슈를 볼 때 다음과 같은 문제가 발생할 수 있습니다.

오류: `500 We're sorry`#

:NoMethodError (undefined method 'duedate' for #)

그런 경우 통합된 Jira 프로젝트의 이슈에서 만기일 필드가 표시되도록 설정되어 있는지 확인하세요.

오류: `An error occurred while requesting data from Jira`#

GitLab에서 Jira 이슈 목록을 보거나 Jira 이슈를 만들려고 할 때 다음 오류 중 하나가 발생할 수 있습니다:

An error occurred while requesting data from Jira

An error occurred while fetching issue list. Connection failed. Check your integration settings.

이러한 오류는 Jira 이슈 통합의 인증이 완전하지 않거나 올바르지 않을 때 발생합니다.

Jira 자격 증명 오류#

GitLab에서 Jira 이슈 목록을 보려고 할 때 다음 오류 중 하나가 나타날 수 있습니다.

오류: `The value '<project>' does not exist for the field 'project'`#

Jira 설치에 잘못된 인증 자격 증명을 사용하는 경우 다음 오류가 나타날 수 있습니다:

An error occurred while requesting data from Jira:
The value '<project>' does not exist for the field 'project'.
Check your Jira issues integration configuration and try again.

인증 자격 증명은 Jira 설치 유형에 따라 다릅니다:

Jira Cloud의 경우 Jira Cloud API 토큰과 토큰을 만드는 데 사용한 이메일 주소가 필요합니다.
Jira Data Center 또는 Jira Server의 경우 Jira 사용자 이름과 비밀번호 또는 GitLab 16.0 이상에서는 Jira 개인 액세스 토큰이 필요합니다.

자세한 내용은 Jira 이슈 통합을 참조하세요.

이 문제를 해결하려면 Jira 설치에 맞는 인증 자격 증명을 업데이트하세요.

오류: `The credentials for accessing Jira are not allowed to access the data`#

Jira 이슈 통합에서 지정한 Jira 프로젝트 키에 Jira 자격 증명이 액세스할 수 없는 경우 다음 오류가 나타날 수 있습니다:

The credentials for accessing Jira are not allowed to access the data.
Check your Jira issues integration credentials and try again.

Warning

이 문제를 해결하려면 Jira 이슈 통합에서 구성한 Jira 사용자가 지정된 Jira 프로젝트 키와 관련된 이슈를 볼 권한이 있는지 확인하세요.

Jira 사용자에게 이 권한이 있는지 확인하려면 다음 중 하나를 수행하세요:

브라우저에서 Jira 이슈 통합에서 구성한 사용자로 Jira에 로그인하세요. Jira API는 쿠키 기반 인증을 지원하므로 브라우저에서 이슈가 반환되는지 확인할 수 있습니다:
```
https://.atlassian.net/rest/api/3/search/jql?jql=project=
```

HTTP 기본 인증을 위해 curl을 사용하여 API에 액세스하고 이슈가 반환되는지 확인하세요:

curl --verbose --user "$JIRA_EMAIL:$JIRA_API_TOKEN" \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --request POST \
  --data '{"jql":"project='$JIRA_PROJECT_KEY'"}' \
  "https://$ATLASSIAN_SUBDOMAIN.atlassian.net/rest/api/3/search/jql" | jq

API 응답은 JSON 응답을 반환합니다:

issues는 Jira 프로젝트 키와 일치하는 이슈 배열을 포함합니다.
nextPageToken은 가져올 결과가 더 있는 경우 제공됩니다.

반환된 상태 코드 및 API 세부 정보에 대한 자세한 내용은 JQL 향상된 검색을 사용한 이슈 검색 (POST)을 참조하세요.

브라우저에서 Jira 이슈 통합에서 구성한 사용자로 Jira에 로그인하세요. Jira API는 쿠키 기반 인증을 지원하므로 브라우저에서 이슈가 반환되는지 확인할 수 있습니다:
```
/rest/api/2/search?jql=project=
```

HTTP 기본 인증을 위해 curl을 사용하여 API에 액세스하고 이슈가 반환되는지 확인하세요:

curl --verbose --header 'Authorization: Bearer '$JIRA_API_TOKEN'' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --request POST \
  --data '{"jql":"project='$JIRA_PROJECT_KEY'"}' \
  "$JIRA_SERVER_URL/rest/api/2/search" | jq

API 응답은 JSON 응답을 반환합니다:

issues는 Jira 프로젝트 키와 일치하는 이슈 배열을 포함합니다.
total은 가져올 결과가 더 있는 경우 제공됩니다.

반환된 상태 코드 및 API 세부 정보에 대한 자세한 내용은 JQL을 사용한 검색 수행 (POST)을 참조하세요.

Jira 이슈 통합 문제 해결

GitLab에서 Jira 이슈에 연결할 수 없음#

GitLab에서 Jira 이슈에 댓글을 달 수 없음#

curl을 사용하여 Jira 이슈 액세스 확인#

GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인#

GitLab에서 Jira 이슈를 생성할 수 없음#

GitLab에서 Jira 이슈를 닫을 수 없음#

로그인 실패 후 CAPTCHA#

가져온 프로젝트에서 통합이 작동하지 않음#

오류: certificate verify failed#

모든 Jira 프로젝트를 인스턴스 수준 또는 그룹 수준 값으로 변경#

인스턴스의 모든 프로젝트 변경#

그룹의 모든 프로젝트 변경#

모든 프로젝트의 통합 비밀번호 업데이트#

Jira 이슈 목록#

오류: 500 We're sorry#

오류: An error occurred while requesting data from Jira#

Jira 자격 증명 오류#

오류: The value '<project>' does not exist for the field 'project'#

오류: The credentials for accessing Jira are not allowed to access the data#

GitLab에서 Jira 이슈에 연결할 수 없음#

GitLab에서 Jira 이슈에 댓글을 달 수 없음#

curl을 사용하여 Jira 이슈 액세스 확인#

GitLab이 Jira 이슈에 댓글을 달 수 있는지 확인#

GitLab에서 Jira 이슈를 생성할 수 없음#

GitLab에서 Jira 이슈를 닫을 수 없음#

로그인 실패 후 CAPTCHA#

가져온 프로젝트에서 통합이 작동하지 않음#

오류: certificate verify failed#

모든 Jira 프로젝트를 인스턴스 수준 또는 그룹 수준 값으로 변경#

인스턴스의 모든 프로젝트 변경#

그룹의 모든 프로젝트 변경#

모든 프로젝트의 통합 비밀번호 업데이트#

Jira 이슈 목록#

오류: 500 We're sorry#

오류: An error occurred while requesting data from Jira#

Jira 자격 증명 오류#

오류: The value '<project>' does not exist for the field 'project'#

오류: The credentials for accessing Jira are not allowed to access the data#

`curl`을 사용하여 Jira 이슈 액세스 확인#

오류: `certificate verify failed`#

오류: `500 We're sorry`#

오류: `An error occurred while requesting data from Jira`#

오류: `The value '<project>' does not exist for the field 'project'`#

오류: `The credentials for accessing Jira are not allowed to access the data`#

`curl`을 사용하여 Jira 이슈 액세스 확인#

오류: `certificate verify failed`#

오류: `500 We're sorry`#

오류: `An error occurred while requesting data from Jira`#

오류: `The value '<project>' does not exist for the field 'project'`#

오류: `The credentials for accessing Jira are not allowed to access the data`#