호스팅 시스템에서 기업은 팀 간에 자체 템플릿을 공유해야 하는 경우가 많습니다. 이 기능을 사용하면 관리자가 인스턴스 전체의 파일 템플릿 컬렉션으로 사용할 프로젝트를 선택할 수 있습니다. 이러한 템플릿은 프로젝트를 안전하게 유지하면서 웹 편집기를 통해 모든 사용자에게 노출됩니다.

구성#

커스텀 템플릿 저장소로 사용할 프로젝트를 선택하려면:

1. 오른쪽 상단 모서리에서 Admin을 선택합니다.
2. 왼쪽 사이드바에서 Settings > Templates를 선택합니다.
3. Templates를 확장합니다.
4. 드롭다운 목록에서 템플릿 저장소로 사용할 프로젝트를 선택합니다.
5. Save changes를 선택합니다.
6. 선택한 저장소에 커스텀 템플릿을 추가합니다.

템플릿을 추가한 후에는 인스턴스 전체에서 사용할 수 있습니다. 웹 편집기와 API 설정을 통해 사용할 수 있습니다.

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

지원되는 파일 유형 및 위치#

GitLab은 이슈 및 머지 리퀘스트 템플릿을 위한 Markdown 파일과 기타 파일 유형 템플릿을 지원합니다.

다음 Markdown 설명 템플릿이 지원됩니다:

자세한 내용은 설명 템플릿을 참조하세요.

기타 지원되는 파일 유형 템플릿은 다음과 같습니다:

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

|-- README.md
    |-- issue_templates
        |-- feature_request.md
    |-- merge_request_templates
        |-- default.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 섹션이 표시되지 않습니다.