マージリクエストの草案

開発者の継続的な作業やスレッドの未解決のために、マージリクエストがまだマージの準備ができていない場合、準備ができたとマークする前に、そのリクエストが受理されないようにすることができます。下書きフラグを付けると、下書きフラグを削除するまでマージボタンを無効にすることができます:

Blocked Merge Button

マージリクエストを下書きとしてマーク

  • GitLab 13.2 で導入された、Work-In-Progress(WIP) のマージリクエストはDraft に名称変更されました。
  • GitLab 14.8でWIPを使うためのすべてのサポートを削除しました。
  • GitLab 13.5 で導入されたMark as draftMark as readyボタン。/draft クイックアクションのトグルは GitLab 15.4 で非推奨
  • GitLab 15.8でドラフトステータスをチェックボックスに変更

マージリクエストにドラフトとしてフラグを立てるにはいくつかの方法があります:

  • マージリクエストを表示します:マージリクエストの右上隅で、下書きとしてマークを選択します。
  • マージリクエストを作成または編集します:マージリクエストのタイトルの先頭に[Draft],Draft: または(Draft) を追加するか、タイトルフィールドの下にある下書きとしてマークを選択します。
  • 既存のマージリクエストにコメントします:/draft クイックアクションをコメントに追加します。マージリクエストを準備完了としてマークするには、/ready を使用します。
  • コミットの作成:マージリクエストのソースブランチを対象としたコミットメッセージの先頭にdraft:Draft:fixup!Fixup! のいずれかを追加します。これはトグルではありません。このテキストを後のコミットで再度追加しても、マージリクエストを準備完了としてマークすることはできません。

マージリクエストにレディマークをつける

マージリクエストがマージできる状態になったら、いくつかの方法でDraft フラグを削除することができます:

  • マージリクエストを表示します:マージリクエストを表示する: マージリクエストの右上隅で、Mark as ready を選択します。少なくとも開発者ロールを持つユーザーは、マージリクエストの説明の一番下までスクロールして、準備完了としてマークを選択することもできます。
  • 既存のマージリクエストを編集します:タイトルの先頭から[Draft]Draft: または(Draft) を削除するか、タイトルフィールドの下にある[下書きとしてマーク]をオフにします。
  • 既存のマージリクエストにコメントします:マージリクエストのコメントに/ready クイックアクションを追加します。

GitLab 13.10 以降では、マージリクエストを準備完了にすると、マージリクエストの参加者やウォッチャーに通知が送られます。

検索時に下書きを含めるか除外するか

プロジェクトのマージリクエストリストを表示または検索するときに、ドラフトマージリクエストを含めたり除外したりすることができます:

  1. プロジェクトに移動し、コード > マージリクエストを選択します。
  2. ナビゲーションバーで、[オープン]、[マージ]、[クローズ]、または[すべて]を選択して、マージリクエストステータスでフィルタします。
  3. 検索ボックスを選択してフィルタのリストを表示し、[下書き]を選択するか、draft と入力します。
  4. = を選択します。
  5. 下書きを含める場合は「はい」、除外する場合は「いいえ」を選択し、Returnを押してマージリクエストのリストを更新します:

    Filter draft merge requests

下書き用パイプライン

下書きマージリクエストは、準備完了とマークされたマージリクエストと同じパイプラインを実行します。

GitLab 15.0 以前では、マージ結果のパイプラインを実行したい場合は、マージリクエストを ready としてマークする必要があります。