App Runner サービスの作成

AWS App Runner は、コンテナイメージまたはソースコードリポジトリから、自動的にスケールする実行中のウェブサービスへの移行を自動化します。App Runner をソースイメージまたはコードにポイントし、必要な設定を少数のみ指定します。App Runner は、必要に応じてアプリケーションを構築し、コンピューティングリソースをプロビジョニングし、アプリケーションを実行してデプロイします。

サービスを作成すると、App Runner はサービスリソースを作成します。場合によっては、接続リソースを提供する必要があります。App Runner コンソールを使用する場合、コンソールは接続リソースを暗黙的に作成します。App Runner リソースタイプの詳細については、「」を参照してくださいApp Runner リソース。これらのリソースタイプには、各のアカウントに関連付けられたクォータがあります AWS リージョン。詳細については、「App Runner リソースクォータ」を参照してください。

ソースタイプとプロバイダーに応じて、サービスを作成する手順には微妙な違いがあります。このトピックでは、状況に適したものに従うことができるように、これらのソースタイプを作成するさまざまな手順について説明します。コード例を使用して基本的な手順を開始する方法については、「」を参照してくださいApp Runner の開始方法。

前提条件

App Runner サービスを作成する前に、必ず次のアクションを実行してください。

のセットアップ手順を完了しますApp Runner のセットアップ。
アプリケーションソースの準備が完了していることを確認します。GitHub のコードリポジトリ、Bitbucket、または Amazon Elastic Container Registry (Amazon ECR) のコンテナイメージのいずれかを使用して、App Runner サービスを作成できます。

サービスを作成する

このセクションでは、ソースコードに基づくとコンテナイメージに基づくの 2 つの App Runner サービスタイプの作成プロセスについて説明します。

注記

サービスのアウトバウンドトラフィック VPC コネクタを作成すると、次のサービス起動プロセスで 1 回限りのレイテンシーが発生します。この設定は、新しいサービスの作成時または作成後にサービスの更新で設定できます。詳細については、このガイド1 回限りのレイテンシーの「Networking with App Runner」の章の「」を参照してください。

以下のセクションでは、ソースが GitHub または Bitbucket のコードリポジトリである場合に App Runner サービスを作成する方法を示します。コードリポジトリを使用する場合、App Runner はプロバイダーの組織またはアカウントに接続する必要があります。したがって、この接続の確立を支援する必要があります。App Runner 接続の詳細については、「」を参照してくださいApp Runner 接続の管理。

サービスを作成すると、App Runner はアプリケーションコードと依存関係を含む Docker イメージを構築します。次に、このイメージのコンテナインスタンスを実行するサービスを起動します。

App Runner コンソールを使用してコードからサービスを作成する

コンソールを使用して App Runner サービスを作成するには

ソースコードを設定します。
1. App Runner コンソールを開き、リージョンリストでを選択します AWS リージョン。
2. AWS アカウントに App Runner サービスがまだない場合は、コンソールのホームページが表示されます。App Runner サービスの作成を選択します。
  
  に既存のサービス AWS アカウントがある場合、サービスのリストを含むサービスページが表示されます。[Create service (サービスの作成)] を選択します。
3. 「ソースとデプロイ」ページの「ソース」セクションの「リポジトリタイプ」で、「ソースコードリポジトリ」を選択します。
4. プロバイダータイプを選択します。GitHub または Bitbucket を選択します。
5. 次に、以前に使用したプロバイダーのアカウントまたは組織を選択するか、新規追加を選択します。次に、コードリポジトリの認証情報を提供し、接続するアカウントまたは組織を選択するプロセスを実行します。
6. リポジトリで、アプリケーションコードを含むリポジトリを選択します。
7. Branch で、デプロイするブランチを選択します。
8. ソースディレクトリに、アプリケーションコードと設定ファイルを保存するソースリポジトリのディレクトリを入力します。
  
  注記
  ビルドコマンドとスタートコマンドは、指定したソースディレクトリから実行されます。App Runner はルートからの絶対パスとして処理します。ここで値を指定しない場合、ディレクトリはデフォルトでリポジトリルートになります。
デプロイを設定します。
1. デプロイ設定セクションで、手動または自動を選択します。
  
  デプロイ方法の詳細については、「」を参照してくださいデプロイ方法。
2. [Next (次へ)] を選択します。
アプリケーションビルドを設定します。
1. 「ビルドの設定」ページの「設定ファイル」で、リポジトリに App Runner 設定ファイルが含まれていない場合は「ここですべての設定を設定する」を選択するか、含まれている場合は「設定ファイルを使用する」を選択します。
  
  注記
  App Runner 設定ファイルは、アプリケーションソースの一部としてビルド設定を維持する方法です。指定すると、App Runner はファイルからいくつかの値を読み取り、コンソールで設定することはできません。
2. 次のビルド設定を指定します。
  - ランタイム – アプリケーションに特定のマネージドランタイムを選択します。
  - ビルドコマンド – ソースコードからアプリケーションを構築するコマンドを入力します。これは、言語固有のツールまたはコードに付属のスクリプトである場合があります。
  - Start command – ウェブサービスを開始するコマンドを入力します。
  - ポート – ウェブサービスがリッスンする IP ポートを入力します。
