正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

インスタンステンプレートリポジトリ

  • プラン: Premium、Ultimate
  • 提供形態: GitLab Self-Managed、GitLab Dedicated

ホスト型システムでは、企業は多くの場合、チーム間で独自のテンプレートを共有する必要があります。この機能を使用すると、管理者は、インスタンス全体のファイルテンプレートのコレクションとなるプロジェクトを選択できます。これらのテンプレートは、プロジェクトのセキュリティが維持されたまま、Webエディタを介してすべてのユーザーに公開されます。

設定

カスタムテンプレートリポジトリとして機能するプロジェクトを選択するには:

  1. 左側のサイドバーの下部で、管理者を選択します。
  2. 左側のサイドバーの下部にある設定 > テンプレートを選択します。
  3. テンプレートを展開します。
  4. ドロップダウンリストから、テンプレートリポジトリとして使用するプロジェクトを選択します。
  5. 変更を保存を選択します。
  6. 選択したリポジトリにカスタムテンプレートを追加します。

テンプレートを追加すると、インスタンス全体で使用できます。これらは、WebエディタおよびAPI設定で使用できます。

これらのテンプレートは、.gitlab-ci.ymlinclude:templateキーの値として使用できません。

サポートされているファイルの種類と場所

GitLabは、イシュー、マージリクエストテンプレート、およびその他のファイルタイプのテンプレートにMarkdownファイルをサポートしています。

次のMarkdownの説明テンプレートがサポートされています:

ディレクトリ拡張子
イシュー.gitlab/issue_templates.md
マージリクエスト.gitlab/merge_request_templates.md

詳細については、説明テンプレートを参照してください。

その他のサポートされているファイルタイプのテンプレートには、以下が含まれます:

ディレクトリ拡張子
DockerfileDockerfile.dockerfile
.gitignoregitignore.gitignore
.gitlab-ci.ymlgitlab-ci.yml
LICENSELICENSE.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を介して追加されると、カスタムテンプレートがドロップダウンリストに表示されます:

新しいファイルを作成するためのGitLab UI。選択できるDockerfileテンプレートを表示するドロップダウンリストがあります。

この機能が無効になっている場合、またはテンプレートが存在しない場合、選択ドロップダウンリストにカスタムセクションは表示されません。