프로젝트 통합

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
note
이 페이지에는 프로젝트 통합에 대한 사용자 설명서가 포함되어 있습니다. 관리자 설명서는 프로젝트 통합 관리를 참조하십시오.

외부 응용 프로그램을 연동하여 GitLab에 기능을 추가할 수 있습니다.

다음 위치에서 통합을 볼 수 있으며 관리할 수 있습니다:

다음을 사용할 수 있습니다:

프로젝트 통합의 그룹 수준 기본 설정 관리

전제 조건:

  • 해당 그룹에서 적어도 Maintainer 역할이 있어야 합니다.

프로젝트 통합의 그룹 수준 기본 설정을 관리하려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. 통합을 선택합니다.
  4. 필드를 작성합니다.
  5. 변경 사항 저장을 선택합니다.
caution
이는 그룹에 속한 대부분 또는 대부분 모든 하위 그룹 및 프로젝트에 영향을 줄 수 있습니다. 아래 세부 정보를 확인하십시오.

이것이 통합의 그룹 수준 설정을 처음 설정하는 경우:

  • 그룹 수준 설정에서 통합 활성화 토글이 켜져 있는 경우, 해당 그룹에 속하는 모든 하위 그룹 및 프로젝트에 이 통합이 구성되지 않았다면 활성화됩니다.
  • 이미 해당 통합이 구성된 하위 그룹 및 프로젝트는 영향을 받지 않지만 언제든지 상속된 설정을 선택할 수 있습니다.

그룹 기본 설정을 더 변경하면:

  • 설정이 즉시 그룹에 속하는 모든 하위 그룹 및 프로젝트에 적용됩니다.
  • 설정은 즉시 새로 생성된 하위 그룹 및 프로젝트에도 즉시 적용되며, 마지막으로 통합의 기본 설정을 저장한 후에 만들어진 하위 그룹이라도 동일합니다. 그룹 수준 기본 설정에 통합 활성화 토글이 켜져 있는 경우, 해당 하위 그룹 및 프로젝트에 이 통합이 자동으로 활성화됩니다.
  • 통합에 대해 사용자 정의 설정이 선택된 하위 그룹 및 프로젝트는 즉시 영향을 받지 않으며, 항상 최신 기본 설정을 선택할 수 있습니다.

만약 인스턴스 수준 설정도 동일한 통합에 대해 구성되어 있는 경우, 해당 그룹의 프로젝트는 그룹에서 설정을 상속받습니다.

통합을 위한 전체 설정만 상속될 수 있습니다. 개별 필드 상속은 epic 2137에서 제안됩니다.

그룹 수준 기본 설정 제거

전제 조건:

  • 해당 그룹에서 적어도 Maintainer 역할이 있어야 합니다.

그룹 수준 기본 설정을 제거하려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. 통합을 선택합니다.
  4. 재설정을 선택하고 확인합니다.

그룹 수준 기본 설정을 재설정하면 기본 설정을 사용하고 프로젝트 또는 하위 그룹에 속하는 통합이 제거됩니다.

프로젝트 통합을 위한 인스턴스 수준 또는 그룹 수준 기본 설정 사용

전제 조건:

  • 해당 프로젝트에서 적어도 Maintainer 역할이 있어야 합니다.

프로젝트 통합을 위한 인스턴스 수준 또는 그룹 수준 기본 설정을 사용하려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. 통합을 선택합니다.
  4. 오른쪽에서 드롭다운 디렉터리에서 기본 설정 사용을 선택합니다.
  5. 통합 활성화 아래에서 활성 확인란을 선택합니다.
  6. 필드를 작성합니다.
  7. 변경 사항 저장을 선택합니다.

프로젝트 또는 그룹 통합을 위한 사용자 정의 설정 사용

전제 조건:

  • 해당 프로젝트 또는 그룹에서 적어도 Maintainer 역할이 있어야 합니다.

프로젝트 또는 그룹 통합을 위한 사용자 정의 설정을 사용하려면:

  1. 왼쪽 사이드 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. 통합을 선택합니다.
  4. 오른쪽에서 드롭다운 디렉터리에서 사용자 정의 설정 사용을 선택합니다.
  5. 통합 활성화 아래에서 활성 확인란을 선택합니다.
  6. 필드를 작성합니다.
  7. 변경 사항 저장을 선택합니다.

사용 가능한 통합

