新規のお客様への AWS Cloud9 の提供は終了しました。AWS Cloud9 の既存のお客様は、通常どおりサービスを引き続き使用できます。詳細はこちら
App Runner サービスの作成
App Runner サービスは、[AWS Explorer] (AWS エクスプローラー) を使用して、AWS ツールキットで作成します。特定の AWS リージョンでサービスを作成することを選択すると、AWS ツールキットのコマンドペインに、アプリケーションの実行先のサービスインスタンスを設定する方法の説明が表示されます。
App Runner サービスを作成する前に、前提条件を満たしていることを確認してください。これには、関連する IAM 権限の提供と、デプロイする特定のソースリポジトリの確認が含まれます。
App Runner サービスを作成するには
-
AWS Explorer を開きます (まだ開いていない場合)。
-
[App Runner] ノードを右クリックして、[Create Service] (サービスの作成) を選択します。
AWS ツールキットのコマンドペインが表示されます。
-
[Select a source code location type] (ソースコードの場所タイプを選択する) では、[ECR] または [Repository] (リポジトリ) を選択します。
[ECR] を選択した場合は、Amazon Elastic Container Registry が管理するリポジトリ内のコンテナイメージを指定します。[Repository] (リポジトリ) を選択した場合は、サポートされているリポジトリプロバイダーが管理するソースコードリポジトリを指定します。現在、App Runner でソースコードリポジトリプロバイダーとしてサポートされているのは、GitHub
です。
-
[Select or enter an image repository] (イメージリポジトリを選択または入力する) では、Amazon ECR プライベートレジストリまたは Amazon ECR Public Gallery によって管理されるイメージリポジトリの URL を選択または入力します。
注記
Amazon ECR Public Gallery からリポジトリを指定する場合は、自動デプロイがオフになっていることを確認してください。App Runner は、ECR Public リポジトリ内のイメージに対する自動デプロイをサポートしていません。
自動デプロイはデフォルトでオフになっています。この場合、コマンドペインヘッダーのアイコンには斜線が表示されます。自動デプロイをオンにすると、このオプションには追加料金がかかることを示すメッセージが表示されます。
-
コマンドペインのステップに「No tags found」 (タグが見つかりません) と表示された場合は、前のステップに戻って、タグ付けされたコンテナイメージを含むリポジトリを選択します。
-
[Port] (ポート) に、サービスが使用する IP ポート (ポート
8000
など) を入力します。 -
(オプション) [Configure environment variables] (環境変数の設定) で、サービスインスタンスの動作のカスタマイズに使用する環境変数が含まれているファイルを指定します。
-
Amazon ECR プライベートレジストリを使用している場合は、ECR アクセスロール (AppRunnerECRAccessRole) が必要です。このロールにより、App Runner は、アカウント内の Amazon Elastic Container Registry (Amazon ECR) イメージにアクセスできます。コマンドペインヘッダーの「+」アイコンを選択して、このロールを作成します。イメージの保存場所が、イメージを公開している Amazon ECR Public である場合、アクセスロールは必要ありません。
-
[Name your service] (サービスの名前) で、一意の名前を入力し、Enter を押します。名前にスペースを含めることはできません。
-
[Select instance configuration] (インスタンス設定の選択) で、サービスインスタンスの CPU ユニットとメモリ (両方とも GB) の組み合わせを選択します。
サービスの作成時に、そのステータスは [Creating] (作成中) から [Running] (実行中) に変わります。
-
サービスの実行が開始されたら、サービスを右クリックしてコンテキストメニューを開き、[Copy Service URL] (サービス URL をコピー) を選択します。
-
デプロイ済みのアプリケーションにアクセスするには、コピーした URL をウェブブラウザのアドレスバーに貼り付けます。
-
[Select a connection] (接続の選択) では、GitHub を AWS にリンクする接続を選択します。選択可能な接続は、App Runner コンソールの [GitHub connections] (GitHub 接続) ページに表示されます。
-
[Select a remote GitHub repository] (リモート GitHub リポジトリの選択) では、リモートリポジトリの URL を選択または入力します。
AWS Cloud9 ソースコントロール管理で設定済みのリモートリポジトリを選択できます。リポジトリがリストにない場合は、リポジトリへのリンクを貼り付けることもできます。
-
[Select a branch] (ブランチの選択) では、デプロイするソースコードの Git ブランチを選択します。
-
[Choose configuration source] (設定ソースの選択) では、ランタイム設定の定義方法を指定します。
[Use configuration file] (設定ファイルを使用) を選択すると、サービスインスタンスは
apprunner.yaml
設定ファイルで定義された設定を使用します。このファイルは、アプリケーションのリポジトリのルートディレクトリにあります。[Configure all settings here] (ここですべて設定する) を選択した場合は、コマンドペインを使用して、以下の項目を指定します。
-
[Runtime] (ランタイム): [Python 3] または [Nodejs 12] を選択します。
-
[Build command] (ビルドコマンド): サービスインスタンスのランタイム環境でアプリケーションをビルドするコマンドを入力します。
-
[Start command] (開始コマンド): サービスインスタンスのランタイム環境でアプリケーションを開始するコマンドを入力します。
-
-
[Port] (ポート) に、サービスが使用する IP ポート (ポート
8000
など)を入力します。 -
(オプション) [Configure environment variables] (環境変数の設定) で、サービスインスタンスの動作のカスタマイズに使用する環境変数が含まれているファイルを指定します。
-
[Name your service] (サービスの名前) で、一意の名前を入力し、Enter を押します。名前にスペースを含めることはできません。
-
[Select instance configuration] (インスタンス設定の選択) では、サービスインスタンスの CPU ユニット数とメモリ (GB) を選択します。
サービスの作成中に、そのステータスは [Creating] (作成中) から [Running] (実行中) に変わります。
-
サービスの実行が開始されたら、サービスを右クリックしてコンテキストメニューを開き、[Copy Service URL] (サービス URL をコピー) を選択します。
-
デプロイ済みのアプリケーションにアクセスするには、コピーした URL をウェブブラウザのアドレスバーに貼り付けます。
注記
App Runner サービスの作成に失敗すると、Explorer でのサービスのステータス表示が [Create failed] (作成に失敗しました) になります。トラブルシューティングの情報については、App Runner デベロッパーガイドの「サービスの作成に失敗した場合」を参照してください。