あなたのインスタンスのプロジェクトテンプレート
- プラン: Premium、Ultimate
- 提供形態: GitLab Self-Managed、GitLab Dedicated
プロジェクトテンプレートは、新しいプロジェクトにファイルと設定を入力します。あなたのインスタンスでは、管理しているグループからカスタムプロジェクトテンプレートを設定したり、組み込みプロジェクトテンプレートがユーザーに利用可能かどうかを制御したりできます。
カスタムプロジェクトテンプレート
あなたのインスタンスでのプロジェクト作成を高速化するには、テンプレートプロジェクトを含むグループを設定します。ユーザーは、指定した一般的なツールと設定を含む、あなたのテンプレートに基づく新しいプロジェクトを作成できます。
テンプレートプロジェクトからどのようなデータがコピーされるかについては、テンプレートからコピーされるものを参照してください。
テンプレートプロジェクトをあなたのインスタンスで利用可能にする前に、テンプレートを管理するグループを選択します。テンプレートへの予期せぬ変更を防ぐため、既存のグループを再利用するのではなく、この目的のために新しいグループを作成してください。別の目的で作成された既存のグループを再利用すると、メンテナーロールを持つユーザーが、副次効果を理解せずにテンプレートプロジェクトを編集する可能性があります。
テンプレートプロジェクトを管理するグループを選択
前提条件:
- 管理者アクセス権。
あなたのインスタンスのプロジェクトテンプレートを管理するグループを選択するには:
- 右上隅で、管理者を選択します。
- 左サイドバーで、設定 > テンプレートを選択します。
- カスタムプロジェクトテンプレートを展開します。
- 使用するグループを選択します。
- 変更を保存を選択します。
グループをプロジェクトテンプレートのソースとして設定すると、このグループに追加された新しいプロジェクトはテンプレートとして利用できるようになります。
テンプレートとして使用するプロジェクトを設定します
テンプレートプロジェクトを管理するグループを作成したら、各テンプレートプロジェクトの表示レベルと機能の利用可能性を設定します。
前提条件:
- インスタンスの管理者であるか、またはプロジェクトを設定できるロールを持つユーザーである必要があります。
- プロジェクトが直接グループに属しており、サブグループを介していないことを確認してください。選択したグループのサブグループからのプロジェクトは、テンプレートとして使用できません。
- どのユーザーがプロジェクトテンプレートを選択できるかを設定するには、プロジェクトの表示レベルを設定します:
- 公開プロジェクトと内部プロジェクトは、任意の認証済みユーザーが選択できます。
- 非公開プロジェクトは、そのプロジェクトのメンバーのみが選択できます。
- プロジェクトの機能設定を確認します。有効になっているすべてのプロジェクト機能は、GitLab Pagesとセキュリティとコンプライアンスを除き、アクセスできる人すべてに設定する必要があります。
各新しいプロジェクトにコピーされるリポジトリおよびデータベース情報は、GitLabプロジェクトのインポートおよびエクスポートでエクスポートされたデータと同一です。これには、テンプレートプロジェクトからの完全なGitコミット履歴が含まれます。詳細については、ファイルエクスポートを使用してGitLabデータを移行するを参照してください。
コミット履歴なしでテンプレートを作成するには、含めたいすべてのファイルを含む単一のコミットでテンプレートプロジェクトを初期化します。
組み込みのプロジェクトテンプレート
組み込みのプロジェクトテンプレートは、スターターファイルで新しいプロジェクトを作成します。デフォルトでは、これらのテンプレートはすべてのユーザーが利用できます。管理者は、インスタンスに対してこの設定を無効にし、オプションでグループオーナーがそれを上書きできないように強制することができます。グループオーナーも、自分のグループに対してこの設定を制御できます。
その設定はカスケード継承を使用します:
- デフォルトでは、ルートグループはインスタンスの値を継承します。
- サブグループは、最も近い祖先グループから値を継承します。
- グループ固有の値は、継承された値を上書きします。
- インスタンスに対してその設定を強制すると、すべてのグループがそれを継承します。
- グループに対してその設定を強制すると、すべてのサブグループがそれを継承します。
- インスタンスの設定を変更すると、新しい値はすべてのグループにカスケードされます。
- グループ設定を変更すると、新しい値はすべてのサブグループにカスケードされます。
組み込みプロジェクトテンプレートを設定します
前提条件:
- 管理者である必要があります。
インスタンスの組み込みプロジェクトテンプレートを制御するには:
- 右上隅で、管理者を選択します。
- 設定 > テンプレートを選択します。
- 組み込みのプロジェクトテンプレートを展開します。
- 組み込みのプロジェクトテンプレートを有効にするチェックボックスをオンまたはオフにします。
- オプション。グループがこの設定を変更できないようにするには、すべてのグループに適用するチェックボックスをオンにします。
- 変更を保存を選択します。