3. [Next (次へ)] を選択します。
サービスを設定します。
1. 「サービスの設定」ページの「サービス設定」セクションに、サービス名を入力します。
  
  注記
  他のすべてのサービス設定はオプションであるか、コンソールが提供するデフォルトがあります。
2. 必要に応じて、アプリケーション要件を満たすように他の設定を変更または追加します。
3. [Next (次へ)] を選択します。
確認と作成ページで、入力したすべての詳細を確認し、作成とデプロイを選択します。

結果: サービスが正常に作成されると、コンソールにサービスダッシュボードに新しいサービスの概要が表示されます。
サービスが実行されていることを確認します。
1. サービスダッシュボードページで、サービスのステータスが実行中になるまで待ちます。
2. デフォルトのドメイン値を選択します。これはサービスのウェブサイトへの URL です。
3. ウェブサイトを使用して、正しく実行されていることを確認します。

App Runner API またはを使用してコードからサービスを作成する AWS CLI

App Runner API またはを使用してサービスを作成するには AWS CLI、 CreateService API アクションを呼び出します。詳細と例については、「CreateService」を参照してください。ソースコードリポジトリ (GitHub または Bitbucket) の特定の組織またはアカウントを使用してサービスを初めて作成する場合は、まず CreateConnection を呼び出します。これにより、App Runner とリポジトリプロバイダーの組織またはアカウント間の接続が確立されます。App Runner 接続の詳細については、「」を参照してくださいApp Runner 接続の管理。

呼び出しがを示すサービスオブジェクトで成功したレスポンスを返すと"Status": "CREATING"、サービスの作成が開始されます。

呼び出しの例については、 AWS App Runner API リファレンスの「ソースコードリポジトリサービスの作成」を参照してください。

以下のセクションでは、ソースが Amazon ECR に保存されているコンテナイメージである場合に App Runner サービスを作成する方法を示します。Amazon ECR はです AWS のサービス。したがって、Amazon ECR イメージに基づいてサービスを作成するには、必要な Amazon ECR アクションのアクセス許可を含むアクセスロールを App Runner に提供します。

注記

Amazon ECR Public に保存されているイメージは公開されています。したがって、イメージが Amazon ECR Public に保存されている場合、アクセスロールは必要ありません。

サービスが作成されると、App Runner は指定したイメージのコンテナインスタンスを実行するサービスを起動します。この場合、ビルドフェーズはありません。

詳細については、「ソースイメージに基づく App Runner サービス」を参照してください。

App Runner コンソールを使用してイメージからサービスを作成する

コンソールを使用して App Runner サービスを作成するには

ソースコードを設定します。
1. App Runner コンソールを開き、リージョンリストでを選択します AWS リージョン。
2. AWS アカウントに App Runner サービスがまだない場合は、コンソールのホームページが表示されます。App Runner サービスの作成を選択します。
  
  に既存のサービス AWS アカウントがある場合、サービスのリストを含むサービスページが表示されます。[Create service (サービスの作成)] を選択します。
3. 「ソースとデプロイ」ページの「ソース」セクションの「リポジトリタイプ」で、「コンテナレジストリ」を選択します。
4. Provider で、イメージが保存されているプロバイダーを選択します。
  - Amazon ECR – Amazon ECR に保存されているプライベートイメージ。
  - Amazon ECR Public – Amazon ECR Public に保存されているパブリックに読み取り可能なイメージ。
5. コンテナイメージ URI で、参照を選択します。
6. Amazon ECR コンテナイメージの選択ダイアログボックスのイメージリポジトリで、イメージを含むリポジトリを選択します。
7. イメージタグで、デプロイする特定のイメージタグ (最新など) を選択し、続行を選択します。
デプロイを設定します。
1. デプロイ設定セクションで、手動または自動を選択します。
  
  注記
  App Runner は、Amazon ECR Public イメージ、およびサービスが存在するアカウントとは異なる AWS アカウントに属する Amazon ECR リポジトリ内のイメージの自動デプロイをサポートしていません。
  
  デプロイ方法の詳細については、「」を参照してくださいデプロイ方法。
2. 〔Amazon ECR プロバイダー] ECR アクセスロールの場合は、アカウント内の既存のサービスロールを選択するか、新しいロールの作成を選択します。手動デプロイを使用している場合は、デプロイ時に IAM ユーザーロールを使用することもできます。
3. [Next (次へ)] を選択します。
サービスを設定します。
1. 「サービスの設定」ページの「サービス設定」セクションに、サービス名とサービスウェブサイトがリッスンする IP ポートを入力します。
  
  注記
  他のすべてのサービス設定はオプションであるか、コンソールが提供するデフォルトがあります。
2. （オプション) アプリケーションのニーズに応じて、他の設定を変更または追加します。
3. [Next (次へ)] を選択します。
確認と作成ページで、入力したすべての詳細を確認し、作成とデプロイを選択します。

結果: サービスが正常に作成されると、コンソールにサービスダッシュボードが表示され、新しいサービスの概要が表示されます。
サービスが実行されていることを確認します。
1. サービスダッシュボードページで、サービスのステータスが実行中になるまで待ちます。
2. デフォルトのドメイン値を選択します。これはサービスのウェブサイトへの URL です。
3. ウェブサイトを使用して、正しく実行されていることを確認します。