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

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

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

• グローバル外部アプリケーション ロードバランサを使用する（推奨）
• Firebase Hosting を使用する
• Cloud Run のドメイン マッピング（限定的に利用可能、プレビュー）を使用する

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

始める前に

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

グローバル外部アプリケーション ロードバランサを使用してカスタム ドメインをマッピングする

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

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

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

Cloud Run を使用したグローバル外部アプリケーション ロードバランサの設定のドキュメントをご覧ください。

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

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

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

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

1. Firebase を Google Cloud プロジェクトに追加する。
2. Firebase CLI をインストールします。

3. サービスのソースコードとは異なるフォルダに firebase.json ファイルを作成し、次の内容を追加する。

     {
       "hosting": {
         "rewrites": [{
           "source": "**",
           "run": {
             "serviceId": "SERVICE_NAME",
             "region": "REGION"
           }
         }]
       }
     }
   

   SERVICE_NAME と REGION を Cloud Run サービスの名前とリージョンに置き換える。

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

   firebase deploy --only hosting --project PROJECT_ID

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

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

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

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

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

• Cloud Run のドメイン マッピングは、プレビュー リリース ステージです。レイテンシの問題で本番環境に対応していないため、一般提供ではサポートされていません。現時点では、このオプションは本番環境のサービスにはおすすめしません。
• サービスをカスタム ドメインにマッピングすると、HTTPS 接続用の Google マネージド証明書が自動的に発行され、更新されます。
• SSL 証明書のプロビジョニングには通常 15 分ほどかかりますが、場合によっては最長で 24 時間ほどかかることがあります。
• TLS 1.0 と 1.1 を無効にすることはできません。これが問題となる場合は、Firebase Hosting または Cloud Load Balancing を使用して、TLS 1.2 のみのトラフィックを有効にできます。
• 独自の（セルフマネージド）証明書をアップロードして使用することはできません。
• 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 を使用します。

resource "google_cloud_run_v2_service" "default" {
  name     = "custom-domain"
  location = "us-central1"

  deletion_protection = false # set to true to prevent destruction of the resource

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
    }
  }
}

data "google_project" "project" {}

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

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

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

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

1. 次のコマンドを使用して、ドメイン マッピングの DNS レコード情報を取得します。

   Console

   1. Cloud Run のドメイン マッピング ページに移動:
      ドメイン マッピング ページ

   2. サービスの右側にある縦に並んだ 3 つの点のアイコンをクリックして [DNS レコード] をクリックし、すべての DNS レコードを表示します。

   

   gcloud

   gcloud beta run domain-mappings describe --domain [DOMAIN]

   [DOMAIN] は、カスタム ドメイン（example.com、subdomain.example.com など）に置き換えます。

   resourceRecords という見出しの下にある、返されたすべてのレコードが必要です。

2. ドメイン登録事業者のアカウントにログインし、DNS 構成ページを開きます。

3. ドメインの構成ページのホストレコード セクションを見つけて、ドメインを Cloud Run サービスにマッピングしたときに取得した各リソース レコードを追加します。

4. 上記の DNS レコードを DNS プロバイダのアカウントに追加するときに、次の操作を行います。

   • 前のステップで返された DNS レコードのタイプを選択します（A、AAAA または CNAME）。
   • www という名前を使用して www.example.com にマッピングします。
   • @ という名前を使用して example.com をマッピングします。

5. ドメインのアカウントの DNS 構成ページで変更を保存します。通常、この変更が反映されるまでに数分しかかかりませんが、登録事業者やドメインの以前の DNS レコードに設定されている有効期間（TTL）によっては、数時間かかることもあります。オンラインの dig バージョンなどの dig ツールを使用して、DNS レコードが正常に更新されたことを確認できます。

6. 新しい URL（https://www.example.com など）でサービスを閲覧して、成功したかどうかをテストします。マネージド SSL 証明書が発行されるまでに数分かかる場合があります。