프로젝트 통합

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated
note
이 페이지는 프로젝트 통합에 대한 사용자 문서를 포함합니다. 관리자 문서는 프로젝트 통합 관리를 참조하세요.

외부 애플리케이션과 통합하여 GitLab에 기능을 추가할 수 있습니다.

다음에 대한 통합을 보고 관리할 수 있습니다:

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

프로젝트 통합을 위한 그룹 기본 설정 관리

Prerequisites:

  • 그룹에 대해 최소한 Maintainer 역할이 있어야 합니다.

프로젝트 통합을 위한 그룹 기본 설정을 관리하려면:

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

이 통합을 위한 그룹 설정을 처음 설정하는 경우:

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

그룹 기본 설정에 대해 추가 변경을 하면:

  • 기본 설정을 사용하도록 설정된 그룹에 속한 모든 하위 그룹 및 프로젝트에 즉시 적용됩니다.
  • 최신 기본 설정을 저장한 후 생성된 신규 하위 그룹 및 프로젝트에도 즉시 적용됩니다. 그룹 기본 설정에서 통합 활성화 토글이 켜져 있는 경우, 이러한 모든 하위 그룹 및 프로젝트에 대해 통합이 자동으로 활성화됩니다.
  • 통합에 대해 사용자 지정 설정이 선택된 하위 그룹 및 프로젝트는 즉시 영향을 받지 않으며 언제든지 최신 기본 설정을 사용할 수 있습니다.

인스턴스 설정도 동일한 통합에 대해 구성된 경우, 그룹의 프로젝트는 그룹에서 설정을 상속합니다.

통합에 대한 전체 설정만 상속할 수 있습니다. 필드별 상속은 epic 2137에서 제안되었습니다.

그룹 기본 설정 제거

Prerequisites:

  • 그룹에 대해 최소한 Maintainer 역할이 있어야 합니다.

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

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

그룹의 프로젝트 또는 하위 그룹에 속한 기본 설정을 사용하는 통합을 제거합니다.

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

Prerequisites:

  • 프로젝트에 대해 최소한 Maintainer 역할이 있어야 합니다.

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

  1. 왼쪽 사이드바에서 검색하거나 이동을 선택하고 프로젝트를 찾습니다.
  2. 설정 > 통합을 선택합니다.
  3. 통합을 선택합니다.
  4. 오른쪽에서 드롭다운 목록에서 기본 설정 사용을 선택합니다.
  5. 통합 활성화에서 활성 체크박스가 선택되었는지 확인합니다.
  6. 필드를 작성합니다.
  7. 변경 사항 저장을 선택합니다.

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

사전 조건:

  • 프로젝트 또는 그룹에 대해 최소한 유지 관리자인 역할이 있어야 합니다.

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

  1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.

  2. 설정 > 통합을 선택합니다.

  3. 통합을 선택합니다.

  4. 오른쪽에서 드롭다운 목록에서 사용자 지정 설정 사용을 선택합니다.

  5. 통합 사용 아래에서 활성 체크박스가 선택되어 있는지 확인합니다.

  6. 필드를 완성합니다.

  7. 변경사항 저장을 선택합니다.

사용 가능한 통합

