カスタムドメインのマッピング

デプロイされたサービスに Cloud Run が提供するデフォルトのアドレスではなく、カスタムドメインを設定できます。

Cloud Run サービスのカスタムドメインを設定するには、いくつかの方法があります。

グローバル外部 HTTP(S) ロードバランサを使用する
Firebase Hosting を使用する
Cloud Run のドメインマッピングを使用する（限定的に利用可能）

複数のカスタムドメインを同じ Cloud Run サービスにマッピングできます。

始める前に

使用するドメインをまだ所有していない場合、新しいドメインを購入してください。どのドメイン名登録事業者でも使用できます。

Cloud Domains にドメインを登録する場合は、Cloud Run コンソールで Cloud Domains にドメインを登録するをご覧ください。

グローバル外部 HTTP(S) ロードバランサを使用してカスタムドメインをマッピングする

このオプションでは、Cloud Run サービスの前にグローバル外部 HTTP(S) ロードバランサを追加し、ロードバランサレベルでカスタムドメインを構成します。

グローバル外部 HTTP(S) ロードバランサを使用するメリットの 1 つは、カスタムドメインの設定に関して多くの制御が可能であることです。たとえば、独自の TLS 証明書の使用や、特定の URL パスの Cloud Run サービスへのルーティングができます。また、キャッシュ用に Cloud CDN を構成し、セキュリティを高めるために Google Cloud Armor を構成することもできます。

また、URL マスクを使用して、単一ロードバランサのカスタムドメイン URL パターンで、複数のサービスを動的ホスト名またはパスにマッピングできます（例: <service>.example.com）。

現在、グローバル外部 HTTP(S) ロードバランサを使用していない場合は、Cloud Run の統合機能を使用して、Cloud Run サービスのロードバランサを簡単に設定できます。グローバル外部 HTTP(S) ロードバランサを使用する Cloud Run のカスタムドメインの統合ページをご覧ください。グローバル外部 HTTP(S) ロードバランサをすでに使用している場合は、Cloud Run を使用したグローバル外部 HTTP(S) ロードバランサの設定のドキュメントをご覧ください。統合機能を使用すると、CDN 有効化などの既存のロードバランサの構成の一部が上書きされる可能性があります。

Firebase Hosting を使用してカスタムドメインをマッピングする

このオプションでは、Cloud Run サービスの前に Firebase Hosting を構成し、構成ドメインを Firebase Hosting に接続します。

Firebase Hosting の使用は低価格で、必要に応じて Cloud Run サービスによって提供される動的コンテンツとともに静的コンテンツをホストして提供できます。

Firebase Hosting を使用してカスタムドメインをマッピングするには:

Firebase を Google Cloud プロジェクトに追加する
Firebase CLI をインストールする
サービスのソースコードとは異なるフォルダに firebase.json ファイルを作成し、次の内容を追加する。
```
  {
    "hosting": {
      "rewrites": [{
        "source": "**",
        "run": {
          "serviceId": "SERVICE_NAME",
          "region": "REGION"
        }
      }]
    }
  }
```
SERVICE_NAME と REGION を Cloud Run サービスの名前とリージョンに置き換える。

Firebase Hosting の構成をデプロイする。

firebase deploy --only hosting --project PROJECT_ID

カスタムドメインを Firebase Hosting に接続する

Firebase Hosting と Cloud Run の詳細をご覧ください。

Cloud Run のドメインマッピングを使用してカスタムドメインをマッピングする（限定的に利用可能）

Cloud Run のドメインマッピングの制限事項

Cloud Run のドメインマッピングでは、次の点を考慮する必要があります。

サービスをカスタムドメインにマッピングすると、HTTPS 接続用の Google マネージド証明書が自動的に発行され、更新されます。
SSL 証明書のプロビジョニングには通常 15 分ほどかかりますが、場合によっては最長で 24 時間ほどかかることがあります。
独自の（セルフマネージド）証明書をアップロードして使用することはできません。
Cloud Run のドメインマッピングは 64 文字に制限されています。
ドメインマッピングは次のリージョンで利用できます。
- asia-east1
- asia-northeast1
- asia-southeast1
- europe-north1
- europe-west1
- europe-west4
- us-central1
- us-east1
- us-east4
- us-west1
他のリージョンのカスタムドメインをマッピングするには、他のマッピングオプションのいずれかを使用する必要があります。
Cloud Run のドメインマッピングを使用する場合、カスタムドメインをサービスにマッピングしてから DNS レコードを更新します。
example.com のようなドメインや、subdomain.example.com のようなサブドメインをマッピングできます。
ドメインは / にのみマッピングでき、/users のような特定の URL パスにマッピングすることはできません。
この機能でワイルドカード証明書を使用することはできません。

カスタムドメインとサービスのマッピング

カスタムドメインをサービスにマッピングするには、Google Cloud コンソール、gcloud CLI、または Terraform を使用します。

