Azure Static Web Apps でのカスタム ドメイン

  • [アーティクル]

既定では、Azure Static Web Apps によって Web サイトに自動生成ドメイン名が提供されますが、カスタム ドメインにサイトを指定することもできます。 自動生成ドメイン名と追加可能なカスタム ドメインに対して、無料の SSL/TLS 証明書が自動的に作成されます。

カスタム ドメインを静的 Web アプリにマップする際、いくつかのオプションを利用できます。 サブドメインと頂点ドメインを構成できます。

次の表に、カスタム ドメイン ベースのプロバイダーの種類を構成する方法を説明している記事へのリンクを示します。 1

アクション 使用... 使用...
www サブドメインを持つドメインを設定する Azure DNS 外部プロバイダー
頂点ドメインを設定する Azure DNS 外部プロバイダー

1 GoDaddy や Google などの一部のレジストラーでは、頂点ドメインの構成方法に影響するドメイン レコードはサポートされていません。 これらのレジストラーでは、Azure DNS を使用して頂点ドメインを設定することを検討してください。

Note

プレビュー環境へのカスタム ドメインの追加はサポートされていません。 Punycode ドメインや xn-- プレフィックスを含む Unicode ドメインもサポートされていません。

ドメインについて

ドメイン名を設定した後に頂点ドメインを構成するのが一般的な構成シナリオです。 頂点ドメインを作成するには、ALIAS または ANAME のレコードを構成するか、CNAME のフラット化を使用します。 GoDaddy や Google などの一部のドメイン レジストラーでは、これらの DNS レコードがサポートされていません。 ドメイン レジストラーで必要な DNS レコードの一部がサポートされていない場合は、Azure DNS を使用してドメインを構成することを検討してください。

または、ALIAS レコード、ANAME レコード、CNAME フラット化をいずれもサポートしていないドメイン レジストラーの場合は、静的 Web アプリの A レコードを構成できます。 これにより、静的 Web アプリの 1 つのリージョン ホストにトラフィックが転送されます。 A レコードの使用は推奨されません。アプリケーションにとって、グローバル分散のメリットがなくなるため、トラフィックがグローバルに分散されている場合は、アプリケーションのパフォーマンスに影響を与える可能性があるためです。

以下は、カスタム ドメインの設定に関連する用語です。

  • 頂点ドメインまたはルート ドメイン: ドメイン www.example.com を例にとると、www プレフィックスはサブドメインと呼ばれ、残りのセグメントである example.com は頂点ドメインと呼ばれます。

  • ドメイン レジストラー: レジストラーは、ドメインが使用できるかどうかを確認し、ドメイン名の購入権を販売します。

  • DNS ゾーン: ドメイン ネーム システム (DNS) ゾーンは、特定のドメインに関連付けられた DNS レコードをホストします。 さまざまな目的のためにトラフィックを転送するさまざまなレコードを利用できます。 たとえば、ドメイン example.com には複数の DNS レコードが含まれる場合があります。 あるレコードは mail.example.com (メール サーバー) のトラフィックを処理し、別のレコードは www.contoso.com (Web サイト) のトラフィックを処理します。

  • DNS ホスティング: DNS ホストは、ドメイン名を特定の IP アドレスに解決する DNS サーバーを管理します。

  • ネーム サーバー: ネーム サーバーは、ドメインの DNS レコードを格納する役割を担います。

カスタム ドメインの検証が静的 Web アプリで機能するには、DNS がパブリックに解決可能である必要があります。 ドメインを追加した後に自動更新が機能するには、次の条件のいずれかを満たす必要があります。

  • CNAME 検証によってカスタム ドメインを静的 Web アプリに追加する際に使われたパブリック インターネット CNAME DNS レコードが、まだ存在することを確認します。 このオプションは、CNAME 検証を使ってドメインを静的 Web アプリに追加した場合にのみ有効です。
  • カスタム ドメインがパブリック インターネット上で静的 Web アプリに解決されることを確認します。 Web アプリへのドメインの追加に使われた検証方法に関係なく、このオプションは有効です。 プライベート エンドポイントが有効になっていても、この方法は有効です。静的 Web アプリのプライベート エンドポイントで、サイト コンテンツへのインターネット アクセスはブロックされますが、サイトへのインターネット DNS 解決はブロックされないためです。

ダウンタイムなしの移行

カスタム do を移行しメイン現在運用 Web サイトをサービスしている静的 Web アプリにダウンタイムを発生させず移行できます。 DNS プロバイダーは同じ名前/ホストに対して複数のレコードを受け入れないため、doメイン の所有権を個別に検証し、トラフィックを Web アプリにルーティングできます。

  1. Azure portal で静的 Web アプリを開く
  2. カスタム doメイン (APEX またはサブドメインメイン) の TXT レコードを追加します。 表示されているホスト値を入力する代わりに、次のように DNS プロバイダーにホストを入力します。
    • APEX の場合はメインを入力_dnsauth.www.<YOUR-DOMAIN.COM>します。
    • サブドメインの場合メインを入力_dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>します。
  3. doメイン が検証されたら、既定のホスト名を指すように 、またはAレコードを更新して、トラフィックをCNAMEALIAS静的 Web アプリに移行できます。

次のステップ

ご利用のプロバイダーに応じてドメインを設定する方法については、以下のリンク先を参照してください。