CI/CD 설정
Offering: GitLab Self-Managed
관리자 영역에서 GitLab 인스턴스의 CI/CD 설정을 구성합니다. Auto DevOps, 인스턴스 러너, 잡 아티팩트 등 CI/CD 설정을 사용자 정의합니다. .gitlab-ci.yml 파일이 없는 모든 프로젝트에 대해 Auto DevOps가 실행되도록 구성합니다.
관리자 영역에서 GitLab 인스턴스의 CI/CD 설정을 구성합니다.
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
다음 설정을 사용할 수 있습니다:
- 변수: 인스턴스의 모든 프로젝트에서 사용 가능한 CI/CD 변수를 구성합니다.
- 지속적인 통합 및 배포: Auto DevOps, 작업, 아티팩트, 인스턴스 러너, 파이프라인 기능에 대한 설정을 구성합니다.
- 패키지 레지스트리: 패키지 전달 및 파일 크기 제한을 구성합니다.
- 러너: 러너 등록, 버전 관리, 토큰 설정을 구성합니다.
- 잡 토큰 권한: 프로젝트 간 잡 토큰 액세스를 제어합니다.
- 잡 로그: 증분 로깅 등 잡 로그 설정을 구성합니다.
지속적인 통합 및 배포 설정 액세스#
Auto DevOps, 인스턴스 러너, 잡 아티팩트 등 CI/CD 설정을 사용자 정의합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 지속적인 통합 및 배포를 확장합니다.
모든 프로젝트에 Auto DevOps 구성#
.gitlab-ci.yml 파일이 없는 모든 프로젝트에 대해 Auto DevOps가 실행되도록 구성합니다.
이 설정은 기존 프로젝트와 새 프로젝트 모두에 적용됩니다.
인스턴스의 모든 프로젝트에 Auto DevOps를 구성하려면:
- 모든 프로젝트에 대해 Auto DevOps 파이프라인을 기본값으로 설정 확인란을 선택합니다.
- 선택 사항. Auto Deploy 및 Auto Review Apps를 사용하려면 Auto DevOps 기본 도메인을 지정합니다.
- 변경 사항 저장을 선택합니다.
인스턴스 러너#
새 프로젝트에 인스턴스 러너 활성화#
기본적으로 모든 새 프로젝트에서 인스턴스 러너를 사용 가능하게 합니다.
새 프로젝트에 인스턴스 러너를 사용 가능하게 하려면:
- 새 프로젝트에 인스턴스 러너 활성화 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
인스턴스 러너 세부 정보 추가#
인스턴스 러너에 대한 설명 텍스트를 추가합니다. 이 텍스트는 모든 프로젝트의 러너 설정에 표시됩니다.
인스턴스 러너 세부 정보를 추가하려면:
- 인스턴스 러너 세부 정보 텍스트 상자에 텍스트를 입력합니다. Markdown 형식을 사용할 수 있습니다.
- 변경 사항 저장을 선택합니다.
렌더링된 세부 정보를 보려면:
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 러너를 확장합니다.

