통합 API

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

이 API를 사용하면 GitLab과 통합되는 외부 서비스와 작업할 수 있습니다.

note
GitLab 14.4에서 services 엔드포인트가 이름이 변경되어 integrations로 변경되었습니다. integrations API에 대한 호출은 /projects/:id/services와 /projects/:id/integrations 양쪽에 할 수 있습니다. 이 문서의 예제는 /projects/:id/integrations 엔드포인트를 참조합니다.

이 API는 Maintainer 또는 Owner 역할을 가진 액세스 토큰이 필요합니다.

모든 활성 통합 디렉터리

  • vulnerability_events 필드는 GitLab Enterprise Edition에서만 사용할 수 있습니다. GitLab 16.4에서 vulnerability_events 필드가 소개되었습니다.

모든 활성 프로젝트 통합 디렉터리을 가져옵니다. 

GET /projects/:id/integrations

예시 응답: 

[
  {
    "id": 75,
    "title": "Jenkins CI",
    "slug": "jenkins",
    "created_at": "2019-11-20T11:20:25.297Z",
    "updated_at": "2019-11-20T12:24:37.498Z",
    "active": true,
    "commit_events": true,
    "push_events": true,
    "issues_events": true,
    "alert_events": true,
    "confidential_issues_events": true,
    "merge_requests_events": true,
    "tag_push_events": false,
    "deployment_events": false,
    "note_events": true,
    "confidential_note_events": true,
    "pipeline_events": true,
    "wiki_page_events": true,
    "job_events": true,
    "comment_on_event_enabled": true,
    "vulnerability_events": true
  },
  {
    "id": 76,
    "title": "Alerts endpoint",
    "slug": "alerts",
    "created_at": "2019-11-20T11:20:25.297Z",
    "updated_at": "2019-11-20T12:24:37.498Z",
    "active": true,
    "commit_events": true,
    "push_events": true,
    "issues_events": true,
    "alert_events": true,
    "confidential_issues_events": true,
    "merge_requests_events": true,
    "tag_push_events": true,
    "deployment_events": false,
    "note_events": true,
    "confidential_note_events": true,
    "pipeline_events": true,
    "wiki_page_events": true,
    "job_events": true,
    "comment_on_event_enabled": true,
    "vulnerability_events": true
  }
]

Apple App Store Connect

Apple App Store Connect 설정

프로젝트를 위해 Apple App Store Connect 통합을 설정합니다. 

PUT /projects/:id/integrations/apple_app_store

매개변수:

매개변수 타입 필수 여부 설명
app_store_issuer_id string true Apple App Store Connect 발행자 ID.
app_store_key_id string true Apple App Store Connect 키 ID.
app_store_private_key_file_name string true Apple App Store Connect 개인 키 파일 이름.
app_store_private_key string true Apple App Store Connect 개인 키.
app_store_protected_refs boolean false 보호된 브랜치 및 태그에만 변수 설정.

Apple App Store Connect 비활성화

프로젝트에서 Apple App Store Connect 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/apple_app_store

Apple App Store Connect 설정 가져오기

프로젝트의 Apple App Store Connect 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/apple_app_store

Asana

Asana 설정

프로젝트를 위해 Asana 통합을 설정합니다. 

PUT /projects/:id/integrations/asana

매개변수:

매개변수 타입 필수 여부 설명
api_key string true 사용자 API 토큰. 사용자는 작업에 액세스해야 합니다. 모든 코멘트는 이 사용자에게 속합니다.
restrict_to_branch string false 자동으로 검사할 브랜치의 쉼표로 구분된 디렉터리. 모든 브랜치를 포함하려면 빈 채로 두십시오.

Asana 비활성화

프로젝트에서 Asana 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/asana

Asana 설정 가져오기

프로젝트의 Asana 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/asana

Assembla

Assembla 설정

프로젝트를 위해 Assembla 통합을 설정합니다. 

PUT /projects/:id/integrations/assembla

매개변수:

매개변수 타입 필수 여부 설명
token string true 인증 토큰.
subdomain string false 서브도메인 설정.

Assembla 비활성화

프로젝트에서 Assembla 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/assembla

Assembla 설정 가져오기

프로젝트의 Assembla 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/assembla

Atlassian Bamboo

Atlassian Bamboo 설정

프로젝트를 위해 Atlassian Bamboo 통합을 설정합니다.

Bamboo에서 자동 리비전 라벨 지정 및 리포지터리 트리거를 구성해야 합니다. 

PUT /projects/:id/integrations/bamboo

매개변수:

