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

Web プレビューは、開発チームや品質保証 (QA) チームに、コードをプロダクションブランチやインテグレーションブランチにマージする前に、プルリクエスト (PR) からの変更をプレビューする方法を提供します。プルリクエストを使うと、リポジトリ内のブランチにプッシュした変更を他の人に伝えることができます。プルリクエストが開かれたら、変更の可能性についてコラボレーターと話し合ったりレビューしたり、変更がベースブランチにマージされる前にフォローアップコミットを追加したりできます。

Web プレビューは、リポジトリに対して行われたすべてのプルリクエストを、メインサイトが使用している URL とはまったく異なる固有のプレビュー URL にデプロイします。Amplify CLI または Amplify Studio を使用してプロビジョニングされたバックエンド環境を持つアプリの場合、プルリクエスト (プライベート Git リポジトリのみ) ごとに一時的なバックエンドが作成され、PR が閉じられたときに削除されます。

アプリでウェブプレビューを有効にすると、各 PR はアプリごとに 50 ブランチの Amplify クォータにカウントされます。このクォータを超えないようにするには、PRsを必ず閉じてください。クォータの詳細については、「Amplify ホスティングService Quotas」を参照してください。

注記

現在、 をリポジトリプロバイダー AWS CodeCommit として使用する場合、 AWS_PULL_REQUEST_ID環境変数は使用できません。

Web プレビューを有効にする

GitHub リポジトリに保存されているアプリの場合、プレビューではリポジトリアクセスに Amplify GitHub アプリを使用します。アクセスのために OAuth を使用して GitHub リポジトリから以前にデプロイした既存の Amplify アプリでウェブプレビューを有効にする場合は、まず Amplify GitHub アプリを使用するようにアプリを移行する必要があります。移行手順については、既存の OAuth アプリを Amplify GitHub アプリに移行するを参照してください。

重要

セキュリティ上の理由から、プライベートリポジトリを持つすべてのアプリで Web プレビューを有効にできますが、パブリックリポジトリを持つすべてのアプリでは有効にできません。Git リポジトリが公開されている場合、IAM サービスロールを必要としないアプリにのみプレビューを設定できます。

例えば、バックエンドを備えたアプリやWEB_COMPUTEホスティングプラットフォームにデプロイされるアプリには IAM サービスロールが必要です。そのため、これらの種類のアプリのリポジトリが公開されている場合、Web プレビューを有効にすることはできません。

Amplify はこの制限を適用して、アプリのIAMロール権限を使用して実行されるような任意のコードを第三者が送信することを防ぎます。

プルリクエストの Web プレビューを有効にするには

1. ホスティング を選択し、 をプレビューします。

   注記

   [プレビュー]は、アプリが継続的デプロイ用に設定され、Git リポジトリに接続されている場合にのみ[アプリ設定]メニューに表示されます。この種類のデプロイの手順については、「既存のコードを使い始める」を参照してください。

2. GitHub リポジトリの場合のみ、次の操作を実行して、アカウントに Amplify GitHub アプリをインストールして承認します。

   1. GitHub アプリをインストールしてプレビューを有効にするウィンドウで、 GitHub アプリのインストール を選択します。

   2. Amplify GitHub アプリを設定する GitHub アカウントを選択します。

   3. GitHub.com で、アカウントのリポジトリ権限を設定するページが開きます。

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

      • インストールをすべてのリポジトリに適用するには、「全てのリポジトリ」を選択します。

      • 選択した特定のリポジトリのみにインストールを制限するには、[リポジトリのみ選択] を選択します。Web プレビューを有効にするアプリのリポジトリを、選択するリポジトリに必ず含めてください。

   5. [保存] を選択します。

3. リポジトリのプレビューを有効にしたら、Amplify コンソールに戻って特定のブランチのプレビューを有効にします。プレビューページで、リストからブランチを選択し、設定の編集を選択します。

4. プレビュー設定の管理ページで、プルリクエストプレビュー をオンにします。[Confirm] (確認) を選択します。

5. フルスタックのアプリケーションでは、以下のいずれかを行ってください。

   • [プルリクエストごとに新しいバックエンド環境を作成] を選択します。このオプションを使うと、本番環境に影響を及ぼすことなく変更をテストできます。

   • [このブランチのすべてのプルリクエストを既存の環境に限定する] を選択します。

6. [確認] を選択します。

次にブランチのプルリクエストを送信すると、Amplify はPRをビルドしてプレビューURLにデプロイします。プルリクエストがクローズされると、プレビュー URL は削除され、プルリクエストにリンクされている一時的なバックエンド環境はすべて削除されます。 GitHub リポジトリの場合、 GitHub アカウントのプルリクエストから直接 URL のプレビューにアクセスできます。

サブドメインによる Web プレビューアクセス

プルリクエストのウェブプレビューには、Amazon Route 53 によって管理されるカスタムドメインに接続されている Amplify アプリケーションのサブドメインからアクセスできます。プルリクエストがクローズされると、そのプルリクエストに関連するブランチとサブドメインは自動的に削除されます。これは、アプリにパターンベースの機能ブランチのデプロイを設定した後の Web プレビューのデフォルト動作です。自動サブドメインをセットアップする手順については、「Amazon Route 53 カスタムドメインに自動サブドメインを設定します。」を参照してください。