• 프로젝트 통합을 위한 그룹 수준의 기본 설정 관리
  • 그룹 수준의 기본 설정 제거
• 프로젝트 통합을 위한 인스턴스 수준 또는 그룹 수준의 기본 설정 사용
• 프로젝트 또는 그룹 통합을 위한 사용자 정의 설정 사용
• 사용 가능한 통합
• 프로젝트 웹훅
• 푸시 훅 제한
• SSL 확인
• 관련 주제

프로젝트 통합

GitLab에 기능을 추가하기 위해 외부 응용 프로그램을 통합할 수 있습니다.

다음 위치에서 통합을 볼 수 있고 관리할 수 있습니다.

• 인스턴스 수준 (Self-managed GitLab)
• 그룹 수준

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

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

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

전제 조건:

• 그룹의 최소한 Maintainer 역할이 필요합니다.

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

1. 왼쪽 사이드바에서 검색 또는 이동을 선택하고 그룹을 찾으십시오.
2. 설정 > 통합을 선택합니다.
3. 통합을 선택합니다.
4. 필드를 작성합니다.
5. 변경 사항 저장을 선택합니다.

경고: 이는 그룹에 속하는 하위 그룹 및 프로젝트에 영향을 줄 수 있습니다. 아래의 세부 정보를 검토하십시오.

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

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

그룹의 기본 설정을 추후에 변경하면:

• 그 구성된 그룹 수준의 기본 설정을 사용하는 하위 그룹 및 프로젝트에 즉시 적용됩니다.
• 마지막으로 기본 설정을 저장한 후에 만들어진 하위 그룹 및 프로젝트에도 즉시 적용됩니다. 그룹 수준의 기본 설정이 통합 활성화 토글을 켰다면, 이러한 하위 그룹 및 프로젝트에 해당 통합이 자동으로 활성화됩니다.
• 통합에 대해 사용자 정의 설정을 선택한 하위 그룹 및 프로젝트는 즉시 영향을 받지 않고 언제든지 최신 기본 설정을 사용할 수 있습니다.

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

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

그룹 수준의 기본 설정 제거

전제 조건:

• 그룹의 최소한 Maintainer 역할이 필요합니다.

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

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

그룹 수준의 기본 설정을 재설정하면 해당 그룹의 프로젝트나 하위 그룹에서 기본 설정을 사용하는 통합이 제거됩니다.

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

전제 조건:

• 프로젝트의 최소한 Maintainer 역할이 필요합니다.

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

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

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

전제 조건:

• 프로젝트 또는 그룹의 최소한 Maintainer 역할이 필요합니다.

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

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

사용 가능한 통합

프로젝트 웹훅

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

특정 이벤트(푸시, 이슈, 또는 병합 요청)를 감지하도록 프로젝트 웹훅을 구성할 수 있습니다. 웹훅이 트리거되면 GitLab은 지정된 웹훅 URL로 데이터를 포함한 POST 요청을 보냅니다.

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

푸시 훅 제한

단일 푸시에 세 개 이상의 브랜치 또는 태그에 대한 변경 사항이 포함된 경우, push_hooks 및 tag_push_hooks 이벤트를 지원하는 통합은 실행되지 않습니다.

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

SSL 확인

기본적으로, 외부 HTTP 요청의 SSL 인증서는 내부 인증 기관 목록을 기반으로 확인됩니다. SSL 인증서는 자체 서명될 수 없습니다.

웹훅 구성 및 일부 통합을 구성할 때 SSL 확인을 비활성화할 수 있습니다.

관련 주제

• 통합 API
• 통합 개발 가이드라인
• GitLab 개발자 포털