プルリクエストの作成 - Amazon CodeCatalyst

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

プルリクエストの作成

プルリクエストを作成すると、他のユーザーがコード変更を他のブランチにマージする前にそのコードの変更を確認するのに役立ちます。まず、コード変更のためのブランチを作成します。これは、プルリクエストのソースブランチとして参照されます。リポジトリに変更をコミットしてプッシュしたら、ソースブランチの内容と宛先ブランチの内容を比較するプルリクエストを作成できます。

Amazon CodeCatalyst コンソールで、特定のブランチ、プルリクエストページ、またはプロジェクトの概要からプルリクエストを作成できます。特定のブランチからプルリクエストを作成すると、プルリクエストの作成ページにリポジトリ名とソースブランチが自動的に表示されます。プルリクエストを作成すると、プルリクエストの更新やプルリクエストがマージまたはクローズされたときに、自動的に E メールが送信されます。

注記

プルリクエストの作成中に表示される違いは、ソースブランチの先端と宛先ブランチの先端の違いです。プルリクエストが作成されると、表示される違いは、選択したプルリクエストのリビジョンと、プルリクエストの作成時に送信先ブランチのチップであったコミットの間になります。Git の違いとマージベースの詳細については、Git ドキュメントgit-merge-baseの「」を参照してください。

プルリクエストを作成するときに 説明の書き込み 機能を使用して、Amazon Q にプルリクエストに含まれる変更の説明を自動的に作成させることができます。このオプションを選択すると、Amazon Q はコード変更を含むソースブランチと、これらの変更をマージする宛先ブランチの違いを分析します。次に、これらの変更の概要と、それらの変更の意図と効果に関する最良の解釈を作成します。この機能は、 CodeCatalyst プルリクエストに対して米国西部 (オレゴン) リージョンでのみ使用できます。リンクされたリポジトリのプルリクエストでは、自分の説明を書き込む機能は使用できません。

注記
注記

Amazon Bedrock を搭載：自動不正検出 AWS を実装します。「」の説明を書き込む「コンテンツ概要の作成」、タスクの推奨「」、「Amazon Q を使用してプロジェクト に機能を作成または追加する」、「ソフトウェア開発機能用の Amazon Q デベロッパーエージェントを使用して Amazon Q 機能に問題を割り当てる」が Amazon Bedrock 上に構築されているため、ユーザーは Amazon Bedrock に実装されているコントロールを最大限に活用して、安全性、セキュリティ、人工知能 (AI) の責任ある使用を強制できます。

プルリクエストを作成するには

  1. プロジェクトに移動します。

  2. 次のいずれかを行います。

    • ナビゲーションペインで、コード を選択し、プルリクエスト を選択し、プルリクエストの作成 を選択します。

    • リポジトリのホームページで、その他 を選択し、プルリクエストの作成 を選択します。

    • プロジェクトページで、プルリクエストの作成 を選択します。

  3. ソースリポジトリ で、指定されたソースリポジトリがコミットされたコードを含むリポジトリであることを確認します。このオプションは、リポジトリのメインページからプルリクエストを作成していない場合にのみ表示されます。

  4. 送信先ブランチ で、レビュー後にコードをマージするブランチを選択します。

  5. ソースブランチ で、コミットされたコードを含むブランチを選択します。

  6. プルリクエストのタイトル に、他のユーザーが確認する必要がある内容と理由を理解するのに役立つタイトルを入力します。

  7. （オプション) プルリクエストの説明 で、問題へのリンクや変更の説明などの情報を指定します。

    ヒント

    プルリクエストに含まれる変更の説明 CodeCatalyst を自動的に生成するには、説明の書き込みを選択できます。プルリクエストに追加した後に、自動的に生成された説明を変更することができます。

    この機能を使用するには、生成 AI 機能がスペースに対して有効になっており、リンクされたリポジトリのプルリクエストでは使用できません。詳細については、「生成 AI 機能の管理」を参照してください。

  8. （オプション) 問題 で、問題のリンク を選択し、リストから問題を選択するか、その ID を入力します。問題のリンクを解除するには、リンク解除アイコンを選択します。

  9. （オプション) 必須レビューワー で、必須レビューワー の追加 を選択します。追加するプロジェクトメンバーのリストから選択します。必要なレビューワーは、プルリクエストを宛先ブランチにマージする前に、変更を承認する必要があります。

    注記

    必要なレビューワーとオプションのレビューワーの両方としてレビューワーを追加することはできません。自分をレビューワーとして追加することはできません。

  10. （オプション) オプションのレビュアー で、オプションのレビュアー を追加 を選択します。追加するプロジェクトメンバーのリストから選択します。オプションのレビュアーは、プルリクエストを宛先ブランチにマージする前に、変更を要件として承認する必要はありません。

  11. ブランチの違いを確認します。プルリクエストに表示される違いは、ソースブランチのリビジョンと、プルリクエストの作成時の宛先ブランチのヘッドコミットであるマージベースとの間の変更です。変更が表示されない場合、ブランチは同じであるか、ソースと宛先の両方に同じブランチを選択している可能性があります。

  12. プルリクエストにレビューするコードと変更が含まれていることを確認したら、「 の作成」を選択します。

    注記

    プルリクエストを作成したら、コメントを追加できます。コメントは、プルリクエスト、またはファイルの個々の行、およびプルリクエスト全体に追加できます。ファイルなどのリソースへのリンクは、@ 記号の後にファイルの名前を付けることで追加できます。

