限制 Cloud Run 的網路輸入

控制台

1. 前往 Google Cloud 控制台的 Cloud Run 頁面：

   前往 Cloud Run

2. 如要設定新服務，請從選單中選取「服務」，然後按一下「部署容器」，顯示「建立服務」表單。填寫初始服務設定頁面。

3. 如要設定現有服務，請按一下該服務，然後按一下「網路」分頁標籤。

4. 選取要允許的輸入流量：

   

5. 按一下「建立」或「儲存」。

gcloud

1. 如要部署新服務，請使用 --ingress 旗標部署服務：

   gcloud run deploy SERVICE --image IMAGE_URL --ingress INGRESS

   取代

   • INGRESS，並使用可用的 Ingress 設定：
     • all
     • internal
     • internal-and-cloud-load-balancing
   • SERVICE 改為您的服務名稱
   • IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG

2. 如果要變更現有服務的 Ingress：

   gcloud run services update SERVICE --ingress INGRESS

   取代

   • INGRESS，並使用可用的 Ingress 設定：
     • all
     • internal
     • internal-and-cloud-load-balancing
   • SERVICE 改為您的服務名稱

YAML

1. 如要建立新服務，請略過這個步驟。 如要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 更新 run.googleapis.com/ingress: 註解：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     annotations:
       run.googleapis.com/ingress: INGRESS
     name: SERVICE
   spec:
     template:
       metadata:
         name: REVISION

   取代

   • SERVICE 改為您的 Cloud Run 服務名稱。
   • INGRESS，並使用可用的 Ingress 設定：
     • all
     • internal
     • internal-and-cloud-load-balancing
   • REVISION，並提供新的修訂版本名稱，或刪除該名稱 (如有)。如果您提供新的修訂版本名稱，則必須符合下列條件：
     • 開頭為「SERVICE-」
     • 只能包含小寫字母、數字和 -
     • 結尾不是 -
     • 不超過 63 個半形字元

3. 使用下列指令，以新設定取代服務：

   gcloud run services replace service.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

resource "google_cloud_run_v2_service" "default" {
  provider = google-beta
  name     = "ingress-service"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  # For valid annotation values and descriptions, see
  # https://registry.terraform.io/providers/hashicorp/google/latest/docs/resources/cloud_run_v2_service#ingress
  ingress = "INGRESS_TRAFFIC_INTERNAL_ONLY"

  template {
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello" #public image for your service
    }
  }
}

指令列

• 如要停用服務的 run.app 網址，請執行 gcloud beta run services update 指令並加上 --no-default-url 旗標，或將 --no-default-url 旗標傳遞至 gcloud run deploy 指令：

  gcloud beta run services update SERVICE_NAME --no-default-url

  其中 SERVICE_NAME 是 Cloud Run 服務的名稱。

輸出內容會顯示網址，如 None。

如要還原預設網址，請使用 --default-url 旗標。

YAML

1. 如要建立新服務，請略過這個步驟。 如要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 如要停用 run.app 網址，請使用 run.googleapis.com/default-url-disabled 註解：

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     annotations:
       run.googleapis.com/default-url-disabled: true
       run.googleapis.com/launch-stage: BETA
     name: SERVICE
   spec:
     template:
       metadata:
         name: REVISION

   取代

   • SERVICE 改為您的 Cloud Run 服務名稱。
   • REVISION，並提供新的修訂版本名稱，或刪除該名稱 (如有)。如果您提供新的修訂版本名稱，則必須符合下列條件：
     • 開頭為「SERVICE-」
     • 只能包含小寫字母、數字和 -
     • 結尾不是 -
     • 不超過 63 個半形字元

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

如要還原預設網址，請移除 run.googleapis.com/default-url-disabled 註解。

Terraform

如要瞭解如何套用或移除 Terraform 設定，請參閱「基本 Terraform 指令」。

  resource "google_cloud_run_v2_service" "disable_default_url_service" {
    name     = "cloudrun-service"
    location = "europe-west1"
    launch_stage = "BETA"
    default_uri_disabled = true

    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/hello"
      }
      annotations = {
        "run.googleapis.com/ingress" = "all"   # "all" or "internal-only"
      }

    }
  }

確認 launch_stage 和 default_uri_disabled 行位於 main.tf 檔案中。上述 google_cloud_run_v2_service 資源會指定 Cloud Run 服務，並在預覽版中停用預設網址。

如要還原預設網址，請移除 default_uri_disabled 和 launch_stage 引數。