통합 API

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

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

:::Note GitLab 14.4에서 services 엔드포인트가 이름이 변경되어 integrations로 변경되었습니다. 통합 API 호출은 /projects/:id/services/projects/:id/integrations 모두에 대해 이루어질 수 있습니다. 이 문서의 예시는 /projects/:id/integrations 엔드포인트를 가리킵니다. :::

이 API를 사용하려면 Maintainer 또는 Owner 역할이 있는 액세스 토큰이 필요합니다.

모든 활성 통합 목록

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

모든 활성 프로젝트 통합 목록을 가져옵니다. vulnerability_events 필드는 GitLab Enterprise Edition에서만 사용할 수 있습니다.

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 통합 설정.

Atlassian 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 병합 요청 이벤트에 대한 알림 활성화 여부입니다.
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은 이제 더 이상 판매되지 않는 구형 제품입니다.

Campfire Classic 설정

프로젝트에 대한 Campfire Classic 통합 설정.

PUT /projects/:id/integrations/campfire

매개변수:

매개변수 유형 필수 설명
token string true Campfire Classic의 API 인증 토큰입니다. 토큰을 받으려면 Campfire Classic에 로그인하고 내 정보를 선택합니다.
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

사용자 정의 이슈 트래커

사용자 정의 이슈 트래커 설정하기

프로젝트에 사용자 정의 이슈 트래커 설정하기.

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 string true Diffblue Cover 라이선스 키
diffblue_access_token_name string true 파이프라인에서 Diffblue Cover가 사용하는 엑세스 토큰 이름
diffblue_access_token_secret string 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 알림 설정

History

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

PUT /projects/:id/integrations/discord

파라미터:

파라미터 유형 필수 설명
webhook string true Discord 웹훅 (예: https://discord.com/api/webhooks/...).
branches_to_be_notified string false 알림을 보낼 브랜치입니다. all, default, protected, default_and_protected가 유효한 옵션입니다. 기본값은 default입니다.
confidential_issues_events boolean false 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_issue_channel string false 기밀 이슈 이벤트를 위한 웹훅 오버라이드입니다.
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_channel string false 기밀 노트 이벤트를 위한 웹훅 오버라이드입니다.
deployment_events boolean false 배포 이벤트에 대한 알림을 활성화합니다.
deployment_channel string false 배포 이벤트를 위한 웹훅 오버라이드입니다.
group_confidential_mentions_events boolean false 그룹 기밀 언급 이벤트에 대한 알림을 활성화합니다.
group_confidential_mentions_channel string false 그룹 기밀 언급 이벤트를 위한 웹훅 오버라이드입니다.
group_mentions_events boolean false 그룹 언급 이벤트에 대한 알림을 활성화합니다.
group_mentions_channel string false 그룹 언급 이벤트를 위한 웹훅 오버라이드입니다.
issues_events boolean false 이슈 이벤트에 대한 알림을 활성화합니다.
issue_channel string false 이슈 이벤트를 위한 웹훅 오버라이드입니다.
merge_requests_events boolean false 병합 요청 이벤트에 대한 알림을 활성화합니다.
merge_request_channel string false 병합 요청 이벤트를 위한 웹훅 오버라이드입니다.
note_events boolean false 노트 이벤트에 대한 알림을 활성화합니다.
note_channel string false 노트 이벤트를 위한 웹훅 오버라이드입니다.
notify_only_broken_pipelines boolean false 깨진 파이프라인에 대한 알림을 보냅니다.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림을 활성화합니다.
pipeline_channel string false 파이프라인 이벤트를 위한 웹훅 오버라이드입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
push_channel string false 푸시 이벤트를 위한 웹훅 오버라이드입니다.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_channel string false 태그 푸시 이벤트를 위한 웹훅 오버라이드입니다.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림을 활성화합니다.
wiki_page_channel string 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 string true Drone CI 프로젝트별 토큰입니다.
drone_url string true http://drone.example.com.
enable_ssl_verification boolean false SSL 검증을 활성화합니다. 기본값은 true(활성화됨)입니다.
push_events boolean false 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean false 병합 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 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 string true 공백으로 구분된 이메일입니다.
disable_diffs boolean false 코드 차이를 비활성화합니다.
send_from_committer_email boolean false 커미터로부터 보내기
push_events boolean false 푸시 이벤트에 대한 알림 활성화
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화
branches_to_be_notified string false 알림을 보낼 브랜치. all, default, protected, default_and_protected가 유효합니다. 태그 푸시에 대한 알림은 항상 발생합니다. 기본 값은 all입니다.

푸시 이메일 비활성화

프로젝트에 대한 푸시 이메일 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/emails-on-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
  • GitLab 16.9에서 git_guardian_integration이라는 플래그로 도입되었습니다. 기본적으로 활성화되어 있습니다. GitLab.com에서는 비활성화됩니다.
Self-managed GitLab에서는 기본적으로 이 기능을 사용할 수 있습니다. 기능을 숨기려면 관리자에게 git_guardian_integration이라는 기능 플래그를 비활성화하도록 요청하십시오. GitLab.com에서는 이 기능을 사용할 수 없습니다. GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.

GitGuardian은 소스 코드 저장소에서 API 키와 패스워드와 같은 민감한 데이터를 감지하는 사이버 보안 서비스입니다. Git 저장소를 스캔하고 정책 위반에 대한 경고를 보내어 조직이 해커가 그것들을 악용하기 전에 보안 문제를 해결하는 데 도움을 줍니다.

GitGuardian 정책에 따라 커밋을 거부하도록 GitLab을 구성할 수 있습니다.

알려진 문제

  • 푸시가 지연되거나 타임아웃될 수 있습니다. GitGuardian 통합을 통해 푸시가 제3자에게 전송되며 GitLab은 GitGuardian과의 연결 또는 GitGuardian 프로세스를 통제할 수 없습니다.
  • GitGuardian API 제한으로 인해 1MB 이상의 파일은 무시됩니다. 이 파일은 스캔되지 않습니다.
  • 푸시된 파일의 이름이 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 병합 요청 이벤트에 대한 알림을 활성화합니다.
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 위키 페이지 이벤트에 대한 알림을 활성화합니다.

GitLab for Slack 앱 비활성화

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

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

GitLab for 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.9Beta 기능으로 도입되었습니다. 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 and Access Management (IAM)

  • GitLab 16.10에서 Beta 기능으로 도입되었습니다. google_cloud_support_feature_flag라는 플래그와 함께 제공됩니다. 기본적으로 비활성화됩니다.
GitLab.com에서는 이 기능을 사용할 수 없습니다. 이 기능은 프로덕션 환경에서 사용하기에 준비되지 않았습니다.

Google Cloud Identity and Access Management 설정

프로젝트의 Google Cloud Identity and 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 and Access Management 비활성화

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

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

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

프로젝트의 Google Cloud Identity and 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/와 같은 Jenkins URL입니다.
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 병합 요청 이벤트에 대한 알림을 활성화합니다.
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 루트의 고급 설정에서 모든 브랜치 모니터링을 구성하여 병합 요청이 빌드될 수 있도록 합니다.

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 병합 요청 이벤트에 대한 알림을 활성화합니다.

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_type0인 경우).
password string yes Jira와 사용할 API 토큰, 암호 또는 개인 액세스 토큰. 인증 방법이 기본인 경우( jira_auth_type0), Jira 클라우드의 경우 API 토큰을 사용하고, Jira 데이터 센터 또는 Jira 서버의 경우 암호를 사용합니다. 인증 방법이 Jira 개인 액세스 토큰인 경우 (jira_auth_type1), 개인 액세스 토큰을 사용합니다.
active boolean no 통합을 활성화 또는 비활성화합니다. 기본값은 false (비활성화됨)입니다.
jira_auth_type integer no Jira와 사용할 인증 방법. 0은 Basic 인증을 의미합니다. 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 병합 요청 이벤트에 대한 알림을 활성화합니다.
comment_on_event_enabled boolean false 각 GitLab 이벤트(커밋 또는 병합 요청)에 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_anymatch_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 병합 요청 이벤트에 대한 알림을 활성화합니다.
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 병합 요청 이벤트에 대한 알림을 활성화합니다.
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_anymatch_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 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
note_channel string false 노트 이벤트에 대한 알림을 받을 채널 이름입니다.
note_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 문자열 Slack 토큰