여러 프로젝트와 프로젝트 러너 공유#
프로젝트 러너를 여러 프로젝트와 공유합니다.
사전 요구 사항:
- 등록된 프로젝트 러너가 있어야 합니다.
여러 프로젝트와 프로젝트 러너를 공유하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 CI/CD > 러너를 선택합니다.
- 편집하려는 러너를 선택합니다.
- 오른쪽 상단에서 편집 (✏️)을 선택합니다.
- 이 러너의 프로젝트 제한 아래에서 프로젝트를 검색합니다.
- 프로젝트 왼쪽에서 활성화를 선택합니다.
- 추가 프로젝트마다 이 과정을 반복합니다.
잡 아티팩트#
GitLab 인스턴스 전체에서 잡 아티팩트가 저장되고 관리되는 방식을 제어합니다.
최대 아티팩트 크기 설정#
저장소 사용을 제어하기 위해 잡 아티팩트의 크기 제한을 설정합니다. 잡의 각 아티팩트 파일의 기본 최대 크기는 100 MB입니다.
artifacts:reports로 정의된 잡 아티팩트는 다른 제한을 가질 수 있습니다.
다른 제한이 적용되는 경우 더 작은 값이 사용됩니다.
이 설정은 잡의 개별 파일이 아닌 최종 아카이브 파일 크기에 적용됩니다.
다음에 대한 아티팩트 크기 제한을 구성할 수 있습니다:
- 인스턴스: 모든 프로젝트와 그룹에 적용되는 기본 설정.
- 그룹: 그룹의 모든 프로젝트에 대해 인스턴스 설정을 재정의합니다.
- 프로젝트: 특정 프로젝트에 대해 인스턴스와 그룹 설정 모두를 재정의합니다.
GitLab.com 제한은 아티팩트 최대 크기를 참조하세요.
인스턴스의 최대 아티팩트 크기를 변경하려면:
- 최대 아티팩트 크기(MB) 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
그룹 또는 프로젝트의 최대 아티팩트 크기를 변경하려면:
- 상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 일반 파이프라인을 확장합니다.
- 최대 아티팩트 크기 값(MB)을 변경합니다.
- 변경 사항 저장을 선택합니다.
기본 아티팩트 만료 설정#
잡 아티팩트가 자동으로 삭제되기 전에 보존되는 기간을 설정합니다. 기본 만료 시간은 30일입니다.
기간 구문은 artifacts:expire_in에 설명되어 있습니다.
개별 잡 정의는 프로젝트의 .gitlab-ci.yml 파일에서 이 기본값을 재정의할 수 있습니다.
이 설정 변경 사항은 새 아티팩트에만 적용됩니다. 기존 아티팩트는 원래 만료 시간을 유지합니다. 오래된 아티팩트를 수동으로 만료시키는 방법에 대한 자세한 내용은 문제 해결 문서를 참조하세요.
잡 아티팩트의 기본 만료 시간을 설정하려면:
- 기본 아티팩트 만료 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
최신 성공한 파이프라인의 아티팩트 보존#
만료 시간에 관계없이 각 Git ref(브랜치 또는 태그)에 대해 가장 최근의 성공한 파이프라인의 아티팩트를 보존합니다.
기본적으로 이 설정은 켜져 있습니다.
이 설정은 프로젝트 설정보다 우선합니다. 인스턴스에 대해 꺼져 있으면 개별 프로젝트에 대해 켤 수 없습니다.
이 기능이 꺼져 있을 때는 기존에 보존된 아티팩트가 즉시 만료되지 않습니다. 아티팩트가 만료될 수 있으려면 브랜치에서 새로운 성공한 파이프라인이 실행되어야 합니다.
모든 애플리케이션 설정에는 사용자 정의 가능한 캐시 만료 간격이 있어, 설정 변경의 효과가 지연될 수 있습니다.
최신 성공한 파이프라인의 아티팩트를 보존하려면:
- 최신 성공한 파이프라인의 모든 작업에 대한 최신 아티팩트 유지 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
아티팩트가 만료 설정에 따라 만료되도록 허용하려면 확인란을 해제합니다.
외부 리디렉션 경고 페이지 표시 또는 숨기기#
사용자가 GitLab Pages를 통해 잡 아티팩트를 볼 때 경고 페이지를 표시할지 여부를 제어합니다. 이 경고는 사용자가 생성한 콘텐츠로 인한 잠재적인 보안 위험을 알립니다.
외부 리디렉션 경고 페이지는 기본적으로 표시됩니다. 숨기려면:
- 잡 아티팩트의 외부 리디렉션 페이지 활성화 확인란을 해제합니다.
- 변경 사항 저장을 선택합니다.
파이프라인#
파이프라인 아카이브#
지정된 기간이 지나면 오래된 파이프라인과 모든 작업을 자동으로 아카이브합니다. 아카이브된 작업은:
- 잠금 아이콘(🔒)을 표시하고 잡 로그 상단에 이 잡은 아카이브됨을 표시합니다.
- 다시 실행하거나 재시도할 수 없습니다.
- 환경이 자동 중지될 때 중지 배포 작업으로 실행할 수 없습니다.
- 계속해서 잡 로그를 볼 수 있습니다.
아카이브 기간은 파이프라인이 생성된 시점부터 측정됩니다. 최소 1일이어야 합니다.
유효한 기간의 예로는 15 days, 1 month, 2 years가 있습니다.
이 필드를 비워 두면 파이프라인을 자동으로 아카이브하지 않습니다.
GitLab.com에 대한 정보는 예약된 잡 아카이브를 참조하세요.
잡 아카이브를 설정하려면:
- 파이프라인 아카이브 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
기본적으로 파이프라인 변수 허용#
히스토리
- GitLab 18.1에서 도입되었습니다.
새 그룹의 새 프로젝트에서 파이프라인 변수가 기본적으로 허용되는지 여부를 제어합니다.
비활성화된 경우 새 그룹에 대한 파이프라인 변수를 사용할 수 있는 기본 역할 설정이 아무도 허용 안 됨으로 설정되며, 이는 새 그룹의 새 프로젝트에 계단식으로 적용됩니다. 활성화된 경우 설정은 기본적으로 개발자가 됩니다.
새 그룹과 프로젝트에 가장 안전한 기본값을 유지하려면 이 설정을 비활성화하는 것이 권장됩니다.
새 그룹의 모든 새 프로젝트에서 기본적으로 파이프라인 변수를 허용하려면:
- 새 그룹의 기본적으로 파이프라인 변수 허용 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
그룹 또는 프로젝트 생성 후 유지 관리자는 다른 설정을 선택할 수 있습니다.
기본적으로 CI/CD 변수 보호#
프로젝트와 그룹의 모든 새 CI/CD 변수를 기본적으로 보호되도록 설정합니다. 보호된 변수는 보호된 브랜치 또는 보호된 태그에서 실행되는 파이프라인에서만 사용 가능합니다.
기본적으로 모든 새 CI/CD 변수를 보호하려면:
- 기본적으로 CI/CD 변수 보호 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
최대 인클루드 수 설정#
히스토리
- GitLab 16.0에서 도입되었습니다.
include 키워드를 사용하여 파이프라인이 포함할 수 있는 외부 YAML 파일 수를 제한합니다.
이 제한은 파이프라인이 너무 많은 파일을 포함할 때 성능 문제를 방지합니다.
기본적으로 파이프라인은 최대 150개의 파일을 포함할 수 있습니다. 파이프라인이 이 제한을 초과하면 오류와 함께 실패합니다.
파이프라인당 포함 파일의 최대 수를 설정하려면:
- 최대 인클루드 수 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
다운스트림 파이프라인 트리거 속도 제한#
히스토리
- GitLab 16.10에서 도입되었습니다.
단일 소스에서 분당 트리거될 수 있는 다운스트림 파이프라인 수를 제한합니다.
최대 다운스트림 파이프라인 트리거 속도는 프로젝트, 사용자, 커밋의 주어진 조합에 대해 분당 트리거될 수 있는 다운스트림 파이프라인 수를 제한합니다.
기본값은 0이며, 이는 제한이 없음을 의미합니다.
Git 푸시당 파이프라인 제한#
히스토리
- GitLab 18.0에서 도입되었습니다.
단일 Git 푸시로 트리거될 수 있는 태그 또는 브랜치 파이프라인의 최대 수를 설정합니다. 이 제한에 대한 자세한 내용은 Git 푸시당 파이프라인 수를 참조하세요.
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 지속적인 통합 및 배포를 확장합니다.
- Git 푸시당 파이프라인 제한 값을 변경합니다.
- 변경 사항 저장을 선택합니다.
기본 CI/CD 구성 파일 지정#
모든 새 프로젝트에서 CI/CD 구성 파일의 기본값으로 사용할 사용자 정의 경로와 파일 이름을 설정합니다.
기본적으로 GitLab은 프로젝트의 루트 디렉토리에 있는 .gitlab-ci.yml 파일을 사용합니다.
이 설정은 변경 후 생성된 새 프로젝트에만 적용됩니다. 기존 프로젝트는 현재 CI/CD 구성 파일 경로를 계속 사용합니다.
사용자 정의 기본 CI/CD 구성 파일 경로를 설정하려면:
- 기본 CI/CD 구성 파일 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
개별 프로젝트는 사용자 정의 CI/CD 구성 파일을 지정하여 이 인스턴스 기본값을 재정의할 수 있습니다.
파이프라인 제안 배너 표시 또는 숨기기#
파이프라인이 없는 머지 리퀘스트에 안내 배너를 표시할지 여부를 제어합니다.
이 배너는 .gitlab-ci.yml 파일을 추가하는 방법에 대한 안내를 제공합니다.

