コード ビューにプル リクエストを使用する

ファイルを追加したり既存のコードを更新したりしたら、そのコードを Bitbucket Cloud のリポジトリにマージできます。ただし、マージを行う前に、そのコードの品質や、既存の機能に影響しないことを確認する必要があります。コードの更新や改善のフィードバックを受け取るために、追加されたすべてのコード行を含むプル リクエストを作成できます。プル リクエストにより、同僚へのコード レビューの依頼と、対象のユーザーの直近のコミットに基づくビルド ステータスの確認を行うことができます。

プル リクエストを使用するには、メインのコード ベースとは別のブランチ (行) でコードを開発できるよう、ブランチまたはフォークを使用する必要があります。 

You can see how pull requests fit into a larger workflow example on the Workflow for Git feature branching help document.

プル リクエスト プロセス

プル リクエストの本質は、コード レビューとコラボレーションです。プル リクエストが複数ある場合、ユーザーはロールに応じて、作成者、レビュアー、またはその両方の作業を行う場合があります。以下は、エンドツーエンド プル リクエスト プロセスの流れを説明しています。

プル リクエストの作成者

作成したプル リクエストを確認するには、[あなたの作業] ダッシュボードの [あなたのプル リクエスト] を確認します。

プル リクエストの作成者がレビュアーを含むプル リクエストを作成すると、コード レビュー プロセスが正式に開始されます。作成時にレビュアーを追加しない場合、あとからいつでもプル リクエストを編集して追加できます。

プル リクエストを作成してレビュワーを追加したら、承認を待ちます。レビュワーがコードを確認してコメントを追加すると、プル リクエストでのディスカッションについてメール通知が送信されます。コメントに返信し、コード レビュー プロセスに能動的に参加することができます。

プル リクエストのレビュワー

レビュー待ちのリクエストを確認するには、[最近の作業] ダッシュボードの [レビュー待ちのプル リクエスト] リストを表示します。レビュアーとして登録されていないプル リクエストに同僚を参加させる場合、ワークスペースのリポジトリの [プル リクエスト] ページに移動します。

ワークスペースのメンバーがユーザーをレビュアーとして追加すると、メール通知が送信されます。プル リクエスト作成の最初の通知のあとは、次のタイミングで通知が送信されます。

• 作成者による更新

• ほかのユーザーからのコメントの追加

• ほかのレビュワーによる承認

• ほかのユーザーによるプル リクエストのマージ

通知を無効化する場合、プル リクエストのウォッチを解除できます。

コード レビューでは、フィードバック、提案、アイデアをコメントとして追加できます。ロジックに問題がないか、すべてのケースが完全に実装されているか、既存の自動化テストを書き換える必要があるか、コードが既存のスタイルガイドに適合しているかどうかなどを確認します。

レビューが完了し、プル リクエストをマージする準備が整ったら (またはマージ前に作成者がタスクを完了できる場合)、右上の [承認] ボタンをクリックします。プル リクエストを承認すると、[レビュアー] フィールドで、レビュアーの名前の横に緑色のチェックマークが表示されます。

既定のレビュワー

[リポジトリの設定] で [既定のレビューア]を設定することで、すべてのプル リクエストに事前に決められたユーザーを自動的に追加するようにリポジトリを設定できます。これにより、すべてのプル リクエストに常に追加されるユーザーのリストを定義できます。たとえば、リポジトリに多数のコントリビューターがいるものの、変更を確認したい所有者が一組しかいない場合にこれが役立ちます。

Another way to predetermine reviewers is by defining owners in a file that you create named CODEOWNERS located in a special configuration directory called .bitbucket. This file allows for fine-grained control over which reviewers are added to which pull requests by examining the files/directories that were changed in the source branch, and looking up the ownership rules in the CODEOWNERS file. For more details on setting up and using code owners, refer to the Set up and use code owners help document.