매개변수 타입 필수 여부 설명
bamboo_url string true Bamboo 루트 URL (예: https://bamboo.example.com).
enable_ssl_verification boolean false SSL 검증 활성화. 기본값은 true (활성화됨).
build_key string true Bamboo 빌드 계획 키 (예: KEY).
username string true Bamboo 서버에 대한 API 액세스 권한이 있는 사용자.
password string true 사용자의 비밀번호.

Atlassian Bamboo 비활성화

프로젝트를 위해 Atlassian Bamboo 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/bamboo

Atlassian Bamboo 설정 가져오기

프로젝트를 위한 Atlassian Bamboo 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/bamboo

Bugzilla

Bugzilla 설정

프로젝트를 위한 Bugzilla 통합을 설정합니다. 

PUT /projects/:id/integrations/bugzilla

매개변수:

매개변수 타입 필요 여부 설명
new_issue_url string true 새 이슈의 URL.
issues_url string true 이슈의 URL.
project_url string true 프로젝트의 URL.

Bugzilla 비활성화

프로젝트를 위해 Bugzilla 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/bugzilla

Bugzilla 설정 가져오기

프로젝트를 위한 Bugzilla 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/bugzilla

Buildkite

Buildkite 설정

프로젝트를 위한 Buildkite 통합을 설정합니다. 

PUT /projects/:id/integrations/buildkite

매개변수:

매개변수 타입 필요 여부 설명
token string true Buildkite 프로젝트 GitLab 토큰.
project_url string true 파이프라인 URL (예: https://buildkite.com/example/pipeline).
enable_ssl_verification boolean false 사용 중단됨: 이 매개변수는 SSL 확인이 항상 활성화되어 있기 때문에 효과가 없습니다.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.

Buildkite 비활성화

프로젝트를 위해 Buildkite 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/buildkite

Buildkite 설정 가져오기

프로젝트를 위한 Buildkite 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/buildkite

Campfire Classic

Campfire Classic과 통합할 수 있습니다. Campfire Classic은 Basecamp에 의해 더 이상 판매되지 않는 이전 제품입니다.

Campfire Classic 설정

프로젝트를 위한 Campfire Classic 통합을 설정합니다. 

PUT /projects/:id/integrations/campfire

매개변수:

매개변수 타입 필요 여부 설명
token string true Campfire Classic의 API 인증 토큰. 토큰을 얻으려면 Campfire Classic에 로그인한 후 My info를 선택하세요.
subdomain string false 로그인한 경우 .campfirenow.com 서브도메인입니다.
room string false Campfire Classic 룸 URL의 ID 부분입니다.

Campfire Classic 비활성화

프로젝트를 위해 Campfire Classic 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/campfire

Campfire Classic 설정 가져오기

프로젝트를 위한 Campfire Classic 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/campfire

ClickUp

ClickUp 설정

프로젝트를 위한 ClickUp 통합을 설정합니다. 

PUT /projects/:id/integrations/clickup

매개변수:

매개변수 타입 필요 여부 설명
issues_url string true 이슈의 URL
project_url string true 프로젝트의 URL

ClickUp 비활성화

프로젝트를 위해 ClickUp 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/clickup

ClickUp 설정 가져오기

프로젝트를 위한 ClickUp 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/clickup

Confluence Workspace

Confluence Workspace 설정

프로젝트를 위한 Confluence Workspace 통합을 설정합니다. 

PUT /projects/:id/integrations/confluence

매개변수:

매개변수 타입 필요 여부 설명
confluence_url string true atlassian.net에 호스팅된 Confluence Workspace의 URL.

Confluence Workspace 비활성화

프로젝트를 위해 Confluence Workspace 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/confluence

Confluence Workspace 설정 가져오기

프로젝트를 위한 Confluence Workspace 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/confluence

Custom issue tracker

사용자 정의 이슈 추적기 설정

프로젝트를 위한 사용자 정의 이슈 추적기를 설정합니다. 

PUT /projects/:id/integrations/custom-issue-tracker

매개변수:

매개변수 타입 필요 여부 설명
new_issue_url string true 새 이슈의 URL.
issues_url string true 이슈의 URL.
project_url string true 프로젝트의 URL.

사용자 정의 이슈 추적기 비활성화

프로젝트를 위한 사용자 정의 이슈 추적기를 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/custom-issue-tracker

사용자 정의 이슈 추적기 설정 가져오기

프로젝트를 위한 사용자 정의 이슈 추적기 설정을 가져옵니다. 

GET /projects/:id/integrations/custom-issue-tracker

Datadog

Datadog 설정

프로젝트를 위한 Datadog 통합을 설정합니다. 

PUT /projects/:id/integrations/datadog

매개변수:

매개변수 타입 필요 여부 설명
api_key string true Datadog와의 인증에 사용되는 API 키.
api_url string false (고급) Datadog 사이트의 전체 URL입니다.
datadog_env string false Self-managed되는 배포의 경우 Datadog에 보내는 모든 데이터에 대한 env% 태그를 설정합니다.
datadog_service string false Datadog에서 이 GitLab 인스턴스의 모든 데이터에 태그를 지정합니다. 여러 Self-managed 배포를 관리할 때 사용할 수 있습니다.
datadog_site string false 데이터를 보낼 Datadog 사이트입니다. 데이터를 EU 사이트로 보내려면 datadoghq.eu를 사용하세요.
datadog_tags string false Datadog에서 사용자 정의 태그입니다. 형식은 key:value\nkey2:value2의 한 줄에 하나의 태그를 지정합니다 (GitLab 14.8에서 도입).
archive_trace_events boolean false 활성화되면 작업 로그가 Datadog에 의해 수집되고 파이프라인 실행 추적과 함께 표시됩니다 (GitLab 15.3에서 도입).

Datadog 비활성화

프로젝트의 Datadog 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/datadog

Datadog 설정 가져오기

프로젝트의 Datadog 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/datadog

Diffblue Cover

Diffblue Cover 설정

프로젝트의 Diffblue Cover 통합을 설정합니다. 

PUT /projects/:id/integrations/diffblue-cover

매개변수:

매개변수 유형 필요 여부 설명
diffblue_license_key 문자열 true Diffblue Cover 라이선스 키입니다.
diffblue_access_token_name 문자열 true 파이프라인에서 Diffblue Cover가 사용하는 액세스 토큰 이름입니다.
diffblue_access_token_secret 문자열 true 파이프라인에서 Diffblue Cover가 사용하는 액세스 토큰 비밀입니다.

Diffblue Cover 비활성화

프로젝트의 Diffblue Cover 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/diffblue-cover

Diffblue Cover 설정 가져오기

프로젝트의 Diffblue Cover 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/diffblue-cover

Discord 알림

Discord 알림 설정

프로젝트에 Discord 알림을 설정합니다. 

PUT /projects/:id/integrations/discord

매개변수:

매개변수 유형 필요 여부 설명
webhook 문자열 true Discord 웹훅입니다(예: https://discord.com/api/webhooks/...).
branches_to_be_notified 문자열 false 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
confidential_issues_events 부울 false 비밀 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_issue_channel 문자열 false 비밀 이슈 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
confidential_note_events 부울 false 비밀 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_channel 문자열 false 비밀 노트 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
deployment_events 부울 false 배포 이벤트에 대한 알림을 활성화합니다.
deployment_channel 문자열 false 배포 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
group_confidential_mentions_events 부울 false 그룹 비밀 메이션 이벤트에 대한 알림을 활성화합니다.
group_confidential_mentions_channel 문자열 false 그룹 비밀 메이션 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
group_mentions_events 부울 false 그룹 멘션 이벤트에 대한 알림을 활성화합니다.
group_mentions_channel 문자열 false 그룹 멘션 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
issues_events 부울 false 이슈 이벤트에 대한 알림을 활성화합니다.
issue_channel 문자열 false 이슈 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
merge_requests_events 부울 false Merge Request 이벤트에 대한 알림을 활성화합니다.
merge_request_channel 문자열 false Merge Request 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
note_events 부울 false 노트 이벤트에 대한 알림을 활성화합니다.
note_channel 문자열 false 노트 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
notify_only_broken_pipelines 부울 false 실패한 파이프라인에 대한 알림을 보냅니다.
pipeline_events 부울 false 파이프라인 이벤트에 대한 알림을 활성화합니다.
pipeline_channel 문자열 false 파이프라인 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
push_events 부울 false 푸시 이벤트에 대한 알림을 활성화합니다.
push_channel 문자열 false 푸시 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
tag_push_events 부울 false 태그 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_channel 문자열 false 태그 푸시 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.
wiki_page_events 부울 false 위키 페이지 이벤트에 대한 알림을 활성화합니다.
wiki_page_channel 문자열 false 위키 페이지 이벤트에 대한 알림을 받을 웹훅을 재정의합니다.

Discord 알림 비활성화

프로젝트의 Discord 알림을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/discord

Discord 알림 설정 가져오기

프로젝트의 Discord 알림 설정을 가져옵니다. 

GET /projects/:id/integrations/discord

Drone

Drone 설정

프로젝트의 Drone 통합을 설정합니다. 

PUT /projects/:id/integrations/drone-ci

매개변수:

매개변수 유형 필요 여부 설명
token 문자열 true 해당 Drone CI 프로젝트의 토큰입니다.
drone_url 문자열 true http://drone.example.com.
enable_ssl_verification 부울 false SSL 검증을 활성화합니다. 기본값은 true(활성화됨)입니다.
push_events 부울 false 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events 부울 false Merge Request 이벤트에 대한 알림을 활성화합니다.
tag_push_events 부울 false 태그 푸시 이벤트에 대한 알림을 활성화합니다.

Drone 비활성화

프로젝트의 Drone 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/drone-ci

Drone 설정 가져오기

프로젝트의 Drone 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/drone-ci

푸시 이메일

푸시 이메일 설정

프로젝트의 푸시 이메일 통합을 설정합니다. 

PUT /projects/:id/integrations/emails-on-push

매개변수:

매개변수 유형 필요 여부 설명
recipients 문자열 true 공백으로 구분된 이메일입니다.
disable_diffs 부울 false 코드 차이를 비활성화합니다.
send_from_committer_email 부울 false 커밋터에서 보내기를 활성화합니다.
push_events 부울 false 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_events 부울 false 태그 푸시 이벤트에 대한 알림을 활성화합니다.
branches_to_be_notified 문자열 false 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 알림은 항상 태그 푸시에 대해 발생합니다. 기본값은 all입니다.

Push 시 이메일 비활성화

프로젝트에서 이메일 푸시 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/emails-on-push

Push 이메일 설정 가져오기

프로젝트의 이메일 푸시 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/emails-on-push

엔지니어링 워크플로우 관리 (EWM)

EWM 설정

프로젝트에 EWM 통합을 설정합니다. 

PUT /projects/:id/integrations/ewm

매개변수:

매개변수 유형 필수 여부 설명
new_issue_url string true 새 이슈의 URL
project_url string true 프로젝트의 URL
issues_url string true 이슈의 URL

EWM 비활성화

프로젝트에서 EWM 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/ewm

EWM 설정 가져오기

프로젝트의 EWM 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/ewm

외부 위키

외부 위키 설정

프로젝트에 외부 위키를 설정합니다. 

PUT /projects/:id/integrations/external-wiki

매개변수:

매개변수 유형 필수 여부 설명
external_wiki_url string true 외부 위키의 URL

외부 위키 비활성화

프로젝트에서 외부 위키를 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/external-wiki

외부 위키 설정 가져오기

프로젝트의 외부 위키 설정을 가져옵니다. 

GET /projects/:id/integrations/external-wiki

GitGuardian

상세 정보: Tier: Premium, Ultimate Offering: Self-managed, GitLab Dedicated

Self-managed GitLab의 경우, 기본적으로 이 기능을 사용할 수 있습니다. 기능을 숨기려면 관리자에게 피처 플래그를 비활성화할 것을 요청하십시오. GitLab.com의 경우 이 기능은 사용할 수 없습니다. GitLab Dedicated의 경우 이 기능을 사용할 수 있습니다.

GitGuardian는 API 키나 암호와 같은 민감한 데이터를 탐지하는 사이버 보안 서비스입니다. Git 리포지터리를 스캔하여 정책 위반에 대한 경고를 제공하고, 해커가 그것을 악용하기 전에 기관이 보안 문제를 해결할 수 있도록 돕습니다.

GitGuardian 정책에 기반하여 커밋을 거절하도록 GitLab을 구성할 수 있습니다.

알려진 문제

  • 푸시가 지연되거나 타임아웃 될 수 있습니다. GitGuardian 통합으로 인해 푸시가 제3자에게 전송되며, GitLab은 GitGuardian과의 연결 또는 GitGuardian 프로세스에 대해 제어할 수 없습니다.
  • GitGuardian API 제한으로 인해 1 MB를 초과하는 파일은 무시됩니다. 이들은 스캔되지 않습니다.
  • 푸시된 파일의 이름이 256자를 초과하면 푸시가 이루어지지 않습니다. 자세한 내용은 GitGuardian API 문서를 참조하십시오.

통합 페이지의 문제 해결 단계에서 이러한 일부 문제를 완화하는 방법을 보여줍니다.

GitGuardian 설정

프로젝트에 GitGuardian 통합을 설정합니다. 

PUT /projects/:id/integrations/git-guardian

매개변수:

매개변수 유형 필수 여부 설명
token string true scan 범위를 갖는 GitGuardian API 토큰

GitGuardian 비활성화

프로젝트에서 GitGuardian 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/git-guardian

GitGuardian 설정 가져오기

프로젝트의 GitGuardian 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/git-guardian

GitHub

상세 정보: Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitHub 설정

프로젝트에 GitHub 통합을 설정합니다. 

PUT /projects/:id/integrations/github

매개변수:

매개변수 유형 필수 여부 설명
token string true repo:status OAuth 스코프를 가진 GitHub API 토큰
repository_url string true GitHub 리포지터리 URL
static_context boolean false 상태 확인 이름에 GitLab 인스턴스의 호스트 이름을 추가합니다.

GitHub 비활성화

프로젝트에서 GitHub 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

DELETE /projects/:id/integrations/github

GitHub 설정 가져오기

프로젝트의 GitHub 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/github

GitLab for Slack 앱

GitLab for Slack 앱 설정

프로젝트에 GitLab for Slack 앱 통합을 업데이트합니다.

GitLab for Slack 앱을 생성할 수 없으며 반드시 GitLab UI에서 앱을 설치해야 합니다. 

PUT /projects/:id/integrations/gitlab-slack-application

매개변수:

매개변수 유형 필수 여부 설명
channel string false 구성된 채널이 없는 경우 기본 채널입니다.
notify_only_broken_pipelines boolean false 끊긴 파이프라인에 대한 알림 보냄
notify_only_default_branch boolean false 사용되지 않음: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string false 알림을 보낼 브랜치입니다. all, default, protected, default_and_protected이 유효한 옵션입니다. 기본값은 default입니다.
alert_events boolean false 경보 이벤트에 대한 알림 활성화
issues_events boolean false 이슈 이벤트에 대한 알림 활성화
confidential_issues_events boolean false 기밀 이슈 이벤트에 대한 알림 활성화
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화
note_events boolean false 노트 이벤트에 대한 알림 활성화
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림 활성화
deployment_events boolean false 배포 이벤트에 대한 알림 활성화
incidents_events boolean false 사건 이벤트에 대한 알림 활성화
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화
push_events boolean false 푸시 이벤트에 대한 알림 활성화
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화
vulnerability_events boolean false 취약점 이벤트에 대한 알림 활성화
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화

Slack 앱을 비활성화합니다.

프로젝트의 GitLab for Slack 앱 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/gitlab-slack-application

Slack 앱 설정 가져오기

프로젝트의 GitLab for Slack 앱 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/gitlab-slack-application

Google Chat

Google Chat 설정하기

프로젝트에 Google Chat 통합을 설정합니다. 

PUT /projects/:id/integrations/hangouts-chat

매개변수:

매개변수 유형 필수 설명
webhook string true Hangouts Chat 웹훅 (예: https://chat.googleapis.com/v1/spaces...).
notify_only_broken_pipelines boolean false 실패한 파이프라인에 대한 알림을 보냅니다.
notify_only_default_branch boolean false 사용되지 않음: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string false 알림을 보낼 브랜치입니다. all, default, protected, default_and_protected 중 선택할 수 있습니다. 기본값은 default입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
issues_events boolean false 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_issues_events boolean false 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean false 머지 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림을 활성화합니다.
note_events boolean false 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림을 활성화합니다.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림을 활성화합니다.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림을 활성화합니다.

Google Chat 비활성화

프로젝트의 Google Chat 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/hangouts-chat

Google Chat 설정 가져오기

프로젝트의 Google Chat 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/hangouts-chat

Google Artifact Registry

Offering: GitLab.com Status: Beta
  • GitLab 16.9에서 Beta 기능으로 도입되었습니다. google_cloud_support_feature_flag라는 플래그와 함께 기본적으로 비활성화됩니다.

플래그: GitLab.com에서 이 기능은 사용할 수 없습니다. 이 기능은 프로덕션 환경에 사용할 준비가되지 않았습니다.

Google Artifact Registry 설정하기

프로젝트에 Google Artifact Registry 통합을 설정합니다. 

PUT /projects/:id/integrations/google-cloud-platform-artifact-registry

매개변수:

매개변수 유형 필수 설명
artifact_registry_project_id string true Google Cloud 프로젝트 ID입니다.
artifact_registry_location string true Artifact Registry 리포지터리의 위치입니다.
artifact_registry_repositories string true Artifact Registry 리포지터리입니다.

Google Artifact Registry 비활성화

프로젝트의 Google Artifact Registry 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/google-cloud-platform-artifact-registry

Google Artifact Registry 설정 가져오기

프로젝트의 Google Artifact Registry 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/google-cloud-platform-artifact-registry

Google Cloud Identity 및 Access Management (IAM)

  • GitLab 16.10에서 Beta 기능으로 도입되었습니다. google_cloud_support_feature_flag라는 플래그와 함께 기본적으로 비활성화됩니다.

플래그: GitLab.com에서 이 기능은 사용할 수 없습니다. 이 기능은 프로덕션 환경에 사용할 준비가되지 않았습니다.

Google Cloud Identity 및 Access Management 설정하기

프로젝트에 Google Cloud Identity 및 Access Management 통합을 설정합니다. 

PUT /projects/:id/integrations/google-cloud-platform-workload-identity-federation

매개변수:

매개변수 유형 필수 설명
workload_identity_federation_project_id string true Workload Identity Federation의 Google Cloud 프로젝트 ID입니다.
workload_identity_federation_project_number integer true Workload Identity Federation의 Google Cloud 프로젝트 번호입니다.
workload_identity_pool_id string true Workload Identity Pool의 ID입니다.
workload_identity_pool_provider_id string true Workload Identity Pool 제공자의 ID입니다.

Google Cloud Identity 및 Access Management 비활성화

프로젝트의 Google Cloud Identity 및 Access Management 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/google-cloud-platform-workload-identity-federation

Google Cloud Identity 및 Access Management 설정 가져오기

프로젝트의 Google Cloud Identity 및 Access Management 설정을 가져옵니다. 

GET /projects/:id/integration/google-cloud-platform-workload-identity-federation

Google Play

Google Play 설정하기

프로젝트에 Google Play 통합을 설정합니다. 

PUT /projects/:id/integrations/google-play

매개변수:

매개변수 유형 필수 설명
package_name string true Google Play의 앱 패키지 이름입니다.
service_account_key string true Google Play 서비스 계정 키입니다.
service_account_key_file_name string true Google Play 서비스 계정 키의 파일 이름입니다.
google_play_protected_refs boolean false 보호된 브랜치 및 태그에만 변수를 설정합니다.

Google Play 비활성화

프로젝트의 Google Play 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/google-play

Google Play 설정 가져오기

프로젝트의 Google Play 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/google-play

Harbor

Harbor 설정

프로젝트를 위한 Harbor 통합 설정. 

PUT /projects/:id/integrations/harbor

매개변수:

매개변수 타입 필수 설명
url string true GitLab 프로젝트에 연결된 Harbor 인스턴스의 기본 URL입니다. 예: https://demo.goharbor.io.
project_name string true Harbor 인스턴스의 프로젝트 이름입니다. 예: testproject.
username string true Harbor 인터페이스에서 생성된 사용자 이름입니다.
password string true 사용자의 암호입니다.

Harbor 비활성화

프로젝트의 Harbor 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/harbor

Harbor 설정 가져오기

프로젝트의 Harbor 통합 설정 가져오기. 

GET /projects/:id/integrations/harbor

irker (IRC 게이트웨이)

irker 설정

프로젝트를 위한 irker 통합 설정. 

PUT /projects/:id/integrations/irker

매개변수:

매개변수 타입 필수 설명
recipients string true 공백으로 구분된 수신자 또는 채널입니다.
default_irc_uri string false irc://irc.network.net:6697/.
server_host string false localhost.
server_port integer false 6659.
colorize_messages boolean false 메시지에 칼라를 입힙니다.

irker 비활성화

프로젝트의 irker 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/irker

irker 설정 가져오기

프로젝트의 irker 통합 설정 가져오기. 

GET /projects/:id/integrations/irker

Jenkins

Jenkins 설정

프로젝트를 위한 Jenkins 통합 설정. 

PUT /projects/:id/integrations/jenkins

매개변수:

매개변수 타입 필수 설명
jenkins_url string true http://jenkins.example.com과 같은 Jenkins URL입니다.
enable_ssl_verification boolean false SSL 확인 기능을 활성화합니다. 기본적으로 true (활성화됨).
project_name string true URL 친화적 프로젝트 이름. 예: my_project_name.
username string false 서버에서 인증이 필요한 경우 Jenkins 서버와의 인증을 위한 사용자 이름입니다.
password string false 서버에서 인증이 필요한 경우 Jenkins 서버와의 인증을 위한 암호입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림을 활성화합니다.

Jenkins 비활성화

프로젝트의 Jenkins 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/jenkins

Jenkins 설정 가져오기

프로젝트의 Jenkins 통합 설정 가져오기. 

GET /projects/:id/integrations/jenkins

JetBrains TeamCity

JetBrains TeamCity 설정

프로젝트를 위한 JetBrains TeamCity 통합 설정.

TeamCity의 빌드 구성은 빌드 번호 형식 %build.vcs.number%을 사용해야 합니다. 모든 브랜치의 모니터링을 VCS 루트의 고급 설정에서 구성하여 Merge Request에 대한 빌드가 가능하도록 합니다. 

PUT /projects/:id/integrations/teamcity

매개변수:

매개변수 타입 필수 설명
teamcity_url string true TeamCity 루트 URL (예: https://teamcity.example.com).
enable_ssl_verification boolean false SSL 확인 기능을 활성화합니다. 기본적으로 true (활성화됨).
build_type string true 빌드 구성 ID.
username string true 매뉴얼 빌드를 트리거할 권한이 있는 사용자입니다.
password string true 사용자의 암호입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림을 활성화합니다.

JetBrains TeamCity 비활성화

프로젝트의 JetBrains TeamCity 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/teamcity

JetBrains TeamCity 설정 가져오기

프로젝트의 JetBrains TeamCity 통합 설정 가져오기. 

GET /projects/:id/integrations/teamcity

Jira

Jira 설정

프로젝트를 위한 Jira 통합 설정. 

PUT /projects/:id/integrations/jira

매개변수:

매개변수 타입 필수 설명
url string yes 이 GitLab 프로젝트에 연결되는 Jira 프로젝트의 URL입니다 (예: https://jira.example.com).
api_url string no Jira 인스턴스 API의 기본 URL입니다. 설정되지 않은 경우 Web URL 값이 사용됩니다 (예: https://jira-api.example.com).
username string no Jira에서 사용될 이메일 또는 사용자 이름입니다. Jira 클라우드의 경우 이메일을, Jira 데이터 센터 및 Jira 서버의 경우 사용자 이름을 사용하세요. Basic 인증을 사용하는 경우 필요합니다 (jira_auth_type이 0인 경우).
password string yes Jira와 사용될 API 토큰, 비밀번호 또는 개인 액세스 토큰입니다. 인증 방법이 Basic인 경우 Jira 클라우드의 경우 API 토큰 또는 Jira 데이터 센터 또는 Jira 서버의 경우 비밀번호를 사용하세요. 인증 방법이 Jira 개인 액세스 토큰인 경우 개인 액세스 토큰을 사용하세요 (jira_auth_type이 1인 경우).
active boolean no 통합을 활성화 또는 비활성화합니다. 기본값은 false (비활성화됨).
jira_auth_type integer no Jira와 사용될 인증 방법입니다. 0은 기본 인증을 의미합니다. 1은 Jira 개인 액세스 토큰을 의미합니다. 기본값은 0입니다.
jira_issue_prefix string no 일치하는 Jira 이슈 키의 접두사입니다.
jira_issue_regex string no Jira 이슈 키와 일치하는 정규 표현식입니다.
jira_issue_transition_automatic boolean no 자동 이슈 전환을 활성화합니다. 활성화된 경우 jira_issue_transition_id보다 우선합니다. 기본값은 false입니다.
jira_issue_transition_id string no 사용자 정의 이슈 전환을 위한 하나 이상의 전환 ID입니다. jira_issue_transition_automatic이 활성화된 경우 무시됩니다. 사용자 정의 전환을 비활성화하려면 빈 문자열을 기본값으로 설정합니다.
commit_events boolean false 커밋 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림을 활성화합니다.
comment_on_event_enabled boolean false 각 GitLab 이벤트(커밋 또는 Merge Request)에서 Jira 이슈에 댓글을 활성화합니다.

Jira 비활성화

프로젝트의 Jira 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/jira

Jira 설정 가져오기

프로젝트의 Jira 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/jira

Mattermost 알림

Mattermost 알림 설정

프로젝트를 위해 Mattermost 알림을 설정합니다. 

PUT /projects/:id/integrations/mattermost

매개변수:

매개변수 유형 필요 여부 설명
webhook string true Mattermost 알림 웹훅 (예: http://mattermost.example.com/hooks/...).
username string false Mattermost 알림 사용자 이름.
channel string false 다른 채널이 구성되지 않은 경우 사용할 기본 채널.
notify_only_broken_pipelines boolean false 손상된 파이프라인에 대한 알림 전송.
notify_only_default_branch boolean false 사용되지 않음: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string false 알림을 보낼 브랜치. all, default, protected, default_and_protected 중 유효한 옵션이며, 기본값은 default입니다.
labels_to_be_notified string false 알림을 받을 라벨. 모든 이벤트에 대한 알림을 받으려면 공란으로 둡니다.
labels_to_be_notified_behavior string false 알림을 받을 라벨. match_any와 match_all 중 유효한 옵션이며, 기본값은 match_any입니다.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
issues_events boolean false 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean false 비밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean false 통합 요청 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 비밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.
push_channel string false 푸시 이벤트에 대한 알림 수신 채널 이름.
issue_channel string false 이슈 이벤트에 대한 알림 수신 채널 이름.
confidential_issue_channel string false 비밀 이슈 이벤트에 대한 알림 수신 채널 이름.
merge_request_channel string false 통합 요청 이벤트에 대한 알림 수신 채널 이름.
note_channel string false 노트 이벤트에 대한 알림 수신 채널 이름.
confidential_note_channel string false 비밀 노트 이벤트에 대한 알림 수신 채널 이름.
tag_push_channel string false 태그 푸시 이벤트에 대한 알림 수신 채널 이름.
pipeline_channel string false 파이프라인 이벤트에 대한 알림 수신 채널 이름.
wiki_page_channel string false 위키 페이지 이벤트에 대한 알림 수신 채널 이름.

Mattermost 알림 비활성화

프로젝트의 Mattermost 알림을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/mattermost

Mattermost 알림 설정 가져오기

프로젝트의 Mattermost 알림 설정을 가져옵니다. 

GET /projects/:id/integrations/mattermost

Mattermost 슬래시 명령

Mattermost 슬래시 명령 설정

프로젝트를 위해 Mattermost 슬래시 명령을 설정합니다. 

PUT /projects/:id/integrations/mattermost-slash-commands

매개변수:

매개변수 유형 필요 여부 설명
token string yes Mattermost 토큰.

Mattermost 슬래시 명령 비활성화

프로젝트의 Mattermost 슬래시 명령을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/mattermost-slash-commands

Mattermost 슬래시 명령 설정 가져오기

프로젝트의 Mattermost 슬래시 명령 설정을 가져옵니다. 

GET /projects/:id/integrations/mattermost-slash-commands

Microsoft Teams 알림

Microsoft Teams 알림 설정

프로젝트를 위해 Microsoft Teams 알림을 설정합니다. 

PUT /projects/:id/integrations/microsoft-teams

매개변수:

매개변수 유형 필요 여부 설명
webhook string true Microsoft Teams 웹훅 (예: https://outlook.office.com/webhook/...).
notify_only_broken_pipelines boolean false 손상된 파이프라인에 대한 알림 전송.
notify_only_default_branch boolean false 사용되지 않음: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string false 알림을 보낼 브랜치. all, default, protected, default_and_protected 중 유효한 옵션이며, 기본값은 default입니다.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
issues_events boolean false 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean false 비밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean false 통합 요청 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 비밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.

Microsoft Teams 알림 비활성화

프로젝트의 Microsoft Teams 알림을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/microsoft-teams

Microsoft Teams 알림 설정 가져오기

프로젝트의 Microsoft Teams 알림 설정 가져오기. 

GET /projects/:id/integrations/microsoft-teams

Mock CI

이 통합은 개발 환경에서만 사용할 수 있습니다. 예제 Mock CI 서버는 gitlab-org/gitlab-mock-ci-service를 참조하세요.

Mock CI 설정

프로젝트의 Mock CI 통합 설정하기. 

PUT /projects/:id/integrations/mock-ci

매개변수:

매개변수 유형 필요여부 설명
mock_service_url string true Mock CI 통합의 URL.
enable_ssl_verification boolean false SSL 확인 활성화. 기본값은 true(활성화됨).

Mock CI 비활성화

프로젝트의 Mock CI 통합 비활성화. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/mock-ci

Mock CI 설정 가져오기

프로젝트의 Mock CI 통합 설정 가져오기. 

GET /projects/:id/integrations/mock-ci

Packagist

Packagist 설정

프로젝트의 Packagist 통합 설정하기. 

PUT /projects/:id/integrations/packagist

매개변수:

매개변수 유형 필요여부 설명
username string yes Packagist 계정의 사용자 이름.
token string yes Packagist 서버의 API 토큰.
server boolean no Packagist 서버의 URL. 기본값은 <https://packagist.org>입니다.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.

Packagist 비활성화

프로젝트의 Packagist 통합 비활성화. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/packagist

Packagist 설정 가져오기

프로젝트의 Packagist 통합 설정 가져오기. 

GET /projects/:id/integrations/packagist

파이프라인 상태 이메일

파이프라인 상태 이메일 설정

프로젝트의 파이프라인 상태 이메일 설정하기. 

PUT /projects/:id/integrations/pipelines-email

매개변수:

매개변수 유형 필요여부 설명
recipients string yes 수신자 이메일 주소의 쉼표로 구분된 디렉터리.
notify_only_broken_pipelines boolean no 오류가 있는 파이프라인에 대한 알림 보내기.
branches_to_be_notified string false 알림을 보낼 브랜치. all, default, protected, default_and_protected가 유효한 옵션입니다. 기본값은 default입니다.
notify_only_default_branch boolean no 기본 브랜치에 대한 알림 보내기.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.

파이프라인 상태 이메일 비활성화

프로젝트의 파이프라인 상태 이메일 비활성화. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/pipelines-email

파이프라인 상태 이메일 설정 가져오기

프로젝트의 파이프라인 상태 이메일 설정 가져오기. 

GET /projects/:id/integrations/pipelines-email

Pivotal Tracker

Pivotal Tracker 설정

프로젝트의 Pivotal Tracker 통합 설정하기. 

PUT /projects/:id/integrations/pivotaltracker

매개변수:

매개변수 유형 필요여부 설명
token string true Pivotal Tracker 토큰.
restrict_to_branch boolean false 자동으로 검사할 브랜치의 쉼표로 구분된 디렉터리. 모든 브랜치를 포함하려면 비워두세요.

Pivotal Tracker 비활성화

프로젝트의 Pivotal Tracker 통합 비활성화. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/pivotaltracker

Pivotal Tracker 설정 가져오기

프로젝트의 Pivotal Tracker 통합 설정 가져오기. 

GET /projects/:id/integrations/pivotaltracker

Pumble

Pumble 설정

프로젝트의 Pumble 통합 설정하기. 

PUT /projects/:id/integrations/pumble

매개변수:

매개변수 유형 필요여부 설명
webhook string true Pumble 웹훅(예: https://api.pumble.com/workspaces/x/...).
branches_to_be_notified string false 알림을 보낼 브랜치. all, default, protected, default_and_protected가 유효한 옵션입니다. 기본값은 default입니다.
confidential_issues_events boolean false 기밀 이슈 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림 활성화.
issues_events boolean false 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
notify_only_broken_pipelines boolean false 오류가 있는 파이프라인에 대한 알림 보내기.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.

Pumble 비활성화

프로젝트의 Pumble 통합 비활성화. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/pumble

Pumble 설정 가져오기

프로젝트의 Pumble 통합 설정 가져오기. 

GET /projects/:id/integrations/pumble

Pushover

Pushover 설정

프로젝트의 Pushover 통합 설정하기. 

PUT /projects/:id/integrations/pushover

매개변수:

매개변수 유형 필요여부 설명
api_key string true 사용자 응용 프로그램 키.
user_key string true 사용자 키.
priority string true 우선순위.
device string false 모든 활성 장치에 대해 비워두세요.
sound string false 알림음.

Pushover 비활성화

프로젝트의 Pushover 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/pushover

Pushover 설정 가져오기

프로젝트의 Pushover 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/pushover

Redmine

Redmine 설정

프로젝트의 Redmine 통합을 설정합니다. 

PUT /projects/:id/integrations/redmine

매개변수:

매개변수 유형 필요 여부 설명
new_issue_url string true 새 이슈의 URL입니다.
project_url string true 프로젝트의 URL입니다.
issues_url string true 이슈의 URL입니다.

Redmine 비활성화

프로젝트의 Redmine 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/redmine

Redmine 설정 가져오기

프로젝트의 Redmine 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/redmine

Slack 알림

Slack 알림 설정

프로젝트의 Slack 알림을 설정합니다. 

PUT /projects/:id/integrations/slack

매개변수:

매개변수 유형 필요 여부 설명
webhook string true Slack 알림 웹훅입니다 (예: https://hooks.slack.com/services/...).
username string false Slack 알림 사용자 이름입니다.
channel string false 구성된 채널이 없는 경우 사용할 기본 채널입니다.
notify_only_broken_pipelines boolean false 실패한 파이프라인에 대한 알림을 보냅니다.
notify_only_default_branch boolean false 사용 중지됨: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string false 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
labels_to_be_notified string false 알림을 받을 라벨입니다. 모든 이벤트에 대해 알림을 받으려면 비워두세요.
labels_to_be_notified_behavior string false 알림을 받을 라벨입니다. 유효한 옵션은 match_any와 match_all입니다. 기본값은 match_any입니다.
alert_channel string false 경고 이벤트를 위해 알림을 받을 채널 이름입니다.
alert_events boolean false 경고 이벤트에 대한 알림을 활성화합니다.
commit_events boolean false 커밋 이벤트에 대한 알림을 활성화합니다.
confidential_issue_channel string false 기밀 이슈 이벤트를 위해 알림을 받을 채널 이름입니다.
confidential_issues_events boolean false 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_note_channel string false 기밀 노트 이벤트를 위해 알림을 받을 채널 이름입니다.
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림을 활성화합니다.
deployment_channel string false 배포 이벤트를 위해 알림을 받을 채널 이름입니다.
deployment_events boolean false 배포 이벤트에 대한 알림을 활성화합니다.
incident_channel string false 사건 이벤트를 위해 알림을 받을 채널 이름입니다.
incidents_events boolean false 사건 이벤트에 대한 알림을 활성화합니다.
issue_channel string false 이슈 이벤트를 위해 알림을 받을 채널 이름입니다.
issues_events boolean false 이슈 이벤트에 대한 알림을 활성화합니다.
job_events boolean false 작업 이벤트에 대한 알림을 활성화합니다.
merge_request_channel string false Merge Request 이벤트를 위해 알림을 받을 채널 이름입니다.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림을 활성화합니다.
note_channel string false 노트 이벤트를 위해 알림을 받을 채널 이름입니다.
note_events boolean false 노트 이벤트에 대한 알림을 활성화합니다.
pipeline_channel string false 파이프라인 이벤트를 위해 알림을 받을 채널 이름입니다.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림을 활성화합니다.
push_channel string false 푸시 이벤트를 위해 알림을 받을 채널 이름입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_channel string false 태그 푸시 이벤트를 위해 알림을 받을 채널 이름입니다.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림을 활성화합니다.
wiki_page_channel string false 위키 페이지 이벤트를 위해 알림을 받을 채널 이름입니다.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림을 활성화합니다.

Slack 알림 비활성화

프로젝트의 Slack 알림을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/slack

Slack 알림 설정 가져오기

프로젝트의 Slack 알림 설정을 가져옵니다. 

GET /projects/:id/integrations/slack

Slack 슬래시 명령

Slack 슬래시 명령 설정

프로젝트의 Slack 슬래시 명령을 설정합니다. 

PUT /projects/:id/integrations/slack-slash-commands

매개변수:

매개변수 유형 필요 여부 설명
token string yes Slack 토큰입니다.

Slack 슬래시 명령 비활성화

프로젝트의 Slack 슬래시 명령을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/slack-slash-commands

Slack 슬래시 명령 설정 가져오기

프로젝트의 Slack 슬래시 명령 설정을 가져옵니다. 

GET /projects/:id/integrations/slack-slash-commands

예시 응답: 

{
  "id": 4,
  "title": "Slack 슬래시 명령",
  "slug": "slack-slash-commands",
  "created_at": "2017-06-27T05:51:39-07:00",
  "updated_at": "2017-06-27T05:51:39-07:00",
  "active": true,
  "push_events": true,
  "issues_events": true,
  "confidential_issues_events": true,
  "merge_requests_events": true,
  "tag_push_events": true,
  "note_events": true,
  "job_events": true,
  "pipeline_events": true,
  "comment_on_event_enabled": false,
  "properties": {
    "token": "<your_access_token>"
  }
}

Squash TM

Squash TM 설정

프로젝트에 대해 Squash TM 통합 설정을 구성합니다. 

PUT /projects/:id/integrations/squash-tm

매개변수:

매개변수 유형 필수 설명
url string yes Squash TM 웹훅의 URL.
token string no 비밀 토큰.

Squash TM 비활성화

프로젝트의 Squash TM 통합을 비활성화합니다. 통합 설정은 보존됩니다. 

DELETE /projects/:id/integrations/squash-tm

Squash TM 설정 가져오기

프로젝트의 Squash TM 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/squash-tm

텔레그램

텔레그램 설정

프로젝트에 대해 텔레그램 통합을 설정합니다. 

PUT /projects/:id/integrations/telegram

매개변수:

매개변수 유형 필수 설명
token string true 텔레그램 봇 토큰 (예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).
room string true 대상 채팅의 고유 식별자 또는 대상 채널의 사용자 이름 (예: @channelusername 형식).
notify_only_broken_pipelines boolean false 실패한 파이프라인에 대한 알림 보내기.
branches_to_be_notified string false 알림을 보낼 브랜치들 (소개됨 in GitLab 16.5). 유효한 옵션은 all, default, protected, default_and_protected 입니다. 기본값은 default.
push_events boolean true 푸시 이벤트에 대한 알림 활성화.
issues_events boolean true 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean true 비밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean true Merge Request 이벤트에 대한 알림 활성화.
tag_push_events boolean true 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean true 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean true 비밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean true 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean true 위키 페이지 이벤트에 대한 알림 활성화.

텔레그램 비활성화

프로젝트의 텔레그램 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/telegram

텔레그램 설정 가져오기

프로젝트의 텔레그램 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/telegram

Unify Circuit

Unify Circuit 설정

프로젝트에 대해 Unify Circuit 통합을 설정합니다. 

PUT /projects/:id/integrations/unify-circuit

매개변수:

매개변수 유형 필수 설명
webhook string true Unify Circuit 웹훅 (예: https://circuit.com/rest/v2/webhooks/incoming/...).
notify_only_broken_pipelines boolean false 실패한 파이프라인에 대한 알림 보내기.
branches_to_be_notified string false 알림을 보낼 브랜치들. 유효한 옵션은 all, default, protected, default_and_protected 입니다. 기본값은 default.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
issues_events boolean false 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean false 비밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 비밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.

Unify Circuit 비활성화

프로젝트의 Unify Circuit 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/unify-circuit

Unify Circuit 설정 가져오기

프로젝트의 Unify Circuit 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/unify-circuit

Webex Teams

Webex Teams 설정

프로젝트에 대해 Webex Teams 통합을 설정합니다. 

PUT /projects/:id/integrations/webex-teams

매개변수:

매개변수 유형 필수 설명
webhook string true Webex Teams 웹훅 (예: https://api.ciscospark.com/v1/webhooks/incoming/...).
notify_only_broken_pipelines boolean false 실패한 파이프라인에 대한 알림 보내기.
branches_to_be_notified string false 알림을 보낼 브랜치들. 유효한 옵션은 all, default, protected, default_and_protected 입니다. 기본값은 default.
push_events boolean false 푸시 이벤트에 대한 알림 활성화.
issues_events boolean false 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean false 비밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean false Merge Request 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 비밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.

웹엑스 팀 비활성화

프로젝트의 웹엑스 팀을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/webex-teams

웹엑스 팀 설정 가져오기

프로젝트의 웹엑스 팀 설정을 가져옵니다. 

GET /projects/:id/integrations/webex-teams

유트랙

유트랙 설정하기

프로젝트용으로 유트랙 통합을 설정합니다. 

PUT /projects/:id/integrations/youtrack

매개변수:

매개변수 유형 필수 설명
issues_url string true 이슈의 URL입니다.
project_url string true 프로젝트의 URL입니다.

유트랙 비활성화

프로젝트의 유트랙 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/youtrack

유트랙 설정 가져오기

프로젝트의 유트랙 통합 설정을 가져옵니다. 

GET /projects/:id/integrations/youtrack