プルリクエストの Web プレビュー - AWS Amplifyホスティング
Web プレビューを有効にするサブドメインによる Web プレビューアクセス

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

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

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

注記

現在、Amplify GitLab のプレビューブランチでは BitBucket、、、AWS CodeCommitと機能がすべて同等ではありません GitHub。AWS_PULL_REQUEST_ID環境変数は、 GitHub リポジトリプロバイダーとして使用する場合にのみ使用できます。

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

PR プレビューのステージ。PR を開くと一意のプレビュー URL が作成され、PR がマージされるとプレビュー URL が削除されることを示します。
重要

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

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

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

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

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

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

  1. [アプリ設定]、[プレビュー] を選択し、[プレビューを有効にする] を選択します。

    注記

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

  2. GitHub リポジトリのみ、 GitHub 次の手順を実行してアカウントにAmplifyアプリをインストールして認証します。

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

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

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

    4. 以下のいずれかを実行します。

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

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

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

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

    ブランチが選択され、右上に [管理] ボタンが表示されているプレビューページ。

  4. 「ブランチプレビュー設定の管理」ウィンドウで、プルリクエストプレビューをオンにします。

  5. フルスタックアプリケーションを行ってください。

    • を選択し、プルリクエストごとに新しいバックエンド環境を作成します。このオプションにより、本番環境に影響を与えずに変更をテストできます。

    • 「このブランチのすべてのプルリクエストを既存の環境に向ける」を選択します。

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

次にブランチのプルリクエストを送信すると、AmplifyはPRをビルドしてプレビューURLにデプロイします。

プレビューページには、固有のプレビュー URL を含む PR に関する情報が表示されます。

GitHub リポジトリの場合のみ、 GitHub アカウントのプルリクエストから URL のプレビューに直接アクセスできます。

GitHub アカウント内のプルリクエストで、「Details」を選択してプレビュー URL を表示できます。

プルリクエストが閉じられると、プレビュー URL が削除され、プルリクエストにリンクされている一時的なバックエンド環境はすべて削除されます。

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

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