인스턴스 템플릿 리포지토리
Offering: Self-managed
호스팅 시스템에서 기업은 종종 팀 간에 자신의 템플릿을 공유할 필요가 있습니다.
이 기능은 관리자가 파일 템플릿의 인스턴스 전체 모음을 위한 프로젝트를 선택할 수 있게 합니다.
이러한 템플릿은 프로젝트가 안전하게 유지되는 동안 Web Editor를 통해 모든 사용자가 사용할 수 있도록 공개됩니다.
구성
사용자 정의 템플릿 리포지토리로 사용할 프로젝트를 선택하려면:
-
왼쪽 사이드바에서 하단의 Admin을 선택합니다.
-
Settings > Templates을 선택합니다.
-
Templates을 확장합니다.
-
드롭다운 목록에서 템플릿 리포지토리로 사용할 프로젝트를 선택합니다.
-
Save changes를 선택합니다.
-
선택한 리포지토리에 사용자 정의 템플릿을 추가합니다.
템플릿을 추가한 후에는 전체 인스턴스에서 사용할 수 있습니다.
그들은 Web Editor와 API settings를 통해 사용할 수 있습니다.
이 템플릿은 .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를 통해 새 파일이 추가될 때 드롭다운 목록에 표시됩니다:
이 기능이 비활성화되거나 템플릿이 존재하지 않으면 선택 드롭다운 목록에 Custom 섹션이 표시되지 않습니다.