プルリクエストのレビュー
Amazon CodeCatalyst コンソールを使用して、プルリクエストに含まれる変更を共同でレビューし、コメントすることができます。ソースブランチとターゲットブランチの違いについて、またプルリクエストのリビジョン間の違いについて、コードの個々の行にコメントを追加できます。プルリクエストのコード変更に残されたコメントの概要を作成すると、他のユーザーが残したフィードバックをすばやく理解できます。コードを操作する開発環境を作成することもできます。
注記
注記
Amazon Bedrock を搭載: AWS は不正使用の自動検出を実装します。Amazon Q Developer Agent for Software Development の「説明を記述する」、「内容の要約を作成する」、「タスクを提案する」、「Amazon Q を使用してプロジェクトに機能を作成または追加する」、「Amazon Q に問題を割り当てる」機能は Amazon Bedrock を基盤に構築されているため、ユーザーは Amazon Bedrock に実装されている統制を最大限に活用して、AI の安全性、セキュリティ、責任ある使用を徹底することができます。
ヒント
プロファイルの一部として、E メールを受信するプルリクエストイベントを設定できます。詳細については、「CodeCatalyst からの Slack 通知および E メール通知を送信する」を参照してください。
プルリクエストは、プルリクエストのリビジョンと、プルリクエストの作成時にターゲットブランチの先端であったコミットとの間の違いを示します。これはマージベースと呼ばれます。Git の違いとマージベースの詳細については、Git ドキュメントの「git-merge-base
ヒント
コンソールで作業する場合、特にプルリクエストをしばらく開いたままにしていた場合は、プルリクエストのレビューを開始する前に、ブラウザを更新してプルリクエストが最新のリビジョンであることを確認してください。
CodeCatalyst コンソールでプルリクエストをレビューするには
-
プロジェクトに移動します。
-
次のいずれかを実行してプルリクエストに移動します。
-
プルリクエストがプロジェクトページにリストされている場合は、リストから選択します。
-
プルリクエストがプロジェクトページに表示されていない場合は、[すべて表示] を選択します。フィルターとソートを使用してプルリクエストを見つけて、リストから選択します。
-
ナビゲーションペインで、[コード] を選択し、[プルリクエスト] を選択します。
-
-
レビューするプルリクエストをリストから選択します。フィルターバーに名前の一部を入力すると、プルリクエストのリストをフィルタリングできます。
-
[概要] では、プルリクエストの名前とタイトルを確認できます。コメントを作成したり、プルリクエストに残されたコメントを表示したりできます。プルリクエストの詳細を表示できます。ワークフローの実行、リンクされた問題、レビュアー、プルリクエストの作成者、実行可能なマージ戦略に関する情報などを確認できます。
注記
特定のコード行に残されたコメントは [変更] に表示されます。
-
(オプション) プルリクエスト全体に適用されるコメントを追加するには、[プルリクエストのコメント] を展開し、[コメントの作成] を選択します。
-
(オプション) このプルリクエストのリビジョンの変更に残されたすべてのコメントの概要を表示するには、[コメントの要約を作成する] を選択します。
注記
この機能を使用するには、スペースで生成 AI 機能が有効になっている必要があり、これは米国西部 (オレゴン) リージョンでのみ利用できます。詳細については、「Managing generative AI features」を参照してください。
-
[変更] では、ターゲットブランチとプルリクエストの最新リビジョンの違いを確認できます。リビジョンが複数ある場合は、比較するリビジョンを変更できます。リビジョンの詳細については、「リビジョン」を参照してください。
ヒント
[変更されたファイル] では、プルリクエストで変更されたファイルの数や、コメントが残されたファイルを、すばやく確認できます。フォルダの横に表示されるコメントの数は、そのフォルダ内のファイルに対するコメントの数を示します。フォルダを展開すると、フォルダ内の各ファイルのコメント数が表示されます。
-
違いの表示方法を変更するには、[統合] または [分割] を選択します。
-
プルリクエストの行にコメントを追加するには、コメントする行に移動します。その行の横に表示されるコメント用アイコンを選択し、コメントを入力して、[保存] を選択します。
-
プルリクエストのリビジョン間、またはそのソースブランチとターゲットブランチ間の変更を表示するには、[比較] で使用可能なオプションから選択します。リビジョンの行に対するコメントは、それらのリビジョンに保持されます。
-
プルリクエストトリガーでコードカバレッジレポートを生成するようにワークフローを設定している場合、関連するプルリクエストの、行とブランチカバレッジの検出結果を表示できます。コードカバレッジの検出結果を非表示にするには、[コードカバレッジの非表示] を選択します。詳細については、「コードカバレッジレポート」を参照してください。
プルリクエストのコードを変更する場合は、プルリクエストから開発環境を作成できます。[開発環境を作成] を選択します。必要に応じて、開発環境の名前を追加するか、設定を編集して [作成] を選択します。
-
[レポート] では、このプルリクエストの品質レポートを表示できます。リビジョンが複数ある場合は、比較するリビジョンを変更できます。レポートは、名前、ステータス、ワークフロー、アクション、タイプでフィルタリングできます。
注記
プルリクエストでレポートを表示するには、レポートを生成するようにワークフローを設定する必要があります。詳細については、「アクションにおける品質レポートの設定」を参照してください。
-
特定のレポートを表示するには、リストから選択します。詳細については、「ワークフローを使用したテスト」を参照してください。
-
このプルリクエストのレビュアーが、変更を承認する場合は、最新のリビジョンが表示されていることを確認してから、[承認] を選択します。
注記
すべての必須のレビュアーがプルリクエストを承認してから、マージを行う必要があります。