ブランチからプルリクエストを作成するには

  1. プルリクエストを作成するプロジェクトに移動します。

  2. ナビゲーションペインで、ソースリポジトリ を選択し、コードの変更があるブランチを含むリポジトリを選択します。

  3. デフォルトのブランチ名の横にあるドロップダウン矢印を選択し、リストから目的のブランチを選択します。リポジトリのすべてのブランチを表示するには、「すべての を表示」を選択します。

  4. More を選択し、Create pull request を選択します。

  5. リポジトリとソースブランチが事前に選択されています。送信先ブランチ で、コードの確認後にマージするブランチを選択します。Pull リクエストタイトル に、他のプロジェクトユーザーが確認する必要がある内容と理由を理解するのに役立つタイトルを入力します。オプションで、プルリクエストの説明 に詳細情報を入力します。例えば、 の関連問題へのリンクへの貼り付け CodeCatalystや、行った変更の説明の追加などです。

    注記

    プルリクエストの作成イベントを実行するように設定されたワークフローは、プルリクエストの送信先ブランチがワークフローで指定されたブランチのいずれかと一致する場合、プルリクエストの作成後に実行されます。

  6. ブランチの違いを確認します。変更が表示されない場合、ブランチは同じであるか、ソースと宛先の両方に同じブランチを選択している可能性があります。

  7. （オプション) 問題 で、問題のリンク を選択し、リストから問題を選択するか、その ID を入力します。問題のリンクを解除するには、リンク解除アイコンを選択します。

  8. （オプション) Required Reviewers で、Add required reviewers を選択します。追加するプロジェクトメンバーのリストから選択します。必要なレビューワーは、プルリクエストを宛先ブランチにマージする前に、変更を承認する必要があります。

    注記

    レビュアーを必須とオプションの両方として追加することはできません。レビュアーとして自分を追加することはできません。

  9. （オプション) オプションレビュアー で、オプションレビュアー の追加 を選択します。追加するプロジェクトメンバーのリストから選択します。オプションのレビュアーは、プルリクエストを送信先ブランチにマージする前に変更を承認する必要はありません。

  10. プルリクエストにレビューする変更が含まれ、必要なレビューワーが含まれていることを確認したら、「 の作成」を選択します。

ブランチがプルリクエストの送信先ブランチと一致するように実行するように設定されたワークフローがある場合、プルリクエストの作成後にプルリクエストの詳細エリアの概要にそれらのワークフロー実行に関する情報が表示されます。詳細については、「ワークフローへのトリガーの追加」を参照してください。