インスタンステンプレートリポジトリ
- プラン: Premium、Ultimate
- 提供形態: GitLab Self-Managed、GitLab Dedicated
ホスト型システムでは、企業は多くの場合、チーム間で独自のテンプレートを共有する必要があります。この機能を使用すると、管理者は、インスタンス全体のファイルテンプレートのコレクションとなるプロジェクトを選択できます。これらのテンプレートは、プロジェクトのセキュリティが維持されたまま、Webエディタを介してすべてのユーザーに公開されます。
設定
カスタムテンプレートリポジトリとして機能するプロジェクトを選択するには:
- 左側のサイドバーの下部で、管理者を選択します。
- 左側のサイドバーの下部にある設定 > テンプレートを選択します。
- テンプレートを展開します。
- ドロップダウンリストから、テンプレートリポジトリとして使用するプロジェクトを選択します。
- 変更を保存を選択します。
- 選択したリポジトリにカスタムテンプレートを追加します。
テンプレートを追加すると、インスタンス全体で使用できます。これらは、WebエディタおよびAPI設定で使用できます。
これらのテンプレートは、.gitlab-ci.ymlのinclude:templateキーの値として使用できません。
サポートされているファイルの種類と場所
GitLabは、イシュー、マージリクエストテンプレート、およびその他のファイルタイプのテンプレートにMarkdownファイルをサポートしています。
次のMarkdownの説明テンプレートがサポートされています:
| 型 | ディレクトリ | 拡張子 |
|---|---|---|
| イシュー | .gitlab/issue_templates | .md |
| マージリクエスト | .gitlab/merge_request_templates | .md |
詳細については、説明テンプレートを参照してください。
その他のサポートされているファイルタイプのテンプレートには、以下が含まれます:
| 型 | ディレクトリ | 拡張子 |
|---|---|---|
Dockerfile | Dockerfile | .dockerfile |
.gitignore | gitignore | .gitignore |
.gitlab-ci.yml | gitlab-ci | .yml |
LICENSE | LICENSE | .txt |
各テンプレートは、それぞれのサブディレクトリにあり、正しい拡張子を持ち、空であってはなりません。階層は次のようになります:
|-- 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を介して追加されると、カスタムテンプレートがドロップダウンリストに表示されます:
この機能が無効になっている場合、またはテンプレートが存在しない場合、選択ドロップダウンリストにカスタムセクションは表示されません。
