AWS App Runner は、2026 年 4 月 30 日以降、新規のお客様に公開されなくなります。App Runner を使用する場合は、その日付より前にサインアップします。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[AWS App Runner 可用性の変更](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# App Runner の開始方法
AWS App Runner は、既存のコンテナイメージまたはソースコードを で実行中のウェブ AWS サービスに直接変換するための、高速でシンプルで費用対効果の高い方法を提供する サービスです AWS クラウド。
このチュートリアルでは、 AWS App Runner を使用してアプリケーションを App Runner サービスにデプロイする方法について説明します。ソースコードとデプロイ、サービスビルド、サービスランタイムの設定について説明します。また、コードバージョンをデプロイする方法、設定変更を行う方法、ログを表示する方法も示します。最後に、チュートリアルの手順に従って作成したリソースをクリーンアップする方法を示します。
**Topics**
+ [前提条件](#getting-started.prereq)
+ [ステップ 1: App Runner サービスを作成する](#getting-started.create)
+ [ステップ 2: サービスコードを変更する](#getting-started.deploy)
+ [ステップ 3: 設定を変更する](#getting-started.config)
+ [ステップ 4: サービスのログを表示する](#getting-started.logs)
+ [ステップ 5：クリーンアップ](#getting-started.cleanup)
+ [次のステップ](#getting-started.next)
## 前提条件
チュートリアルを開始する前に、必ず次のアクションを実行してください。
1. のセットアップ手順を完了します[App Runner のセットアップ](setting-up.md)。
1.
GitHub リポジトリと Bitbucket リポジトリのどちらを使用するかを決定します。
+ Bitbucket を使用するには、[Bitbucket](https://bitbucket.org/) アカウントをまだ作成していない場合は、まず作成します。Bitbucket を初めて使用する場合は、[Bitbucket クラウドドキュメントの「Bitbucket の開始方法](https://support.atlassian.com/bitbucket-cloud/docs/get-started-with-bitbucket-cloud/)」を参照してください。 **
+ GitHub を使用するには、[GitHub](https://github.com/) アカウントをまだお持ちでない場合は作成します。GitHub を初めて使用する場合は、[GitHub ドキュメントの「GitHub の開始方法](https://docs.github.com/en/github/getting-started-with-github)*GitHub*」を参照してください。
**注記**
アカウントから複数のリポジトリプロバイダーへの接続を作成できます。したがって、GitHub リポジトリと Bitbucket リポジトリの両方からデプロイを実行する場合は、この手順を繰り返すことができます。次に、 を使用して新しい App Runner サービスを作成し、他のリポジトリプロバイダー用の新しいアカウント接続を作成します。
1. リポジトリプロバイダーアカウントにリポジトリを作成します。このチュートリアルでは、リポジトリ名 を使用します`python-hello`。次の例で指定された名前とコンテンツを使用して、リポジトリのルートディレクトリにファイルを作成します。
### `python-hello` サンプルリポジトリのファイル
**Example requirements.txt**
```
pyramid==2.0
```
**Example server.py**
```
from wsgiref.simple_server import make_server
from pyramid.config import Configurator
from pyramid.response import Response
import os
def hello_world(request):
name = os.environ.get('NAME')
if name == None or len(name) == 0:
name = "world"
message = "Hello, " + name + "!\n"
return Response(message)
if __name__ == '__main__':
port = int(os.environ.get("PORT"))
with Configurator() as config:
config.add_route('hello', '/')
config.add_view(hello_world, route_name='hello')
app = config.make_wsgi_app()
server = make_server('0.0.0.0', port, app)
server.serve_forever()
```
## ステップ 1: App Runner サービスを作成する
このステップでは、 の一部として GitHub または Bitbucket で作成したサンプルソースコードリポジトリに基づいて App Runner サービスを作成します[前提条件](#getting-started.prereq)。この例には、シンプルな Python ウェブサイトが含まれています。サービスを作成するために実行する主なステップは次のとおりです。
1. ソースコードを設定します。
1. ソースデプロイを設定します。
1. アプリケーションビルドを設定します。
1. サービスを設定します。
1. 確認して確認します。
次の図は、App Runner サービスを作成する手順の概要を示しています。
![\[App Runner サービス作成ワークフロー図\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-service-workflow.png)
**ソースコードリポジトリに基づいて App Runner サービスを作成するには**
1. ソースコードを設定します。
1. [App Runner コンソール](https://console.aws.amazon.com/apprunner)を開き、**リージョン**リストで を選択します AWS リージョン。
1. AWS アカウント に App Runner サービスがまだない場合は、コンソールのホームページが表示されます。**App Runner サービスの作成**を選択します。
![\[サービスの作成ボタンを示す App Runner コンソールのホームページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-home.png)
に既存のサービス AWS アカウント がある場合、**サービス**のリストを含むサービスページが表示されます。[**Create service (サービスの作成)**] を選択します。
![\[App Runner コンソールサービスページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-services.png)
1. **「ソースとデプロイ**」ページの**「ソース**」セクションの**「リポジトリタイプ」で、****「ソースコードリポジトリ**」を選択します。
1. **プロバイダータイプ**を選択します。**GitHub** または **Bitbucket** を選択します。
1. 次に**、新規追加**を選択します。プロンプトが表示されたら、GitHub または Bitbucket の認証情報を入力します。
1. 以前に選択した**プロバイダータイプ**に基づいて、次の一連のステップを選択します。
**注記**
GitHub の AWS コネクタを GitHub アカウントにインストールする次の手順は、1 回限りのステップです。接続を再利用して、このアカウントのリポジトリに基づいて複数の App Runner サービスを作成できます。既存の接続がある場合は、その接続を選択し、リポジトリの選択にスキップします。
Bitbucket アカウントの AWS コネクタにも同じことが当てはまります。App Runner サービスのソースコードリポジトリとして GitHub と Bitbucket の両方を使用している場合は、プロバイダーごとに 1 つの AWS Connector をインストールする必要があります。その後、各コネクタを再利用して、より多くの App Runner サービスを作成できます。
+ **GitHub** の場合は、以下の手順に従います。
1. 次の画面で、**接続名**を入力します。
1. App Runner で GitHub を初めて使用する場合は、**別の のインストール** を選択します。
1. **AWS Connector for GitHub** ダイアログボックスで、プロンプトが表示されたら、GitHub アカウント名を選択します。
1. AWS Connector for GitHub を承認するように求められたら、**AWS 接続の承認**を選択します。
1. **Install AWS Connector for GitHub** ダイアログボックスで、**インストール**を選択します。
アカウント名は、選択した **GitHub アカウント/組織**として表示されます。アカウントでリポジトリを選択できるようになりました。
1. **リポジトリ **で、作成したサンプルリポジトリ を選択します`python-hello`。**Branch** では、リポジトリのデフォルトのブランチ名 (**main** など) を選択します。
1. **Source ディレクトリ**はデフォルト値のままにします。ディレクトリのデフォルトはリポジトリルートです。前の*前提条件*ステップのリポジトリルートディレクトリにソースコードを保存しました。
+ **Bitbucket** の場合は、以下の手順に従います。
1. 次の画面で、**接続名**を入力します。
1. App Runner で Bitbucket を初めて使用する場合は、**別の をインストールする** を選択します。
1. **AWS CodeStar リクエストアクセス**ダイアログボックスで、ワークスペースを選択し、Bitbucket 統合 AWS CodeStar のために へのアクセスを許可できます。ワークスペースを選択し、**アクセス権の付与**を選択します。
1. 次に、 AWS コンソールにリダイレクトされます。Bitbucket アプリケーションが正しい Bitbucket ワークスペースに設定されていることを確認し、**次へ**を選択します。
1. **リポジトリ **で、作成したサンプルリポジトリ を選択します`python-hello`。**Branch** では、リポジトリのデフォルトのブランチ名 (**main** など) を選択します。
1. **Source ディレクトリ**はデフォルト値のままにします。ディレクトリのデフォルトはリポジトリルートです。前の*前提条件*ステップのリポジトリルートディレクトリにソースコードを保存しました。
1. デプロイを設定する: **デプロイ設定**セクションで、**自動** を選択し、**次へ** を選択します。
**注記**
自動デプロイでは、リポジトリソースディレクトリへの新しいコミットごとに、サービスの新しいバージョンが自動的にデプロイされます。
![\[App Runner サービスの作成時のソースとデプロイの設定\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-source-depl.png)
1. アプリケーションビルドを設定します。
1. **「ビルドの設定**」ページの**「設定ファイル**」で、**「ここですべての設定を設定する**」を選択します。
1. 次のビルド設定を指定します。
+ **ランタイム** – **Python 3 **を選択します。
+ **ビルドコマンド** – と入力します**pip install -r requirements.txt**。
+ **Start command** – と入力します**python server.py**。
+ **ポート** – と入力します**8080**。
1. [**次へ**] を選択します。
**注記**
Python 3 ランタイムは、基本 Python 3 イメージとサンプル Python コードを使用して Docker イメージを構築します。次に、このイメージのコンテナインスタンスを実行するサービスを起動します。
![\[App Runner サービスの作成中に設定を構築する\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-build.png)
1. サービスを設定します。
1. **「サービスの設定**」ページの**「サービス設定**」セクションに、サービス名を入力します。
1. **環境変数** で、**環境変数の追加** を選択します。環境変数に次の値を指定します。
+ **ソース** – **プレーンテキスト**を選択する
+ **環境変数名** – **NAME**
+ **環境変数値** – 任意の名前 (名など）。
**注記**
サンプルアプリケーションは、この環境変数で設定した名前を読み取り、ウェブページに名前を表示します。
1. [**次へ**] を選択します。
![\[App Runner サービスの作成中のサービス設定\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-service.png)
1. **確認と作成**ページで、入力したすべての詳細を確認し、**作成とデプロイ**を選択します。
サービスが正常に作成されると、コンソールにサービスダッシュボードが表示され、新しい**サービスの概要**が表示されます。
![\[App Runner サービスダッシュボードページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-dashboard.png)
1. サービスが実行されていることを確認します。
1. サービスダッシュボードページで、サービス**のステータス**が**実行中**になるまで待ちます。
1. **デフォルトのドメイン**値を選択します。これはサービスのウェブサイトへの URL です。
**注記**
App Runner アプリケーションのセキュリティを強化するために、*\$1.awsapprunner.com* ドメインは[パブリックサフィックスリスト (PSL)](https://publicsuffix.org/) に登録されています。セキュリティを強化するために、App Runner アプリケーションのデフォルトのドメイン名に機密 Cookie を設定する必要がある場合は、`__Host-`プレフィックス付きの Cookie を使用することをお勧めします。このプラクティスは、クロスサイトリクエストフォージェリ (CSRF) 攻撃からドメインを防ぐ際に役立ちます。詳細については、Mozilla 開発者ネットワークの「[Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes)」ページを参照してください。
ウェブページが表示されます: **Hello, *your name*\$1**
![\[App Runner サービスのアプリケーションウェブページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-create-webpage.png)
## ステップ 2: サービスコードを変更する
このステップでは、リポジトリソースディレクトリのコードを変更します。App Runner CI/CD 機能は、変更を自動的にビルドしてサービスにデプロイします。
**サービスコードを変更するには**
1. サンプルリポジトリに移動します。
1. という名前のファイルを編集します`server.py`。
1. 変数 に割り当てられた式で`message`、テキストを に変更`Hello`します`Good morning`。
1. 変更を保存してリポジトリにコミットします。
1. 次の手順は、GitHub リポジトリのサービスコードの変更を示しています。
1. サンプル GitHub リポジトリに移動します。
1. ファイル名`server.py`を選択して、そのファイルに移動します。
1. **このファイルの編集** (鉛筆アイコン) を選択します。
1. 変数 に割り当てられた式で`message`、テキストを に変更`Hello`します`Good morning`。
![\[編集アイコンとメッセージが強調表示された GitHub ファイルページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/getting-started-deploy-edit.png)
1. **[Commit changes]** (変更のコミット) を選択します。
1. 新しいコミットが App Runner サービスのデプロイを開始します。サービスダッシュボードページで、サービス**のステータス**が**進行中のオペレーション**に変わります。
デプロイが終了するのを待ちます。サービスダッシュボードページで、サービス**のステータス**が**実行中**に戻ります。
1. デプロイが成功したことを確認する: サービスのウェブページが表示されるブラウザタブを更新します。
このページには、変更後のメッセージ**「おはよう、*名前*」が表示されるようになりました。**
## ステップ 3: 設定を変更する
このステップでは、**NAME**環境変数値を変更して、サービス設定の変更を示します。
**環境変数の値を変更するには**
1. [App Runner コンソール](https://console.aws.amazon.com/apprunner)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、**サービス**を選択し、App Runner サービスを選択します。
コンソールには、サービスダッシュボードに**サービスの概要**が表示されます。
![\[アクティビティリストを表示する App Runner サービスダッシュボードページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/console-dashboard.png)
1. サービスダッシュボードページで、**設定**タブを選択します。
コンソールには、サービス設定がいくつかのセクションに表示されます。
1. **サービスの設定**セクションで、**編集**を選択します。
![\[App Runner サービスダッシュボードページの設定タブのサービス設定セクション\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/service-dashboad-config-service.png)
1. キー を持つ環境変数の場合**NAME**、値を別の名前に変更します。
1. [**Apply changes (変更の適用)**] を選択します。
App Runner は更新プロセスを開始します。サービスダッシュボードページで、サービス**のステータス****が進行中のオペレーション**に変わります。
1. 更新が終了するのを待ちます。サービスダッシュボードページで、サービス**のステータス**が**実行中**に戻ります。
1. 更新が成功したことを確認します。サービスのウェブページが表示されるブラウザタブを更新します。
このページに、変更後の名前**「おはよう、*新しい名前*」が表示されるようになりました。**
## ステップ 4: サービスのログを表示する
このステップでは、App Runner コンソールを使用して App Runner サービスのログを表示します。App Runner はログを Amazon CloudWatch Logs (CloudWatch Logs) にストリーミングし、サービスのダッシュボードに表示します。App Runner ログの詳細については、「」を参照してください[CloudWatch Logs にストリーミングされた App Runner ログの表示](monitor-cwl.md)。
**サービスのログを表示するには**
1. [App Runner コンソール](https://console.aws.amazon.com/apprunner)を開き、**リージョン**リストで を選択します AWS リージョン。
1. ナビゲーションペインで、**サービス**を選択し、App Runner サービスを選択します。
コンソールには、サービスダッシュボードに**サービスの概要**が表示されます。
![\[アクティビティリストを表示する App Runner サービスダッシュボードページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/console-dashboard.png)
1. サービスダッシュボードページで、**ログ**タブを選択します。
コンソールには、いくつかのセクションにいくつかのタイプのログが表示されます。
+ **イベントログ** – App Runner サービスのライフサイクルにおけるアクティビティ。コンソールに最新のイベントが表示されます。
+ **デプロイログ** – App Runner サービスへのソースリポジトリのデプロイ。コンソールには、デプロイごとに個別のログストリームが表示されます。
+ **アプリケーションログ** – App Runner サービスにデプロイされたウェブアプリケーションの出力。コンソールは、実行中のすべてのインスタンスからの出力を 1 つのログストリームに結合します。
![\[App Runner サービスダッシュボードページのログタブ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/service-dashboad-logs.png)
1. 特定のデプロイを検索するには、検索語を入力してデプロイログリストの範囲を絞り込みます。テーブルに表示される任意の値を検索できます。
1. ログの内容を表示するには、**フルログの表示** (イベントログ) またはログストリーム名 (デプロイログとアプリケーションログ) を選択します。
1. **ダウンロード**を選択してログをダウンロードします。デプロイログストリームの場合は、まずログストリームを選択します。
1. **CloudWatch で表示** を選択して CloudWatch コンソールを開き、その完全な機能を使用して App Runner サービスログを調べます。デプロイログストリームの場合は、まずログストリームを選択します。
**注記**
CloudWatch コンソールは、結合されたアプリケーションログではなく、特定のインスタンスのアプリケーションログを表示する場合に特に便利です。
## ステップ 5：クリーンアップ
これで、App Runner サービスの作成、ログの表示、およびいくつかの変更を行う方法を学習しました。このステップでは、サービスを削除して、不要になったリソースを削除します。
**サービスを削除するには**
1. サービスダッシュボードページで、**アクション**を選択し、**サービスの削除**を選択します。
1. 確認ダイアログで、リクエストされたテキストを入力し、**削除**を選択します。
結果: コンソールは**サービス**ページに移動します。削除したサービスのステータスが **DELETING** と表示されます。しばらくすると、リストから消えます。
このチュートリアルの一部として作成した GitHub および Bitbucket 接続の削除も検討してください。詳細については、「[App Runner 接続の管理](manage-connections.md)」を参照してください。
## 次のステップ
最初の App Runner サービスをデプロイしたので、以下のトピックで詳細を確認してください。
+ [App Runner のアーキテクチャと概念](architecture.md) – App Runner に関連するアーキテクチャ、主要な概念、 AWS リソース。
+ [イメージベースのサービス](service-source-image.md) および [コードベースのサービス](service-source-code.md) – App Runner がデプロイできる 2 種類のアプリケーションソース。
+ [App Runner のアプリケーションコードの開発](develop.md) – App Runner にデプロイするアプリケーションコードを開発または移行するときに知っておくべきこと。
+ [App Runner コンソールの使用](console.md) – App Runner コンソールを使用してサービスを管理およびモニタリングします。
+ [App Runner サービスの管理](manage.md) – App Runner サービスのライフサイクルを管理します。
+ [App Runner サービスのオブザーバビリティ](monitor.md) – メトリクスのモニタリング、ログの読み取り、イベントの処理、サービスアクション呼び出しの追跡、HTTP 呼び出しなどのアプリケーションイベントのトレースを行うことで、App Runner サービスオペレーションを可視化します。
+ [App Runner 設定ファイル](config-file.md) – App Runner サービスのビルドおよびランタイム動作のオプションを指定する設定ベースの方法です。
+ [App Runner API](api.md) – App Runner アプリケーションプログラミングインターフェイス (API) を使用して、App Runner リソースを作成、読み取り、更新、削除します。
+ [App Runner のセキュリティ](security.md) – App Runner やその他の サービスの使用中に と がクラウドセキュリティ AWS を確保するさまざまな方法。