Slack 슬래시 명렁어 비활성화

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

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

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

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

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

예시 응답:

{
  "id": 4,
  "title": "Slack slash commands",
  "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

-GitLab 15.10에 도입됨.

Squash TM 설정

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

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

매개변수:

매개변수 유형 필수 여부 설명
url 문자열 Squash TM 웹훅의 URL
token 문자열 아니오 비밀 토큰

Squash TM 비활성화

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

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

Squash TM 설정 가져오기

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

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

Telegram

Telegram 설정

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

PUT /projects/:id/integrations/telegram

매개변수:

매개변수 유형 필수 여부 설명
token 문자열 Telegram 봇 토큰 (예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).
room 문자열 대상 채팅의 고유 식별자 또는 대상 채널의 사용자 이름 (@channelusername 형식).
notify_only_broken_pipelines 부울 거짓 실패한 파이프라인에 대한 알림 전송
branches_to_be_notified 문자열 거짓 알림을 보낼 브랜치 (GitLab 16.5에서 도입됨). 옵션은 all, default, protected, default_and_protected. 기본값은 default.
push_events 부울 푸쉬 이벤트에 대한 알림 활성화
issues_events 부울 이슈 이벤트에 대한 알림 활성화
confidential_issues_events 부울 기밀 이슈 이벤트에 대한 알림 활성화
merge_requests_events 부울 머지 리퀘스트 이벤트에 대한 알림 활성화
tag_push_events 부울 태그 푸쉬 이벤트에 대한 알림 활성화
note_events 부울 노트 이벤트에 대한 알림 활성화
confidential_note_events 부울 기밀 노트 이벤트에 대한 알림 활성화
pipeline_events 부울 파이프라인 이벤트에 대한 알림 활성화
wiki_page_events 부울 위키 페이지 이벤트에 대한 알림 활성화

Telegram 비활성화

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

DELETE /projects/:id/integrations/telegram

Telegram 설정 가져오기

프로젝트의 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 병합 요청 이벤트에 대한 알림 활성화.
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 병합 요청 이벤트에 대한 알림 활성화.
tag_push_events boolean false 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean false 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean false 기밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean false 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean false 위키 페이지 이벤트에 대한 알림 활성화.

Webex Teams 비활성화

프로젝트에 대한 Webex Teams 통합 비활성화. 통합 설정이 재설정됩니다.

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

Webex Teams 설정 가져오기

프로젝트의 Webex Teams 설정 가져오기.

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

YouTrack

YouTrack 설정

프로젝트에 YouTrack 통합 설정.

PUT /projects/:id/integrations/youtrack

매개변수:

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

YouTrack 비활성화

프로젝트에 대한 YouTrack 통합 비활성화. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/youtrack

YouTrack 설정 가져오기

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

GET /projects/:id/integrations/youtrack