인스턴스 템플릿 리포지토리

Tier: Premium, Ultimate

Offering: Self-managed

호스팅 시스템에서 기업은 종종 팀 간에 자신의 템플릿을 공유할 필요가 있습니다.

이 기능은 관리자가 파일 템플릿의 인스턴스 전체 모음을 위한 프로젝트를 선택할 수 있게 합니다.

이러한 템플릿은 프로젝트가 안전하게 유지되는 동안 Web Editor를 통해 모든 사용자가 사용할 수 있도록 공개됩니다.

구성

사용자 정의 템플릿 리포지토리로 사용할 프로젝트를 선택하려면:

  1. 왼쪽 사이드바에서 하단의 Admin을 선택합니다.

  2. Settings > Templates을 선택합니다.

  3. Templates을 확장합니다.

  4. 드롭다운 목록에서 템플릿 리포지토리로 사용할 프로젝트를 선택합니다.

  5. Save changes를 선택합니다.

  6. 선택한 리포지토리에 사용자 정의 템플릿을 추가합니다.

템플릿을 추가한 후에는 전체 인스턴스에서 사용할 수 있습니다.

그들은 Web EditorAPI 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를 통해 새 파일이 추가될 때 드롭다운 목록에 표시됩니다:

새 파일을 생성하기 위한 GitLab UI로, 선택할 Dockerfile 템플릿이 표시된 드롭다운 목록이 나타납니다.

이 기능이 비활성화되거나 템플릿이 존재하지 않으면 선택 드롭다운 목록에 Custom 섹션이 표시되지 않습니다.