マージ・リクエストの概念および用語

名前が示すとおり、マージ・リクエストはブランチを別のブランチにマージするリクエストです。ブランチをマージする前に、チーム・メンバーにブランチの更新内容をレビューしてそのフィードバックを共有させることができます。マージ・リクエストでは、レビューおよびマージ・プロセスが1つの簡単なコラボレーション・プロセスに結合されます。

また、関連する問題とビルドを、ブランチのマージ時に自動的に更新またはトリガーされるマージ・リクエストにリンクすることもできます。

このドキュメントでは、マージ・リクエストの機能およびコンポーネントを説明するために使用する用語を次に示します:

用語	説明
ブランチを確認	レビューおよびマージされるブランチ。
ターゲット・ブランチ	レビュー・ブランチがマージされるブランチ。
レビューア	レビュー・ブランチの変更されたファイルのレビューを招待されたプロジェクト・ユーザー。
リクエスタ	マージ・リクエストを作成したプロジェクト・ユーザー。
サブスクライバ	レビューアではないがマージ・リクエストをウォッチしているプロジェクト・ユーザー。
デフォルトのレビューア	レビュー・ブランチとして分岐が選択された場合に、レビュー担当者として自動的に追加されるプロジェクト・ユーザー。ブランチのデフォルト・レビューアを作成できるのは、プロジェクト所有者のみです。
Approved	レビュー・ブランチのソース・コードに加えられた変更に対するオブジェクトを持たないレビューワのフィードバック。
Rejected	レビュー・ブランチのソース・コードに加えられた変更に対するオブジェクトを含むレビューワのフィードバック、およびターゲット・ブランチにレビュー・ブランチをマージしないことの推奨。
一般的なコメント	マージ・リクエストの会話タブのコメントです。
インライン・コメント	レビュー中にファイルの行に追加されるコメント。
保留中(または非公開)コメント	追加した際に公開しなかったインライン・コメント。

マージ・リクエストのワークフローを理解するために、実装する新しい機能を割り当てられたソフトウェア開発者であることを検討してください。次のステップは、マージ・リクエストおよびマージ・ブランチを設定するために実行するアクションをまとめたものです:

ソース・コードGitリポジトリの安定したブランチ(例: main)からブランチを作成します。新しい分岐のファイルを追加または更新して、新しい機能を実装することができます。

これは、コンピュータ上のクローニングされたGitリポジトリまたはVB StudioのGitページで実行できます。
コンピュータで、プロジェクトのGitリポジトリから最新のコンテンツを取得し、新しいブランチをチェックアウトして必要なファイルを更新し、チェックアウトしたブランチをコミットしてプロジェクトのGitリポジトリにプッシュします。
必要に応じて、新しい分岐からアーティファクトを生成するビルド・ジョブを作成し、アプリケーションの安定性を確認します。
新しい分岐をレビュー分岐としてマージ・リクエストを作成し、ターゲット分岐として安定した分岐を作成します。
マネージャおよび他のチーム・メンバーをレビュー担当者として追加します。
マージ・リクエストをクローズするときに機能関連の問題を解決するには、問題をマージ・リクエストにリンクします。
フィードバックの確認に応じて、いくつかのファイルを更新して、ブランチの安定性を確認する必要がある場合があります。レビュー・ブランチのファイルを更新するときにジョブのビルドを自動的にトリガーするには、ジョブをマージ・リクエストにリンクします。
また、リンクされたジョブのフィードバックおよびビルド・ステータスに基づいて、ブランチを安定したブランチでマージするか、破棄できます。ブランチをマージすると、リンクされた問題は自動的に解決されます。

マージ・リクエストに招待されている場合は、更新されたファイルにコメントを追加し、ブランチをマージする異議があるかどうかに関係なくフィードバックを共有できます:

マージ・リクエストを開きます。
レビュー・ブランチに対するコミットを確認し、変更されたファイルを比較してください。
必要に応じて、一般コメントまたはインライン・コメントを追加します。
許容可能なコード更新を検索する場合はフィードバックを「承認済」として送信し、オブジェクトがある場合は「却下」を送信します。

プロジェクト・メンバーであるが、マージ・リクエストに招待されていない場合は、コメントを追加できますが、フィードバックを共有することはできません。

レビュー担当者はマージ・リクエストに追加する必要はありません。レビュー・ブランチに加えた変更にレビューが必要ない場合は、両方のブランチをレビューなしでマージできます。 Gitの使用に慣れている場合は、マージ・リクエストを作成せずにGitクライアントからブランチをマージできます。

リクエストの状態をマージ

マージ・リクエストは、次のいずれかの状態になります:

状態	説明
開く	コード・レビューが進行中です。マージ・リクエストのステータスは、ブランチがマージされるか、リクエストがクローズされるまで、「オープン」または「ドラフト」のままになります。
Draft	マージ・リクエストはコード・レビューの準備ができていません。ドラフト・ステータスは、マージ・アクションをブロックし、レビューアへの通知をミュートし、リンクされたビルドが実行されないようにします。
Merged	コード・レビューが完了し、レビュー・ブランチがターゲット・ブランチとマージされました。レビューはインライン・コメントでは終了しますが、一般的なコメントを受け入れることができます。
Closed	レビュー・ブランチとターゲット・ブランチをマージせずにコード・レビューを閉じます。レビューはインライン・コメントでは終了しますが、一般的なコメントを受け入れることができます。