통합 설명 통합 후크
Apple App Store Connect GitLab을 사용하여 Apple App Store에서 앱을 빌드하고 배포합니다. 아니요
Asana 커밋 메시지를 Asana 작업의 댓글로 추가합니다. 아니요
Assembla Assembla로 프로젝트를 관리합니다. 아니요
Atlassian Bamboo Atlassian Bamboo로 CI/CD 파이프라인을 실행합니다.
Bugzilla Bugzilla를 문제 추적기로 사용합니다. 아니요
Beyond Identity GPG 키가 Beyond Identity Authenticator에 의해 승인되었는지 확인합니다. 아니요
Buildkite Buildkite로 CI/CD 파이프라인을 실행합니다.
Campfire Campfire에 연결하여 채팅합니다. 아니요
ClickUp ClickUp을 문제 추적기로 사용합니다. 아니요
Confluence Workspace Confluence Workspace를 내부 위키로 사용합니다. 아니요
Custom issue tracker 사용자 지정 문제 추적기를 사용합니다. 아니요
Datadog Datadog으로 GitLab 파이프라인을 추적합니다.
Diffblue Cover 포괄적이고 인간 같은 자바 단위 테스트를 자동으로 작성합니다. 아니요
Discord Notifications 프로젝트 이벤트에 대한 알림을 Discord 채널에 보냅니다. 아니요
Drone Drone으로 CI/CD 파이프라인을 실행합니다.
Emails on push 푸시 시 커밋 및 차이를 이메일로 보냅니다. 아니요
Engineering Workflow Management (EWM) EWM을 문제 추적기로 사용합니다. 아니요
External wiki 외부 위키를 연결합니다. 아니요
GitGuardian GitGuardian 정책에 따라 커밋을 거부합니다. 아니요
GitHub 커밋 및 풀 요청에 대한 상태를 수신합니다. 아니요
GitLab for Slack app 기본 Slack 앱을 사용하여 알림을 수신하고 명령을 실행합니다. 아니요
Google Artifact Management Google Artifact Registry에서 아티팩트를 관리합니다. 아니요
Google Chat GitLab 프로젝트에서 Google Chat의 공간으로 알림을 보냅니다. 아니요
Google Cloud IAM Identity and Access Management (IAM)로 Google Cloud 리소스에 대한 권한을 관리합니다. 아니요
Google Play GitLab을 사용하여 Google Play에 앱을 빌드하고 배포합니다. 아니요
Harbor GitLab의 컨테이너 레지스트리로 Harbor를 사용합니다. 아니요
irker (IRC gateway) IRC 메시지를 보냅니다. 아니요
Jenkins Jenkins로 CI/CD 파이프라인을 실행합니다.
JetBrains TeamCity TeamCity로 CI/CD 파이프라인을 실행합니다.
JetBrains YouTrack JetBrains YouTrack을 프로젝트의 문제 추적기로 사용합니다. 아니요
Jira Jira를 문제 추적기로 사용합니다. 아니요
Matrix notifications 프로젝트 이벤트에 대한 알림을 Matrix에 보냅니다. 아니요
Mattermost notifications 프로젝트 이벤트에 대한 알림을 Mattermost 채널에 보냅니다. 아니요
Mattermost slash commands Mattermost 채팅 환경에서 슬래시 명령을 실행합니다. 아니요
Microsoft Teams notifications Microsoft Teams에서 이벤트 알림을 수신합니다. 아니요
Packagist Packagist에서 PHP 종속성을 업데이트합니다.
Phorge Phorge를 문제 추적기로 사용합니다. 아니요
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에서 이벤트 알림을 수신합니다. 아니요

프로젝트 웹후크

일부 통합은 외부 애플리케이션을 위한 웹후크를 사용합니다.

특정 이벤트에 대해 수신 대기하도록 프로젝트 웹후크를 구성할 수 있습니다.

예를 들어 푸시, 이슈 또는 병합 요청과 같은 이벤트입니다. 웹후크가 트리거되면,

GitLab은 지정된 웹후크 URL로 데이터를 포함한 POST 요청을 보냅니다.

웹후크를 사용하는 통합 목록은 사용 가능한 통합을 참조하세요.

푸시 훅 제한

단일 푸시에 세 개 이상의 브랜치 또는 태그에 대한 변경 사항이 포함되면,

push_hookstag_push_hooks 이벤트로 지원되는 통합은 실행되지 않습니다.

지원되는 브랜치 또는 태그 수를 변경하려면,

push_event_hooks_limit 설정을 구성하세요.

SSL 검증

기본적으로, 외부 HTTP 요청에 대한 SSL 인증서는

내부 인증 기관 목록을 기반으로 검증됩니다. SSL 인증서는

자체 서명이 불가능합니다.

웹후크와 일부 통합을 구성할 때 SSL 검증을 비활성화할 수 있습니다.

관련 주제