인스턴스 템플릿 리포지터리
호스팅된 시스템에서 기업은 종종 팀간에 자체 템플릿을 공유해야 할 필요가 있습니다. 이 기능을 사용하면 관리자가 프로젝트를 선택하여 파일 템플릿의 인스턴스 전체 컬렉션으로 만들 수 있습니다. 그런 다음 이러한 템플릿은 프로젝트가 안전한 상태로 유지되는 동안 모든 사용자에게 웹 편집기를 통해 노출됩니다.
구성
사용자 정의 템플릿 리포지터리로 사용할 프로젝트를 선택하려면:
- 왼쪽 사이드바에서 맨 아래쪽에 있는 관리 영역을 선택합니다.
- 설정 > 템플릿을 선택합니다.
- 템플릿을 확장합니다.
- 드롭다운 디렉터리에서 템플릿 리포지터리로 사용할 프로젝트를 선택합니다.
- 변경 사항 저장을 선택합니다.
- 선택한 리포지터리에 사용자 정의 템플릿을 추가합니다.
템플릿을 추가한 후에는 인스턴스 전체에서 사용할 수 있습니다. 웹 편집기 및 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를 통해 추가될 때 드롭다운 디렉터리에 표시됩니다:
이 기능이 비활성화되었거나 템플릿이 없는 경우 선택 드롭다운 디렉터리에 사용자 정의 섹션이 표시되지 않습니다.