파이프라인 제안 배너는 기본적으로 표시됩니다. 숨기려면:
- 파이프라인 제안 배너 활성화 확인란을 해제합니다.
- 변경 사항 저장을 선택합니다.
Jenkins 마이그레이션 배너 표시 또는 숨기기#
히스토리
- GitLab 17.7에서 도입되었습니다.
Jenkins에서 GitLab CI/CD로 마이그레이션을 장려하는 배너를 표시할지 여부를 제어합니다. 이 배너는 Jenkins 통합이 활성화된 프로젝트의 머지 리퀘스트에 표시됩니다.

Jenkins 마이그레이션 배너는 기본적으로 표시됩니다. 숨기려면:
- Jenkins에서 마이그레이션 배너 표시 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
CI/CD 제한 설정#
히스토리
CI/CD 제한을 설정하여 리소스 사용을 제어하고 성능 문제를 방지합니다.
다음 CI/CD 제한을 구성할 수 있습니다:
- 최대 인스턴스 수준 CI/CD 변수 수
- dotenv 아티팩트의 최대 크기(바이트)
- dotenv 아티팩트의 최대 변수 수
- 단일 파이프라인의 최대 작업 수
- 현재 활성 파이프라인의 총 작업 수
- 프로젝트와의 파이프라인 구독 최대 수
- 파이프라인 스케줄의 최대 수
- 작업이 가질 수 있는 최대 needs 의존성 수
- 지난 7일 동안 그룹에서 생성 또는 활성화된 최대 러너 수
- 지난 7일 동안 프로젝트에서 생성 또는 활성화된 최대 러너 수
- 파이프라인의 계층 트리에서 최대 다운스트림 파이프라인 수
- 머지 트레인당 최대 병렬 파이프라인 수
이러한 제한이 제어하는 사항에 대한 자세한 내용은 CI/CD 제한을 참조하세요.
CI/CD 제한을 구성하려면:
- CI/CD 제한 아래에서 구성하려는 제한의 값을 설정합니다.
- 변경 사항 저장을 선택합니다.
패키지 레지스트리 설정 액세스#
NuGet 패키지 유효성 검사, Helm 패키지 제한, 패키지 파일 크기 제한, 패키지 전달을 구성합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 패키지 레지스트리를 확장합니다.
NuGet 패키지 메타데이터 URL 유효성 검사 건너뛰기#
NuGet 패키지의 projectUrl, iconUrl, licenseUrl 메타데이터 유효성 검사를 건너뜁니다.
기본적으로 GitLab은 이러한 URL을 유효성 검사합니다. GitLab 인스턴스에 인터넷 액세스가 없는 경우 이 유효성 검사가 실패하고 NuGet 패키지를 업로드할 수 없게 됩니다.
NuGet 패키지 메타데이터 URL 유효성 검사를 건너뛰려면:
- NuGet 패키지의 메타데이터 URL 유효성 검사 건너뛰기 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
채널당 최대 Helm 패키지 수 설정#
채널당 나열할 수 있는 Helm 패키지의 최대 수를 설정합니다.
Helm 패키지 제한을 설정하려면:
- 패키지 제한 아래에서 채널당 최대 Helm 패키지 수 필드에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
패키지 파일 크기 제한 설정#
저장소 사용을 제어하고 시스템 성능을 유지하기 위해 각 패키지 유형에 대한 최대 파일 크기 제한을 설정합니다.
다음 패키지의 최대 파일 크기 제한을 바이트 단위로 구성할 수 있습니다:
- Conan 패키지
- Helm 차트
- Maven 패키지
- npm 패키지
- NuGet 패키지
- PyPI 패키지
- Terraform 모듈 패키지
- 일반 패키지
패키지 파일 크기 제한을 구성하려면:
- 패키지 파일 크기 제한 아래에서 구성하려는 제한의 값을 입력합니다.
- 크기 제한 저장을 선택합니다.
패키지 전달 제어#
GitLab 패키지 레지스트리에서 패키지를 찾을 수 없을 때 패키지 요청을 공개 레지스트리로 전달할지 여부를 제어합니다.
기본적으로 GitLab은 패키지 요청을 각각의 공개 레지스트리로 전달합니다:
- Maven 요청은 Maven Central로 전달됩니다.
- npm 요청은 npmjs.com으로 전달됩니다.
- PyPI 요청은 pypi.org로 전달됩니다.
패키지 전달을 해제하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 개요 > 그룹을 선택합니다.
- 설정 > CI/CD를 선택합니다.
- 패키지 레지스트리를 확장합니다.
- 다음 확인란 중 하나를 해제합니다:
- npm 패키지 요청 전달
- PyPI 패키지 요청 전달
- 변경 사항 저장을 선택합니다.
Maven 패키지에 대한 요청 전달을 해제하려면 패키지 레지스트리의 Maven 패키지를 참조하세요.
러너 설정 액세스#
러너 버전 관리 및 등록 설정을 구성합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 러너를 확장합니다.
러너 버전 관리 제어#
인스턴스가 GitLab.com에서 공식 러너 버전 데이터를 가져와 러너 업그레이드가 필요한지 확인할지 여부를 제어합니다.
기본적으로 GitLab은 러너 버전 데이터를 가져옵니다. 이 데이터 가져오기를 중지하려면:
- 러너 버전 관리 아래에서 GitLab.com에서 GitLab Runner 릴리스 버전 데이터 가져오기 확인란을 해제합니다.
- 변경 사항 저장을 선택합니다.
러너 등록 제어#
히스토리
- 러너 등록 토큰 허용 설정이 GitLab 16.11에서 도입되었습니다.
러너를 등록할 수 있는 사람과 등록 토큰 허용 여부를 제어합니다.
러너 등록 토큰 전달 옵션 및 특정 구성 인수 지원은 레거시로 간주되며 권장되지 않습니다. 러너를 등록하기 위한 인증 토큰을 생성하려면 러너 생성 워크플로우를 사용하세요. 이 프로세스는 러너 소유권에 대한 완전한 추적 가능성을 제공하고 러너 플릿의 보안을 강화합니다.
자세한 내용은 새 러너 등록 워크플로우로 마이그레이션을 참조하세요.
기본적으로 러너 등록 토큰과 프로젝트 및 그룹 멤버 등록 모두 허용됩니다. 러너 등록을 제한하려면:
- 러너 등록 아래에서 다음 확인란 중 하나를 해제합니다:
- 러너 등록 토큰 허용
- 프로젝트 멤버가 러너를 생성할 수 있음
- 그룹 멤버가 러너를 생성할 수 있음
- 변경 사항 저장을 선택합니다.
프로젝트 멤버에 대한 러너 등록을 비활성화하면 등록 토큰이 자동으로 순환됩니다. 이전 토큰은 무효화되며 프로젝트에 새 등록 토큰을 사용해야 합니다.
특정 그룹의 러너 등록 제한#
특정 그룹의 멤버가 러너를 등록할 수 있는지 여부를 제어합니다.
사전 요구 사항:
- 러너 등록 설정에서 그룹 멤버가 러너를 생성할 수 있음 확인란이 선택되어 있어야 합니다.
특정 그룹의 러너 등록을 제한하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 개요 > 그룹을 선택하고 그룹을 찾습니다.
- 편집을 선택합니다.
- 러너 등록 아래에서 새 그룹 러너를 등록할 수 있음 확인란을 해제합니다.
- 변경 사항 저장을 선택합니다.
잡 토큰 권한 설정 액세스#
CI/CD 잡 토큰이 프로젝트에 액세스하는 방법을 제어합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 잡 토큰 권한을 확장합니다.
잡 토큰 허용 목록 적용#
히스토리
- GitLab 17.6에서 도입되었습니다.
모든 프로젝트가 허용 목록을 사용하여 잡 토큰 액세스를 제어하도록 요구합니다.
이 설정이 활성화되면:
- CI/CD 잡 토큰은 토큰의 소스 프로젝트가 허용 목록에 추가된 경우에만 프로젝트에 액세스할 수 있습니다.
- 사용자가 허용 목록을 비활성화하려고 하면 CI/CD 잡 토큰 범위 API가 오류를 반환합니다.
자세한 내용은 프로젝트에 대한 잡 토큰 액세스 제어를 참조하세요.
잡 토큰 허용 목록을 적용하려면:
- 승인된 그룹 및 프로젝트 아래에서 모든 프로젝트에 대해 잡 토큰 허용 목록 활성화 및 적용 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
잡 로그 설정 액세스#
CI/CD 잡 로그가 저장되고 처리되는 방식을 제어합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 잡 로그를 확장합니다.
증분 로깅 구성#
히스토리
Redis를 잡 로그의 임시 캐싱에 사용하고 아카이브된 로그를 오브젝트 스토리지에 점진적으로 업로드합니다. 이는 성능을 개선하고 디스크 공간 사용을 줄입니다.
자세한 내용은 증분 로깅을 참조하세요.
사전 요구 사항:
- CI/CD 아티팩트, 로그, 빌드에 대해 오브젝트 스토리지를 구성해야 합니다.
모든 프로젝트에 대해 증분 로깅을 켜려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 잡 로그 섹션을 확장합니다.
- 증분 로깅 구성 아래에서 증분 로깅 켜기 확인란을 선택합니다.
- 변경 사항 저장을 선택합니다.
CI/CD 카탈로그 설정#
히스토리
- GitLab 18.7에서 도입되었습니다.
CI/CD 카탈로그에 컴포넌트를 게시할 수 있는 프로젝트를 제어합니다.
이 설정에 액세스하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 카탈로그를 확장합니다.
CI/CD 카탈로그 게시 제한#
기본적으로 모든 프로젝트는 CI/CD 카탈로그에 컴포넌트를 게시할 수 있습니다. 허용 목록을 구성하여 게시를 특정 프로젝트로 제한할 수 있습니다.
허용 목록이:
- 비어 있는 경우(기본값): 모든 프로젝트가 카탈로그에 게시할 수 있습니다.
- 프로젝트로 채워진 경우: 허용 목록의 항목과 일치하는 프로젝트만 게시할 수 있습니다.
허용 목록의 항목을 다음으로 정의할 수 있습니다:
- 정확한 프로젝트 경로(예:
my-group/my-project). - 정규 표현식(예:
my-group/.*: 그룹의 모든 프로젝트.my-group/security-.*:security-로 시작하는 프로젝트.
CI/CD 카탈로그 게시 허용 목록을 구성하려면:
- 오른쪽 상단에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > CI/CD를 선택합니다.
- 카탈로그를 확장합니다.
- CI/CD 카탈로그 게시 허용 목록 텍스트 영역에 줄당 하나의 경로 패턴을 입력합니다.
- 변경 사항 저장을 선택합니다.
허용 목록에 없는 프로젝트는 컴포넌트 버전을 게시하려고 할 때 게시 권한 없음 오류를 받습니다.
필수 파이프라인 구성(더 이상 사용되지 않음)#
히스토리
- GitLab 15.9에서 더 이상 사용되지 않음으로 표시되었습니다.
- GitLab 17.0에서 제거되었습니다.
- GitLab 17.4에서
required_pipelines라는 플래그와 함께 재추가되었습니다. 기본적으로 비활성화됩니다.
이 기능은 GitLab 15.9에서 더 이상 사용되지 않음으로 표시되었으며
17.0에서 제거되었습니다. 17.4부터 기본적으로 비활성화된 기능 플래그 required_pipelines 뒤에서만 사용 가능합니다.
대신 규정 준수 파이프라인을 사용하세요. 이 변경 사항은 파괴적 변경입니다.
GitLab 인스턴스의 모든 프로젝트에 필수 파이프라인 구성으로 CI/CD 템플릿을 설정할 수 있습니다. 다음에서 템플릿을 사용할 수 있습니다:
-
기본 CI/CD 템플릿.
-
인스턴스 템플릿 저장소에 저장된 사용자 정의 템플릿.
[!note] 인스턴스 템플릿 저장소에 정의된 구성을 사용할 때 중첩된
include:키워드 (include:file,include:local,include:remote,include:template포함)는 작동하지 않습니다.
파이프라인이 실행될 때 프로젝트 CI/CD 구성이 필수 파이프라인 구성에 병합됩니다. 병합된 구성은 필수 파이프라인 구성이 include 키워드로 프로젝트 구성을 추가한 것과 동일합니다.
프로젝트의 전체 병합된 구성을 보려면 파이프라인 편집기에서 전체 구성 보기를 사용하세요.
필수 파이프라인 구성을 위한 CI/CD 템플릿을 선택하려면:
- 왼쪽 사이드바 하단에서 관리자를 선택합니다.
- 설정 > CI/CD를 선택합니다.
- 필수 파이프라인 구성 섹션을 확장합니다.
- 드롭다운 목록에서 CI/CD 템플릿을 선택합니다.
- 변경 사항 저장을 선택합니다.