コンソール

Google Cloud コンソールで [ドメインマッピング] ページを開きます。
[ドメインマッピング] ページ

表示ウィンドウが小さすぎると、カスタムドメインのマッピングボタンは表示されないので、ページの右上にあるその他アイコンをクリックする必要があります。
[ドメインマッピング] ページで、[マッピングを追加] をクリックします。
[マッピングを追加] フォームのプルダウンリストから、カスタムドメインをマッピングするサービスを選択します。
ドメイン名を入力します。
[続行] をクリックします。
Google からドメインを購入した場合を除き、ドメインを使用する前にその所有権を確認する必要があります。subdomain.example.com または subdomain1.subdomain2.example.com をマッピングする場合は、example.com の所有権を確認してください。ドメインの所有権を確認する方法については、Search Console ヘルプをご覧ください。
ドメイン登録事業者のウェブサイトで、最後の手順で表示された DNS レコードを使用して DNS レコードを更新します。ドメインマッピングの [...] 操作メニューで [DNS レコード] をクリックすると、レコードが表示されます。
[完了] をクリックします。

コマンドライン

Google からカスタムドメインを購入した場合を除き、Google Cloud プロジェクトでそのドメインを初めて使用する際には、ドメインの所有権を確認する必要があります。使用するカスタムドメインが確認済みかどうかを判別するには、コマンドを使用します
```
gcloud domains list-user-verified
```
ドメインの所有権を確認する必要がある場合は、Search Console の確認ページを開きます。
```
gcloud domains verify BASE-DOMAIN
```
ここで、BASE-DOMAIN は確認するベースドメインです。たとえば、subdomain.example.com をマッピングする場合は、example.com の所有権を確認する必要があります。

Search Console でドメイン所有権の確認を完了します。詳細については、Search Console のヘルプをご覧ください。
サービスをカスタムドメインにマッピングします。
```
gcloud beta run domain-mappings create --service SERVICE --domain DOMAIN
```
- SERVICE は、実際のサービス名に置き換えます。
- DOMAIN は、カスタムドメイン（example.com または subdomain.example.com など）に置き換えます。

Terraform

Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。

Cloud Run サービスを作成するには、既存の main.tf ファイルに次の行を追加します。

run/custom_domain_mapping/main.tf

GitHub で表示フィードバック

resource "google_cloud_run_service" "default" {
  name     = "cloud-run-srv"
  location = "us-central1"
  template {
    spec {
      containers {
        image = "gcr.io/cloudrun/hello"
      }
    }
  }
  traffic {
    percent         = 100
    latest_revision = true
  }
}

name の値は実際のサービス名に置き換えます。

Cloud Run サービスをカスタムドメインにマッピングします。

run/custom_domain_mapping/main.tf

GitHub で表示フィードバック

data "google_project" "project" {}

resource "google_cloud_run_domain_mapping" "default" {
  name     = "verified-domain.com"
  location = google_cloud_run_service.default.location
  metadata {
    namespace = data.google_project.project.project_id
  }
  spec {
    route_name = google_cloud_run_service.default.name
  }
}

verified-domain.com は、確認済みのカスタムドメイン（example.com、subdomain.example.com など）に置き換えます。

ドメイン登録事業者で DNS レコードを追加する

Cloud Run でサービスをカスタムドメインにマッピングしたら、ドメイン登録事業者で DNS レコードを更新する必要があります。Cloud Run が必要な DNS レコードを生成して表示します。マッピングを有効にするには、Cloud Run サービスを参照するレコードをドメイン登録事業者で追加する必要があります。

DNS プロバイダとして Cloud DNS を使用する場合は、レコードの追加をご覧ください。

次のコマンドを使用して、ドメインマッピングの DNS レコード情報を取得します。
コンソール
1. Cloud Run のドメインマッピングページに移動:
  ドメインマッピングページ
2. サービスの右側にある縦に並んだ 3 つの点のアイコンをクリックして [DNS レコード] をクリックし、すべての DNS レコードを表示します。
コマンドライン
```
gcloud beta run domain-mappings describe --domain [DOMAIN]
```
[DOMAIN] は、カスタムドメイン（example.com、subdomain.example.com など）に置き換えます。

resourceRecords という見出しの下にある、返されたすべてのレコードが必要です。
ドメイン登録事業者のアカウントにログインし、DNS 構成ページを開きます。
ドメインの構成ページのホストレコードセクションを見つけて、ドメインを Cloud Run サービスにマッピングしたときに取得した各リソースレコードを追加します。
上記の DNS レコードを DNS プロバイダのアカウントに追加するときに、次の操作を行います。
- 前のステップで返された DNS レコードのタイプを選択します（A、AAAA または CNAME）。
- www という名前を使用して www.example.com にマッピングします。
- @ という名前を使用して example.com をマッピングします。
ドメインのアカウントの DNS 構成ページで変更を保存します。通常、この変更が反映されるまでに数分しかかかりませんが、登録事業者やドメインの以前の DNS レコードに設定されている有効期間（TTL）によっては、数時間かかることもあります。このオンラインの dig バージョンなどの dig ツールを使用して、DNS レコードが正常に更新されたことを確認できます。
新しい URL（https://www.example.com など）でサービスを閲覧して、成功したかどうかをテストします。マネージド SSL 証明書が発行されるまでに数分かかる場合があります。

