Cloud Run インスタンスのデフォルト URL

デフォルトでは、すべての Cloud Run インスタンスは作成時にデフォルトの run.app URL を受け取ります。この一意のアドレス指定可能な URL の形式は次のとおりです。

https://INSTANCE_NAME-PROJECT_NUMBER.REGION.run.app

次のように置き換えます。

  • INSTANCE_NAME: Cloud Run インスタンスの名前。
  • PROJECT_NUMBER: Google Cloud プロジェクト番号
  • REGION: リージョン名(例: europe-west1)。

デフォルトの URL エンドポイントへのアクセスを削除する場合は、無効にできます。パブリック アクセスからインスタンスをさらに保護するには、上り(内向き)設定を構成してネットワーク アクセスを制御および制限することもできます。Cloud Run インスタンスの上り(内向き)設定を構成する 手順 をご覧ください。

デフォルトの URL を無効にすると、Cloud Run は上り(内向き)をプライベート パスと Virtual Private Cloud パスに制限しますが、インスタンスごとに個別の URL を維持します。

Cloud Run インスタンスのデフォルトの URL を無効にする

Cloud Run インスタンスのデフォルトの run.app URL を無効にして、インスタンスの他の上り(内向き)パス(Cloud Load Balancing と構成済みの ドメイン マッピング)からのトラフィックのみを許可します。

gcloud

  • 既存のインスタンスの場合は、--no-default-url フラグを指定して gcloud beta run instances update コマンドを実行します。次に例を示します。

    gcloud beta run instances update INSTANCE --no-default-url
  • 新しいインスタンスの場合は、--no-default-url フラグを指定して gcloud beta run instances deploy コマンドを実行します。次に例を示します。

    gcloud beta run instances deploy INSTANCE \
        --image IMAGE_URL \
        --no-default-url

    INSTANCE は、実際の Cloud Run インスタンスの名前に置き換えます。

    出力に、URL が None として表示されます。

デフォルトの URL を復元するには、--default-url フラグを使用します。

YAML

  1. 新しいインスタンスを作成する場合は、この手順をスキップします。 既存のインスタンスを更新する場合は、その YAML 構成をダウンロードします。

    gcloud beta run instances describe INSTANCE --format export > instance.yaml
  2. デフォルトの URL を無効にするには、 run.googleapis.com/default-url-disabled アノテーションを 'true' に設定します。

    apiVersion: run.googleapis.com/v1
    kind: Instance
    metadata:
      name: INSTANCE
      annotations:
        run.googleapis.com/default-url-disabled: 'true'
        run.googleapis.com/launch-stage: BETA
    spec:
      containers:
      - name: CONTAINER_NAME
        image: IMAGE_URL

    次のように置き換えます。

    • INSTANCE: Cloud Run インスタンスの名前。
    • CONTAINER_NAME: コンテナの名前。
    • IMAGE_URL: コンテナ イメージへの参照(例: us-docker.pkg.dev/cloudrun/container/hello:latest)。
  3. 次のコマンドを使用して、インスタンスを作成または更新します。

    gcloud beta run instances replace instance.yaml

デフォルトの URL を復元するには、run.googleapis.com/default-url-disabled アノテーションを false に設定するか、削除します。

次のステップ

詳細とインスタンス構成の手順については、 ネットワーク エンドポイントの上り(内向き)を制限する をご覧ください。