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 サービスを作成する](manage-create.md)ときは、さまざまな設定値を設定します。これらの設定の一部は、サービスの作成後に変更できます。その他の設定は、サービスの作成中にのみ適用でき、それ以降は変更できません。このトピックでは、App Runner API、App Runner コンソール、および App Runner 設定ファイルを使用したサービスの設定について説明します。
**Topics**
+ [App Runner API または を使用してサービスを設定する AWS CLI](#manage-configure.api)
+ [App Runner コンソールを使用してサービスを設定する](#manage-configure.console)
+ [App Runner 設定ファイルを使用してサービスを設定する](#manage-configure.file)
+ [サービスのオブザーバビリティの設定](manage-configure-observability.md)
+ [共有可能なリソースを使用したサービス設定の構成](manage-configure-resources.md)
+ [サービスのヘルスチェックの設定](manage-configure-healthcheck.md)
## App Runner API または を使用してサービスを設定する AWS CLI
API は、サービスの作成後に変更できる設定を定義します。次のリストでは、関連するアクション、タイプ、制限について説明します。
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) アクション – 作成後に呼び出して、一部の設定を更新できます。
+ *更新可能* – `SourceConfiguration`、、`InstanceConfiguration`および `HealthCheckConfiguration`パラメータの設定を更新できます。ただし、 では`SourceConfiguration`、ソースタイプをコードからイメージ、またはその逆に切り替えることはできません。サービスの作成時に指定したのと同じリポジトリパラメータを指定する必要があります。これは `CodeRepository`または のいずれかです`ImageRepository`。
サービスに関連付けられた個別の設定リソースの次の ARNs を更新することもできます。
+ `AutoScalingConfigurationArn`
+ `VpcConnectorArn`
+ *更新不可* – [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) アクションで使用できる `ServiceName`および `EncryptionConfiguration`パラメータを変更することはできません。作成後に変更することはできません。[UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) アクションには、これらのパラメータは含まれません。
+ *API と ファイル* – [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html) タイプの `ConfigurationSource`パラメータ ( の一部としてソースコードリポジトリに使用`SourceConfiguration`) を に設定できます`Repository`。この場合、App Runner は の設定を無視し`CodeConfigurationValues`、リポジトリの設定[ファイル](config-file.md)からこれらの設定を読み取ります。`ConfigurationSource` を に設定すると`API`、App Runner は API コールからすべての設定を取得し、設定ファイルが存在する場合でも無視します。
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html) アクション – サービスの作成後に呼び出して、サービスにタグを追加したり、既存のタグの値を更新したりできます。
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html) アクション – サービスの作成後に呼び出して、サービスからタグを削除できます。
**注記**
サービスのアウトバウンドトラフィック VPC コネクタを作成すると、次のサービス起動プロセスで 1 回限りのレイテンシーが発生します。この設定は、新しいサービスの作成時または作成後にサービスの更新で設定できます。詳細については、このガイド[1 回限りのレイテンシー](network-vpc.md#network-vpc.VPC-connector.latency)の*「Networking with App Runner*」の章の「」を参照してください。
## App Runner コンソールを使用してサービスを設定する
コンソールは App Runner API を使用して設定の更新を適用します。前のセクションで定義したように、API が課す更新ルールによって、 コンソールを使用して設定できる内容が決まります。サービスの作成時に使用可能な一部の設定は、後で変更することはできません。さらに、[設定ファイル](config-file.md)を使用する場合、追加の設定はコンソールで非表示になり、App Runner はファイルからそれらを読み取ります。
**サービスを設定するには**
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. 任意のカテゴリの設定を更新するには、**編集** を選択します。
1. 設定の編集ページで、必要な変更を加え、**変更の保存**を選択します。
**注記**
サービスのアウトバウンドトラフィック VPC コネクタを作成すると、次のサービス起動プロセスで 1 回限りのレイテンシーが発生します。この設定は、新しいサービスの作成時または作成後にサービスの更新で設定できます。詳細については、このガイド[1 回限りのレイテンシー](network-vpc.md#network-vpc.VPC-connector.latency)の*「Networking with App Runner*」の章の「」を参照してください。
## App Runner 設定ファイルを使用してサービスを設定する
App Runner サービスを作成または更新するときに、ソースリポジトリの一部として指定した設定ファイルから一部の設定を読み取るように App Runner に指示できます。これにより、ソース管理下にあるソースコードに関連する設定を、コード自体とともに管理できます。設定ファイルには、コンソールまたは API を使用して設定できない特定の詳細設定もあります。詳細については、「[設定ファイルを使用した App Runner サービスオプションの設定](config-file.md)」を参照してください。
**注記**
サービスのアウトバウンドトラフィック VPC コネクタを作成すると、次のサービス起動プロセスで 1 回限りのレイテンシーが発生します。この設定は、新しいサービスの作成時または作成後にサービスの更新で設定できます。詳細については、このガイド[1 回限りのレイテンシー](network-vpc.md#network-vpc.VPC-connector.latency)の*「Networking with App Runner*」の章の「」を参照してください。
# サービスのオブザーバビリティの設定
AWS App Runner は複数の AWS サービスと統合され、App Runner サービス用の広範なオブザーバビリティツールスイートを提供します。詳細については、「[App Runner サービスのオブザーバビリティ](monitor.md)」を参照してください。
App Runner は、オブザーバビリティ機能を有効にし、*ObservabilityConfiguration* と呼ばれる共有可能なリソースを使用して動作を設定することをサポートしています。サービスを作成または更新するときに、オブザーバビリティ設定リソースを指定できます。App Runner コンソールは、新しい App Runner サービスを作成するときに自動的に作成します。オブザーバビリティ設定の提供はオプションです。指定しない場合、App Runner はデフォルトのオブザーバビリティ設定を提供します。
1 つのオブザーバビリティ設定を複数の App Runner サービス間で共有して、オブザーバビリティ動作を同じにすることができます。詳細については、「[共有可能なリソースを使用したサービス設定の構成](manage-configure-resources.md)」を参照してください。
オブザーバビリティ設定を使用して、次のオブザーバビリティ機能を設定できます。
+ *トレース設定* – アプリケーションが処理するリクエストと、アプリケーションが行うダウンストリーム呼び出しをトレースするための設定。トレースの詳細については、「[X-Ray を使用した App Runner アプリケーションのトレース](monitor-xray.md)」を参照してください。
## オブザーバビリティの管理
次のいずれかの方法を使用して、App Runner サービスのオブザーバビリティを管理します。
------
#### [ App Runner console ]
App Runner コンソールを使用して[サービスを作成する](manage-create.md)場合、または[後でその設定を更新する](manage-configure.md)場合は、サービスのオブザーバビリティ機能を設定できます。コンソールページの**オブザーバビリティ**設定セクションを探します。
![\[オブザーバビリティオプションを示す App Runner コンソール設定ページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/manage-configure-observability.png)
------
#### [ App Runner API or AWS CLI ]
[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) または [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) App Runner API アクションを呼び出すときに、 `ObservabilityConfiguration`パラメータオブジェクトを使用してオブザーバビリティ機能を有効にし、サービスのオブザーバビリティ設定リソースを指定できます。
次の App Runner API アクションを使用して、オブザーバビリティ設定リソースを管理します。
+ [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html) – 新しいオブザーバビリティ設定または既存のオブザーバビリティ設定へのリビジョンを作成します。
+ [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html) – に関連付けられているオブザーバビリティ設定のリスト AWS アカウントと概要情報を返します。
+ [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html) – オブザーバビリティ設定の完全な説明を返します。
+ [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html) – オブザーバビリティ設定を削除します。特定のリビジョンまたは最新のアクティブなリビジョンを削除できます。のオブザーバビリティ設定クォータに達した場合は、不要なオブザーバビリティ設定を削除する必要がある場合があります AWS アカウント。
------
# 共有可能なリソースを使用したサービス設定の構成
一部の機能では、 AWS App Runner サービス間で設定を共有するのが理にかなっています。例えば、一連のサービスに同じ自動スケーリング動作を持たせたい場合があります。または、すべてのサービスに対して同じオブザーバビリティ設定が必要な場合があります。App Runner では、個別の共有可能なリソースを使用して設定を共有できます。機能の一連の設定を定義するリソースを作成し、この設定リソースの Amazon リソースネーム (ARN) を 1 つ以上の App Runner サービスに提供します。
App Runner は、以下の機能に共有可能な設定リソースを実装します。
+ [Auto scaling](manage-autoscaling.md)
+ [可観測性](manage-configure-observability.md)
+ [VPC アクセス](network-vpc.md)
これらの各機能のドキュメントページには、使用可能な設定と管理手順に関する情報が表示されます。
個別の設定リソースを使用する機能は、いくつかの設計特性と考慮事項を共有します。
+ **リビジョン** – 一部の設定リソースにはリビジョンを含めることができます。自動スケーリングとオブザーバビリティは、リビジョンを使用する 2 つの設定リソースの例です。このような場合、各設定には*名前*と数値*リビジョン*があります。設定の複数のリビジョンには、同じ名前と異なるリビジョン番号があります。シナリオごとに異なる設定名を使用できます。名前ごとに複数のリビジョンを追加して、特定のシナリオの設定を微調整できます。
名前で作成した最初の設定は、リビジョン番号 1 を取得します。同じ名前の後続の設定では、リビジョン番号が連続して取得されます (2 で始まる）。App Runner サービスは、特定の設定リビジョンまたは最新の設定リビジョンに関連付けることができます。
+ **共有** – 1 つの設定リソースを複数の App Runner サービス間で共有できます。これは、これらのサービス全体で同じ設定を維持する場合に便利です。特に、リソースがリビジョンをサポートしている場合は、設定の最新リビジョンを使用するように複数のサービスを設定できます。これを行うには、リビジョンではなく、設定名のみを指定します。この方法で設定したサービスはいずれも、サービスの更新時に設定の更新を受け取ります。設定の変更の詳細については、「」を参照してください[App Runner サービスの設定](manage-configure.md)。
+ **リソース管理** – App Runner を使用して設定を作成および削除できます。設定を直接更新することはできません。代わりに、リビジョンをサポートするリソースの場合、既存の設定名に新しいリビジョンを作成して、設定を効果的に更新できます。
**注記**
自動スケーリングでは、App Runner コンソールと App Runner API の両方を使用して設定と*複数の*リビジョンを作成できます。App Runner コンソールと App Runner API の両方が、設定とリビジョンを削除することもできます。詳細については、[App Runner の自動スケーリングの管理](manage-autoscaling.md)を参照してください。
オブザーバビリティ設定など、他の設定タイプでは、App Runner コンソールで作成できる設定は 1 *つの*リビジョンのみです。さらにリビジョンを作成し、設定を削除するには、App Runner API を使用する必要があります。
+ **リソースクォータ** – 各設定リソースに対して設定できる一意の設定名とリビジョンの数にクォータが設定されています AWS リージョン。これらのクォータに達した場合は、さらに作成する前に、設定名またはそのリビジョンの一部を削除する必要があります。自動スケーリング設定リビジョンの場合は、App Runner コンソールまたは App Runner API を使用してリビジョンを削除できます。詳細については、[App Runner の自動スケーリングの管理](manage-autoscaling.md)を参照してください。他のリソースを削除するには、App Runner API を使用する必要があります。クォータの詳細については、「[App Runner リソースクォータ](architecture.md#architecture.quotas)」を参照してください。
+ **リソースコスト**なし – 設定リソースの作成に追加コストは発生しません。機能自体のコストが発生する場合があります (たとえば、X-Ray トレースを有効にすると通常の AWS X-Ray コストが課金されます）。ただし、App Runner サービスの機能を設定する App Runner 設定リソースのコストは発生しません。
# サービスのヘルスチェックの設定
AWS App Runner は、ヘルスチェックを実行してサービスの状態をモニタリングします。デフォルトのヘルスチェックプロトコルは TCP です。App Runner は、サービスに割り当てられたドメインに ping を実行します。別の方法として、ヘルスチェックプロトコルを HTTP に設定することもできます。App Runner は、ウェブアプリケーションにヘルスチェック HTTP リクエストを送信します。
ヘルスチェックに関連する設定をいくつか設定できます。次の表に、ヘルスチェックの設定とそのデフォルト値を示します。
| **設定** | **説明** | **デフォルト** |
| --- | --- | --- |
| プロトコル | App Runner がサービスのヘルスチェックを実行するために使用する IP プロトコル。 プロトコルを に設定すると`TCP`、App Runner はアプリケーションがリッスンしているポートでサービスに割り当てられたデフォルトのドメインに ping を実行します。 プロトコルを に設定すると`HTTP`、App Runner は設定されたパスにヘルスチェックリクエストを送信します。 | `TCP` |
| パス | App Runner が HTTP ヘルスチェックリクエストを送信する URL。HTTP チェックにのみ適用されます。 | `/` |
| Interval | ヘルスチェックの間隔 (秒)。 | `5` |
| タイムアウト | ヘルスチェックの応答が失敗したと判断されるまでの時間 (秒)。 | `2` |
| 正常なしきい値 | App Runner がサービスが正常であると判断するために成功する必要がある連続チェックの数。 | `1` |
| 異常なしきい値 | App Runner がサービスが異常であると判断するために失敗する必要がある連続チェックの数。 | `5` |
## ヘルスチェックを設定する
次のいずれかの方法を使用して、App Runner サービスのヘルスチェックを設定します。
------
#### [ App Runner console ]
App Runner コンソールを使用して App Runner サービスを作成する場合、または後でその設定を更新する場合は、ヘルスチェック設定を設定できます。コンソールの詳細な手順については、[App Runner サービスの作成](manage-create.md)「」および「」を参照してください[App Runner サービスの設定](manage-configure.md)。いずれの場合も、コンソールページの**ヘルスチェック**設定セクションを探します。
![\[ヘルスチェックオプションを示す App Runner コンソール設定ページ\]](http://docs.aws.amazon.com/ja_jp/apprunner/latest/dg/images/console-health-check.png)
------
#### [ App Runner API or AWS CLI ]
[CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html) または [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html) API アクションを呼び出すときは、 `HealthCheckConfiguration`パラメータを使用してヘルスチェック設定を指定できます。
パラメータの構造の詳細については、 *AWS App Runner API リファレンス*の[HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)」を参照してください。
------