통합 설명 통합 후크
Asana Asana 작업에 커밋 메시지 추가 사용 안 함
Assembla Assembla로 프로젝트 관리 사용 안 함
Atlassian Bamboo Atlassian Bamboo로 CI/CD 파이프라인 실행 사용 함
Bugzilla 이슈 트래커로 Bugzilla 사용 사용 안 함
Buildkite Buildkite로 CI/CD 파이프라인 실행 사용 함
Campfire 채팅을 위해 Campfire 연결 사용 안 함
ClickUp 이슈 트래커로 ClickUp 사용 사용 안 함
Confluence Workspace 내부 위키로 Confluence Workspace 사용 사용 안 함
Custom issue tracker 사용자 정의 이슈 트래커 사용 안 함
Datadog GitLab 파이프라인을 Datadog로 추적 사용 함
Discord Notifications 프로젝트 이벤트에 대한 알림을 Discord 채널로 전송 사용 안 함
Drone Drone을 사용하여 CI/CD 파이프라인 실행 사용 함
이메일 푸시 이메일로 커밋 및 차이 사항 푸시 전송 사용 안 함
Engineering Workflow Management (EWM) 이슈 트래커로 EWM 사용 사용 안 함
외부 위키 외부 위키 연결 사용 안 함
GitGuardian GitGuardian 정책에 따라 커밋 거절 사용 안 함
GitHub 커밋 및 풀 리퀘스트에 대한 상태 수신 사용 안 함
GitLab for Slack app 네이티브 Slack 앱을 사용하여 알림 및 명령 실행 사용 안 함
Google Chat GitLab 프로젝트의 알림을 Google Chat 스페이스로 전송 사용 안 함
Harbor GitLab을 위한 컨테이너 레지스트리로 Harbor 사용 사용 안 함
irker (IRC gateway) IRC 메시지 전송 사용 안 함
Jenkins Jenkins를 사용하여 CI/CD 파이프라인 실행 사용 함
JetBrains TeamCity TeamCity를 사용하여 CI/CD 파이프라인 실행 사용 함
Jira 이슈 트래커로 Jira 사용 사용 안 함
Mattermost notifications 프로젝트 이벤트에 대한 알림을 Mattermost 채널로 전송 사용 안 함
Mattermost slash commands Mattermost 채팅 환경에서 슬래시 명령 실행 사용 안 함
Microsoft Teams notifications Microsoft Teams에서 이벤트 알림 받기 사용 안 함
Packagist Packagist에서 PHP 의존성 업데이트 사용 함
Pipeline status emails 이메일로 수신자 디렉터리에 파이프라인 상태 보내기 사용 안 함
Pivotal Tracker Pivotal Tracker 스토리에 커밋 메시지 추가 사용 안 함
Pumble Pumble 채널에 이벤트 알림 전송 사용 안 함
Pushover 기기에 대한 실시간 알림 사용 안 함
Redmine 이슈 트래커로 Redmine 사용 사용 안 함
Slack slash commands Slack 채팅 환경에서 슬래시 명령 실행 사용 안 함
Squash TM GitLab 이슈 수정 시 Squash TM 요구 사항 업데이트 사용 함
Telegram 프로젝트 이벤트에 대한 알림을 Telegram으로 전송 사용 안 함
Unify Circuit 프로젝트 이벤트에 대한 알림을 Unify Circuit으로 전송 사용 안 함
Webex Teams Webex Teams에서 이벤트 알림 받기 사용 안 함
YouTrack 이슈 트래커로 YouTrack 사용 사용 안 함

프로젝트 웹훅

일부 통합은 외부 애플리케이션을 위해 웹훅을 사용합니다.

특정 이벤트를 수신하기 위해 프로젝트 웹훅을 구성할 수 있습니다. 푸시, 이슈 또는 Merge Request과 같은 이벤트가 발생하면 웹훅이 트리거됩니다. 그때 GitLab은 지정된 웹훅 URL로 데이터를 포함한 POST 요청을 보냅니다.

웹훅을 사용하는 통합 디렉터리은 사용 가능한 통합을 참조하세요.

푸시 후크 제한

단일 푸시에 세 개 이상의 브랜치나 태그에 변경이 포함되어 있을 경우, push_hooks 및 tag_push_hooks 이벤트로 지원되는 통합이 실행되지 않습니다.

지원되는 브랜치나 태그의 수를 변경하려면 push_event_hooks_limit 설정을 구성하세요.

SSL 검증

기본적으로, 외부 HTTP 요청의 SSL 인증서는 내부 인증 기관 디렉터리에 따라 검증됩니다. SSL 인증서는 자체 서명될 수 없습니다.

웹훅 및 일부 통합을 구성할 때 SSL 검증을 해제할 수 있습니다. GitLab에서 웹훅을 구성하는 방법을 참조하세요.

관련 주제