コミットメッセージテンプレート

GitLabでは、コミットテンプレートを使用して、特定のタイプのコミットのデフォルトのメッセージを作成します。これらのテンプレートは、コミットメッセージが特定の形式に従うように促したり、特定の情報を含めるように促したりします。マージマージリクエストのマージ時に、ユーザーはこれらのテンプレートをオーバーライドできます。

コミットテンプレートの構文は、レビューの提案の構文に似ています。

GitLab Duoは、テンプレートを設定していなくても、マージコミットメッセージの生成を支援できます。

コミットテンプレートを設定する

デフォルトのテンプレートに必要な情報が含まれていない場合は、プロジェクトのコミットテンプレートを変更してください。

前提要件:

• プロジェクトのメンテナーロール以上が必要です。

これを行うには、次の手順に従います。:

1. 左側のサイドバーで、Search or go to（検索または移動先）を選択して、プロジェクトを見つけます。
2. 設定 > マージリクエストを選択します。
3. 作成するテンプレートの種類に応じて、マージコミットのメッセージテンプレートまたはスカッシュコミットのメッセージテンプレートまでスクロールします。
4. 目的のコミットタイプに対して、デフォルトのメッセージを入力します。静的なテキストと変数の両方を使用できます。各テンプレートは500文字に制限されていますが、テンプレートをデータに置き換えた後、最終的なメッセージはより長くなる可能性があります。
5. Save changes（変更を保存）を選択します。

マージコミットのデフォルトテンプレート

マージコミットメッセージのデフォルトテンプレートは次のとおりです。:

Merge branch '%{source_branch}' into '%{target_branch}'

%{title}

%{issues}

See merge request %{reference}

スカッシュコミットのデフォルトテンプレート

マージ時にコミットをスカッシュするようにプロジェクトを設定している場合、GitLabはこのテンプレートを使用してスカッシュコミットメッセージを作成します。:

%{title}

コミットテンプレートでサポートされる変数

コミットメッセージテンプレートは、次の変数をサポートしています。:

空の変数のみを含む行は削除されます。削除された行の前後に空の行がある場合、前の空の行も削除されます。

オープンなマージリクエストでコミットメッセージを編集すると、GitLabはコミットメッセージを自動的に再度更新します。コミットメッセージをプロジェクトテンプレートに復元するには、ページをリロードします。

関連トピック

• スカッシュとマージ。