在 Cloud Deploy 中使用註解和標籤

您可以將註解和標籤附加至 Cloud Deploy 資源。這並非必要步驟。

本文列出可附加標籤和註解的資源，並說明如何使用及查看這些標籤和註解。

關於註解和標籤

註解是不限格式的文字鍵/值組合。您可以使用這些標籤，附加與資源相關的任意資訊。

您可以使用標籤整理資源。舉例來說，您可以根據標籤選取項目套用邏輯。

與註解相同，標籤也是鍵/值組合。但必須符合下列限制：

  • Cloud Deploy 資源最多只能有 64 個標籤。

  • 鍵和值都不得超過 128 個位元組。

  • 鍵和值只能使用小寫字母、數字字元、底線和連字號。

  • 鍵的開頭必須是小寫字母或國際字元。

  • 所有字元都必須使用 UTF-8 編碼。可使用國際字元。

--labels 標記 (例如 gcloud deploy releases create) 可以採用鍵/值組合清單：

"name=wrench,mass=1.3kg,count=3"

詳情請參閱 Cloud Deploy API 說明文件。

為 Cloud Deploy 資源新增註解和標籤

您可以為下列 Cloud Deploy 資源新增註解和標籤：

  • 推送管道

    如果是交付管道，請在 YAML 設定檔中加入註解和標籤。

apiVersion: deploy.cloud.google.com/v1
  kind: DeliveryPipeline
  metadata:
   name:
   annotations:
     key: "value"
   labels:
     key: "value"
  description:
  serialPipeline:
   stages:
   - targetId:
     profiles: []
   - targetId:
     profiles: []

  • 目標

    在目標設定 YAML 中，為目標新增註解和標籤。

    舉例來說，您可以附上連結，提供應用程式第三方監控的詳細資訊。不過，如果目標是共用的，請注意，該目標可能用於多個應用程式，因此連結不應僅限於特定應用程式。

  • 版本

    您可以使用 gcloud deploy releases create 指令的 --labels 和 --annotations 標記，在發布版本中新增註解和/或標籤。您為發行內容新增的標籤和註解，不會沿用至後續的推出內容。