App Runner サービスのカスタムドメイン名の管理

を作成するとAWS App Runnerサービスでは、App Runner はドメイン名を割り当てます。このサブドメインはawsapprunner.comドメインをアプリケーションランナーが所有します。これは、サービスで実行されている Web アプリケーションにアクセスするために使用できます。

ドメイン名を所有している場合は、App Runner サービスに関連付けることができます。App Runner が新しいドメインを検証した後、App Runner ドメインに加えてアプリケーションにアクセスするために使用できます。最大 5 つのカスタムドメインを関連付けることができます。

注記

必要に応じて、wwwサブドメインを選択します。ただし、これは現在のところ API のみでサポートされています。App Runner コンソールではサポートされません。

カスタムドメインをサービスに関連付けると、App Runner によって一連の証明書検証レコードが提供されます。ドメインネームシステム（DNS）に追加して、App Runner がドメインを所有または管理していることを検証できるようにします。さらに、CNAME レコードまたは ALIAS レコードを DNS に追加して、App Runner ドメインをターゲットにします。カスタムドメイン用のレコードを 1 つ追加し、wwwサブドメイン (このオプションを選択した場合)。次に、カスタムドメインステータスがアクティブアプリランナーコンソールで。これには通常、数分かかります（ただし、24～48時間かかる場合があります）。この時点で、カスタムドメインが検証され、App Runner はこのドメインから Web アプリケーションへのトラフィックのルーティングを開始します。

App Runner サービスに関連付けるドメインは、次の方法で指定できます。

• ルートドメイン— 例:example.com。オプションでwww.example.com同じ操作の一部としても使用できます。

• サブドメイン— 例:login.example.comまたはadmin.login.example.com。オプションで、wwwサブドメインも同じオペレーションの一部として作成されます。

• ワイルドカード— 例:*.example.com。使用することはできませんwwwこの場合、オプションを使用します。ワイルドカードは、ルートドメインの直接のサブドメインとしてのみ指定でき、それ自体でのみ指定できます（これらは有効な仕様ではありません：login*.example.com,*.login.example.com). このワイルドカード仕様では、すべての即時サブドメインが関連付けられ、ルートドメイン自体は関連付けられません（ルートドメインは別の操作で関連付けられる必要があります）。

より具体的なドメインアソシエーションは、より具体的なドメインアソシエーションよりも優先されます。例:login.example.comオーバーライド＃*.example.com。より具体的な関連付けの証明書と CNAME が使用されます。

以下の例は、複数のカスタムドメインの関連付けを使用する方法を示しています。

1. 関連付けexample.comをサービスのホームページに置き換えます。を有効にするwwwも関連付けるwww.example.com。

2. 関連付けlogin.example.comをサービスのログインページに置き換えます。

3. 関連付け*.example.comをカスタムの「見つかりません」ページに置き換えます。

App Runner サービスからカスタムドメインの関連付けを解除（リンク解除）できます。ドメインのリンクを解除すると、App Runner はこのドメインから Web アプリケーションへのトラフィックのルーティングを停止します。DNS からこのドメインのレコードを削除する必要があります。

App Runner はドメインの有効性を追跡する証明書を内部的に作成します それらはAWS Certificate Manager(ACM) である。App Runner は、ドメインがサービスから関連付け解除された後、またはサービスが削除された後 7 日間これらの証明書を削除しません。

App Runner コンソールを使用してカスタムドメインを管理する

App Runner コンソールを使用してカスタムドメインを関連付け（リンク）するには

1. を開くアプリのランナーコンソールで、リージョンリストで、AWS リージョン。

2. ナビゲーションペインで、[] を選択します。サービスをクリックし、App Runner サービスを選択します。

   コンソールには、サービスダッシュボードにサービスの概要。

3. サービスのダッシュボードページで、[] を選択します。カスタムドメイン[] タブ。

   コンソールには、サービスに関連付けられているカスタムドメインが表示されます。カスタムドメインなし。

   

4. リポジトリの []カスタムドメイン[] タブで、ドメインのリンク。

5. 左カスタムドメインのリンク[] ダイアログで、ドメイン名を入力し、[] を選択します。DNS 設定の表示。

6. [] の手順に従います。DNS を設定するページをクリックして、ドメインの検証プロセスを開始します。

7. ドメインのステータスがアクティブで、ドメインを参照して、トラフィックをルーティングするために動作することを確認します。

App Runner コンソールを使用してカスタムドメインの関連付け解除（リンク解除）するには

1. リポジトリの []カスタムドメイン[] タブで、関連付けを解除するドメインのタイルを選択し、[] を選択します。ドメインのリンクの解除。

2. 左ドメインのリンクの解除ダイアログで、ドメインのリンクの解除。

App Runner API を使用してカスタムドメインを管理するか、AWS CLI

App Runner API または App Runner を使用してカスタムドメインをサービスに関連付けるにはAWS CLI[] を呼び出すには、カスタムドメインの関連付けAPI アクション。呼び出しが成功すると、CustomDomainオブジェクトを使用して、サービスに関連付けられているカスタムドメインを記述します。オブジェクトのステータスはCREATINGのリストのある証明書検証レコードオブジェクト。これらは、DNS に追加できるレコードです。

App Runner API または App Runner を使用して、サービスからカスタムドメインの関連付けを解除するにはAWS CLI[] を呼び出すには、カスタムドメインの関連付けを解除するAPI アクション。呼び出しが成功すると、CustomDomainオブジェクトで、サービスとの関連付けが解除されているカスタムドメインを記述します。オブジェクトのステータスはDELETING。