設定服務說明

本頁說明如何為 Cloud Run 服務設定自訂說明。說明是附加在服務上的選用文字，方便使用者閱讀。 說明長度上限為 512 個半形字元。 如有說明，使用 gcloud run services describe 查看服務詳細資料時，系統會顯示說明。

必要的角色

如要取得設定及部署 Cloud Run 服務所需的權限，請要求管理員授予下列 IAM 角色：

如果您要從原始碼部署服務或函式，您也必須在專案和 Cloud Build 服務帳戶中獲得額外角色。

如需與 Cloud Run 相關的 IAM 角色和權限清單，請參閱 Cloud Run IAM 角色和 Cloud Run IAM 權限。如果 Cloud Run 服務與Google Cloud API (例如 Cloud 用戶端程式庫) 介接，請參閱服務身分設定指南。 如要進一步瞭解如何授予角色，請參閱部署權限和管理存取權。

設定或修改說明

您可以為 Cloud Run 服務設定說明。

gcloud

您可以在部署期間設定或更新說明：

gcloud run deploy SERVICE --description DESCRIPTION

取代

  • SERVICE，並將其替換為 Cloud Run 服務名稱
  • DESCRIPTION，並附上服務說明

YAML

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

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

  2. 更新 run.googleapis.com/description 註解：

    apiVersion: serving.knative.dev/v1
kind: Service
metadata:
  name: SERVICE
  annotations:
    run.googleapis.com/description: "DESCRIPTION"
spec:
  template:
    ...

    取代

    • SERVICE 改為您的 Cloud Run 服務名稱
    • DESCRIPTION，並附上服務說明

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

    gcloud run services replace service.yaml

Terraform

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

在 Terraform 設定中，將下列項目新增至 google_cloud_run_v2_service 資源：

resource "google_cloud_run_v2_service" "default" {
  name     = "cloudrun-service-description"
  location = "us-central1"

  description = "This service has a custom description"

  deletion_protection = false # set to "true" in production

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

}

將說明替換為所需值。