プルリクエストとコード レビュー
ファイルを追加したり既存のコードを更新したりしたら、そのコードを Bitbucket Cloud のリポジトリにマージできます。ただし、マージを行う前に、そのコードの品質や、既存の機能に影響しないことを確認する必要があります。コードの更新や改善のフィードバックを受け取るために、追加されたすべてのコード行を含むプル リクエストを作成できます。プル リクエストにより、同僚へのコード レビューの依頼と、対象のユーザーの直近のコミットに基づくビルド ステータスの確認を行うことができます。
プル リクエストを使用するには、メインのコード ベースとは別の行でコードを開発できるよう、ブランチまたはフォークを使用する必要があります。
「Git のフィーチャー ブランチ ワークフロー 」ページで、大規模なワークフロー例でプル リクエストを活用する方法を確認できます。
プル リクエスト プロセス
プル リクエストの本質は、コード レビューとコラボレーションです。次の図では、エンドツーエンド プロセスの流れや、プロセス内の各ステップの詳細について説明しています。
レビュー プロセス
プル リクエストの作成後、プル リクエストのマージまでにさまざまなアクションが行われます。
レビュワーは差分を確認して既存のソース コードと変更を比較します。詳細情報
レビュワーが変更にコメントを追加し、作成者がそれに返信して、ディスカッションを行います。詳細情報
すべてのユーザーがコメントからタスクを作成できます。作成者はタスクを完了時に解決できます。詳細情報
作成者はフィードバックに基づいてコードを更新し、新しいコミットをブランチまたはフォークにプッシュしてプル リクエストを更新します。
作成者は、直近のコミットがすべてのテストに合格していることを確認します。詳細情報
レビュワーは変更内容を確認し、プル リクエストを承認します。
プル リクエストが複数ある場合、ユーザーはロールに応じて、作成者、レビュワー、またはその両方の作業を行う場合があります。
プル リクエストの作成者
作成したプル リクエストを確認するには、[Your work] ダッシュボードの [あなたのプル リクエスト] を確認します。
プル リクエストの作成者がレビュワーを含むプル リクエストを作成すると、コード レビュー プロセスが正式に開始されます。作成時にレビュワーを追加しない場合、あとからいつでもプル リクエストを編集して追加できます。
プル リクエストを作成してレビュワーを追加したら、承認を待ちます。レビュワーがコードを確認してコメントを追加すると、プル リクエストでのディスカッションについてメール通知が送信されます。コメントに返信し、コード レビュー プロセスに能動的に参加することができます。
プル リクエストのレビュワー
レビュー待ちのリクエストを確認するには、[最近の作業] ダッシュボードの [レビュー待ちのプル リクエスト] リストを表示します。レビュアーとして登録されていないプル リクエストに同僚を参加させたい場合、ワークスペースのリポジトリの [プル リクエスト] ページに移動します。
ワークスペースのメンバーがユーザーをレビュアーとして追加すると、メール通知が送信されます。プル リクエスト作成の最初の通知のあとは、次のタイミングで通知が送信されます。
- 作成者による更新
- ほかのユーザーからのコメントの追加
- ほかのレビュワーによる承認
- ほかのユーザーによるプル リクエストのマージ
通知を無効化したい場合、プル リクエストのウォッチを解除できます。
コード レビューでは、フィードバック、提案、アイデアをコメントとして追加できます。ロジックに問題がないか、すべてのケースが完全に実装されているか、既存の自動化テストを書き換える必要があるか、コードが既存のスタイルガイドに適合しているかどうかなどを確認します。
レビューが完了し、プル リクエストをマージする準備が整ったら (またはマージ前に作成者がタスクを完了できる場合)、右上の [承認] ボタンをクリックします。プル リクエストを承認すると、[レビュワー] フィールドで、レビュワーの名前の横に緑色のチェックマークが表示されます。
ワークスペースが Premium プランで契約されている場合、リポジトリ管理者は、一定の承認数がないプル リクエストのマージを禁止できます。