인스턴스 템플릿 저장소

Tier: 프리미엄, 얼티메이트 Offering: Self-managed

호스팅된 시스템에서 기업은 종종 팀간에 자체 템플릿을 공유해야 할 필요가 있습니다. 이 기능은 관리자가 프로젝트를 선택하여 파일 템플릿의 인스턴스 전체 컬렉션으로 만들 수 있게 합니다. 이러한 템플릿은 프로젝트가 안전한 상태를 유지하면서 모든 사용자에게 웹 에디터를 통해 노출됩니다.

구성

사용자 정의 템플릿 저장소로 사용할 프로젝트를 선택하려면 다음을 수행하세요:

  1. 왼쪽 사이드바에서 가장 아래쪽에 있는 관리자(Admin)를 선택합니다.
  2. 설정(Settings) > 템플릿(Templates)을 선택합니다.
  3. 템플릿(Templates)을 확장합니다.
  4. 드롭다운 목록에서 템플릿 저장소로 사용할 프로젝트를 선택합니다.
  5. 변경 사항 저장(Save changes)을 선택합니다.
  6. 선택한 저장소에 사용자 정의 템플릿을 추가합니다.

템플릿을 추가한 후에는 해당 템플릿을 인스턴스 전체에 사용할 수 있습니다. 이 템플릿은 웹 에디터 및 API 설정을 통해 이용할 수 있습니다.

이러한 템플릿은 .gitlab-ci.yml의 include:template 키의 값으로 사용할 수 없습니다.

지원되는 파일 유형 및 위치

템플릿은 해당 템플릿의 종류에 대응하는 저장소의 특정 하위 디렉토리에 추가해야 합니다. 다음 유형의 사용자 정의 템플릿이 지원됩니다:

유형 디렉터리 확장자
Dockerfile Dockerfile .dockerfile
.gitignore gitignore .gitignore
.gitlab-ci.yml gitlab-ci .yml
LICENSE LICENSE .txt

각 템플릿은 해당 하위 디렉토리에 들어가야 하며 올바른 확장자를 가지고 있어야 합니다. 따라서 계층 구조는 다음과 같아야 합니다: 

|-- README.md
|-- Dockerfile
    |-- custom_dockerfile.dockerfile
    |-- another_dockerfile.dockerfile
|-- gitignore
    |-- custom_gitignore.gitignore
    |-- another_gitignore.gitignore
|-- gitlab-ci
    |-- custom_gitlab-ci.yml
    |-- another_gitlab-ci.yml
|-- LICENSE
    |-- custom_license.txt
    |-- another_license.txt

새 파일을 GitLab UI를 통해 추가할 때 사용자 정의 템플릿이 드롭다운 목록에 표시됩니다:

Dockerfile 템플릿을 선택할 수 있는 드롭다운 목록이 있는 새 파일을 생성하는 GitLab UI.

이 기능이 비활성화되었거나 템플릿이 없는 경우 선택 드롭다운 목록에 사용자 정의 섹션이 표시되지 않습니다.