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

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

プルリクエストの作成

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

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

注記

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

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

注記

Amazon Bedrock を搭載: AWS 自動不正使用検出を実装Write description for me と Create content summary 機能は 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. 詳細 を選択し、プルリクエストの作成 を選択します。

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

    注記

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

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

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

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

    注記

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

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

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

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