標籤工作流程

標籤是鍵/值組合，可用於識別及分組相關工作流程，並儲存工作流程的中繼資料。您可以為工作流程指定多個標籤。

本頁說明如何在工作流程中使用標籤。本文也說明如何新增、更新及移除工作流程的標籤。

如要將機構中的工作流程和其他資源分組，以便進行報表、稽核和存取權控管，請使用「標記」。 Google Cloud Google Cloud 標記和標籤各自獨立運作，您可以將兩者套用至相同的工作流程。

什麼是標籤？

標籤是一種鍵/值組合，可指派給 Google Cloud 工作流程。有助於在大規模環境下整理資源，並依所需精細程度管理成本。每項資源均可加上標籤，並根據標籤篩選資源。標籤相關資訊會轉送到帳單系統，方便依照標籤詳細分析帳單費用。使用內建的帳單報表，可依資源標籤篩選成本並加以分組。 此外，亦可使用標籤查詢帳單資料匯出檔。

標籤需求條件

套用於資源的標籤必須符合下列需求條件：

  • 每項資源最多可以有 64 個標籤。
  • 每個標籤都必須是鍵/值組合。
  • 鍵的長度必須至少為 1 個字元，最多 63 個字元，且不能空白。值可以空白，長度上限為 63 個字元。
  • 鍵和值只能使用小寫字母、數字字元、底線和連字號。所有字元都必須使用 UTF-8 編碼，允許國際字元。鍵的開頭必須是小寫字母或國際字元。
  • 標籤中的鍵部分不得重複，但可讓多個資源使用相同的鍵。

上述限制適用於各個標籤的鍵和值，以及帶有標籤的個別 Google Cloud 資源；但是在每項專案內，所有資源可套用的標籤總數並無上限。

標籤的常見用法

以下是一些常見的標籤用途：

  • 團隊或成本中心標籤：依據團隊或成本中心來新增標籤，藉此區別不同團隊 (例如 team:research 和 team:analytics) 擁有的工作流程。這類標籤可用於成本會計或預算編列作業。

  • 元件標籤：例如 component:redis、component:frontend、component:ingest 和 component:dashboard。

  • 環境或階段標籤：例如 environment:production 和 environment:test。

  • 狀態標籤：例如 state:active、state:readytodelete 和 state:archive。

  • 擁有權標籤：用於識別各項作業的責任團隊，例如：team:shopping-cart。

我們不建議建立大量的不重複標籤，例如幫時間戳記或每個 API 呼叫的個別值建立標籤。這種做法的問題在於，如果標籤值頻繁變更，或標籤鍵使目錄變得雜亂，就難以有效篩選資源並製作報表。

標籤和標記

標籤是一種註解，可用於查詢資源，但無法設定政策條件。標記則可作為判斷條件：系統可依據資源是否具備特定標記，允許或拒絕相應的政策，進而實現精細的政策控管。詳情請參閱「標記總覽」。

新增或更新標籤

建立工作流程時，可以為工作流程新增一或多個標籤。 您也可以在更新工作流程時新增或編輯標籤。

更新現有標籤或新增標籤後，最多可能需要 10 分鐘才會生效。

依標籤篩選工作流程

您可以依標籤篩選工作流程，搜尋並列出特定工作流程。

控制台

  1. 前往 Google Cloud 控制台的「Workflows」頁面：

    前往「Workflows」頁面

  2. 在「Filter」(篩選器) 欄位中，選取「Labels」(標籤) 做為篩選條件，然後在「Values」(值) 清單中選取鍵值組。

gcloud

使用 --filter 旗標搭配 gcloud workflows list 指令：

gcloud workflows list \
    --filter labels.KEY=VALUE

將 KEY 和 VALUE 替換為標籤鍵/值組合。

如要進一步瞭解 Google Cloud CLI 中的篩選器語法，請參閱 gcloud topic filters。

工作流程標籤會沿用至工作流程的執行作業。如要查看執行作業標籤，請使用 workflows.executions.list 方法列出及篩選工作流程執行作業。

刪除標籤

您可以使用 Google Cloud 控制台刪除特定標籤，也可以使用 gcloud CLI 刪除工作流程中的所有標籤。

控制台

  1. 前往 Google Cloud 控制台的「Workflows」頁面：

    前往「Workflows」頁面

  2. 按一下要更新的工作流程名稱。

    系統隨即會顯示「Workflow details」(工作流程詳細資料) 頁面。

  3. 按一下「編輯」。

    系統隨即會顯示「編輯工作流程」頁面。

  4. 在要移除的標籤旁，點選「刪除項目」。

  5. 點選「下一步」。

  6. 如要重新部署工作流程，請按一下「部署」。

gcloud

使用空值的 --labels 旗標和 gcloud workflows deploy 指令：

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

更改下列內容：

  • WORKFLOW_NAME：工作流程名稱。

  • YAML_OR_JSON_SOURCE_FILE：工作流程的來源檔案，格式為 YAML 或 JSON。例如：myFirstWorkflow.yaml。