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

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

サービスにカスタムドメインを使用するには、サービスをカスタムドメインにマッピングして DNS レコードを更新します。サービスは example.com などのドメイン、または subdomain.example.com などのサブドメインにマッピングできます。

次のリージョンでは、カスタムドメインを Cloud Run（フルマネージド）サービスにマッピングすることはできません。

asia-east2
asia-northeast2
asia-northeast3
asia-southeast1
asia-southeast2
asia-south1
australia-southeast1
europe-west2
europe-west3
europe-west6
northamerica-northeast1
southamerica-east1

HTTPS を使用している場合は、以下の点に注意してください。

Cloud Run（フルマネージド）の場合、サービスをカスタムドメインにマッピングすると、HTTPS 接続用のマネージド証明書が自動的に発行、更新されます。SSL 証明書のプロビジョニングには通常 15 分ほどかかりますが、場合によっては最長で 24 時間ほどかかることがあります。独自の証明書をアップロードして使用することはできません。
Cloud Run for Anthos on Google Cloud でドメインマッピングを機能させるには、マネージド TLS 証明書機能を使用するか、独自の証明書を提供する必要があります。

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

始める前に

使用するドメインをまだ所有していない場合、新しいドメインを購入してください。任意のドメイン名登録事業者を使用できますが、Google Domains または Cloud Domains を使用すると、Cloud Run のドメインは自動的に確認されるため、ドメインの所有権の証明手続きを行う必要はありません。

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

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

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

Cloud Run for Anthos on Google Cloud で WebSocket を使用している場合は、まずカスタムドメインで WebSocket のサポートを有効にする必要があります。

Cloud Run for Anthos on Google Cloud で WebSocket のサポートを有効にする方法をご覧ください。

Cloud Run for Anthos on Google Cloud でカスタムドメインの WebSocket サポートを有効にする

次の kubectl コマンドを実行して、allow_connect: true で Istio EnvoyFilter オブジェクトを作成します。

cat <<EOF | kubectl apply -f -
apiVersion: networking.istio.io/v1alpha3
kind: EnvoyFilter
metadata:
  name: allowconnect-cluser-local-gateway
  namespace: gke-system
spec:
  workloadSelector:
    labels:
      app: cluster-local-gateway
  configPatches:
  - applyTo: NETWORK_FILTER
    match:
      listener:
        portNumber: 80
        filterChain:
          filter:
            name: "envoy.http_connection_manager"
    patch:
      operation: MERGE
      value:
        typed_config:
          "@type": "type.googleapis.com/envoy.config.filter.network.http_connection_manager.v2.HttpConnectionManager"
          http2_protocol_options:
            allow_connect: true
EOF

Console

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

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

コマンドライン

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

ウェブマスターセントラルで、ドメイン所有権の確認を完了します。詳しくは、ウェブマスターセントラルのヘルプをご覧ください。
サービスをカスタムドメインにマッピングします。
```
gcloud beta run domain-mappings create --service SERVICE --domain DOMAIN
```
- SERVICE は、実際のサービス名に置き換えます。
- DOMAIN は、カスタムドメイン（example.com または subdomain.example.com など）に置き換えます。
Cloud Run for Anthos on Google Cloud を使用している場合は、Istio Ingress ゲートウェイサービス用のロードバランサに接続された IP アドレスを静的 IP として予約します。
```
gcloud compute addresses create ADDRESS-NAME --addresses EXTERNAL-IP --region REGION
```
次のように置き換えます。
- ADDRESS-NAME は、静的 IP の名前に置き換えます。
- EXTERNAL-IP は、gcloud run domain-mapping describe を使用して前の手順で取得した A レコードの IP アドレスに置き換えます。
- REGION は、使用しているリージョンに置き換えます（クラスタゾーンではありません）。

Cloud Run Istio Ingress ゲートウェイ

Istio Ingress ゲートウェイの外部 IP を取得するには:

kubectl get svc ISTIO-GATEWAY -n NAMESPACE

ISTIO-GATEWAY と NAMESPACE は、次のように置き換えます。

クラスタのバージョン	ISTIO-GATEWAY	NAMESPACE
`1.15.3-gke.19` 以降 `1.14.3-gke.12` 以降 `1.13.10-gke.8` 以降	`istio-ingress`	`gke-system`
他のすべてのバージョン	`istio-ingressgateway`	`istio-system`

次のような出力が生成されます。

NAME            TYPE           CLUSTER-IP     EXTERNAL-IP  PORT(S)
ISTIO-GATEWAY    LoadBalancer   XX.XX.XXX.XX   pending     80:32380/TCP,443:32390/TCP,32400:32400/TCP

ロードバランサの EXTERNAL-IP は、使用する必要がある IP アドレスです。

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

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

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

次のコマンドを使用して、ドメインマッピングの DNS レコード情報を取得します。
Console
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 証明書が発行されるまでに数分かかる場合があります。

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

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

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

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

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

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

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

基本パスのマッピング: サポートされていません

基本パスという用語は、ドメイン名の後の URL パス名を指します。たとえば、users は example.com/users の基本パスです。Cloud Run では、ドメインを特定の基本パスではなく / にのみマッピングできます。そのため、パスのルーティングは、サービスのコンテナ内のルーターを使用するか、Firebase Hosting を使用して処理する必要があります。

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

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

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

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

始める前に

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

Cloud Run for Anthos on Google Cloud でカスタム ドメインの WebSocket サポートを有効にする

Console

コマンドライン

Cloud Run Istio Ingress ゲートウェイ

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

Console

コマンドライン

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

基本パスのマッピング: サポートされていません

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

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

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

Cloud Run for Anthos on Google Cloud でカスタムドメインの WebSocket サポートを有効にする

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