確認済みのドメイン所有者を他のユーザーまたはサービスアカウントに追加する

ユーザーがドメインを検証すると、そのユーザーのアカウントに対してのみドメインの検証が行われます。つまり、ドメインマッピングを追加できるのは、そのドメインを使用しているユーザーだけです。他のユーザーがドメインを使用するマッピングを追加できるようにするには、ユーザーを確認済みのオーナーとして追加する必要があります。

ドメインで確認済みのオーナーを他のユーザーまたはサービスアカウントに追加するには、[Search Console] ページから権限を追加します。

ウェブブラウザで、このアドレスに移動します。

https://search.google.com/search-console/welcome
[プロパティ] で、ユーザーまたはサービスアカウントを追加するドメインをクリックします。
[確認済みサイト所有者] リストまでスクロールして [サイト所有者を追加] をクリックし、Google アカウントのメールアドレスまたはサービスアカウント ID を入力します。

サービスアカウントのリストを表示するには、Google Cloud コンソールの [サービスアカウント] ページを開きます。

[サービスアカウント] ページに移動

Cloud Run ドメインマッピングを削除する

ドメインマッピングを削除するには、Google Cloud コンソールまたは gcloud コマンドラインツールを使用します。

コンソール

Google Cloud コンソールで [ドメインマッピング] ページを開きます。
[ドメインマッピング] ページ
[ドメインマッピング] ページで、削除するドメインマッピングを選択し、[削除] をクリックします。

コマンドライン

ドメインマッピングを削除します。
```
gcloud beta run domain-mappings delete --domain DOMAIN
```
- DOMAIN は、カスタムドメイン（example.com または subdomain.example.com など）に置き換えます。

認証済みサービスでのカスタムドメインの使用

認証済みサービスは IAM によって保護されます。このような {cloud_run_name}} サービスでは、認証情報の生成時にリクエストの対象とする受信者（オーディエンス）を宣言するクライアント認証が必要です。

オーディエンスは通常ターゲットサービスの正式な URL であり、Cloud Run サービスの場合、デフォルトでは末尾が run.app の URL が生成されます。ただし、カスタムドメインを使用する場合、自動生成された run.app URL をオーディエンスとして使用しないでください。代わりに、カスタムドメインを有効な認証オーディエンスとして受け入れるように、カスタムオーディエンス用のサービスを構成します。

Cloud Run コンソールで Cloud Domains にドメインを登録する

Cloud Run コンソールで Cloud Domains にドメインを登録するには、次の手順を行います。

Cloud Run に移動します。
[カスタムドメインを管理] をクリックします。
[ドメインを登録] をクリックします。
ドメインの登録の手順で登録プロセスを完了します。
ドメインを Cloud Run にマッピングし、ドメイン登録事業者で DNS レコードを追加します。

次のステップ

Terraform でグローバル外部 HTTP(S) ロードバランサを使用して Cloud Run のカスタムドメインを設定するには、このサンプルコードをご覧ください。

カスタム ドメインのマッピング

始める前に

グローバル外部 HTTP(S) ロードバランサを使用してカスタム ドメインをマッピングする

Firebase Hosting を使用してカスタム ドメインをマッピングする

Cloud Run のドメイン マッピングを使用してカスタム ドメインをマッピングする（限定的に利用可能）

Cloud Run のドメイン マッピングの制限事項

カスタム ドメインとサービスのマッピング

コンソール

コマンドライン

Terraform

ドメイン登録事業者で DNS レコードを追加する

コンソール

コマンドライン

確認済みのドメイン所有者を他のユーザーまたはサービス アカウントに追加する

Cloud Run ドメイン マッピングを削除する

コンソール

コマンドライン

認証済みサービスでのカスタム ドメインの使用

Cloud Run コンソールで Cloud Domains にドメインを登録する

次のステップ

カスタムドメインのマッピング

グローバル外部 HTTP(S) ロードバランサを使用してカスタムドメインをマッピングする

Firebase Hosting を使用してカスタムドメインをマッピングする

Cloud Run のドメインマッピングを使用してカスタムドメインをマッピングする（限定的に利用可能）

Cloud Run のドメインマッピングの制限事項

カスタムドメインとサービスのマッピング

確認済みのドメイン所有者を他のユーザーまたはサービスアカウントに追加する

Cloud Run ドメインマッピングを削除する

認証済みサービスでのカスタムドメインの使用