為存放區加上標籤

使用標籤識別及分組相關存放區。您可以為存放區指定多個標籤。

如要在機構中，依據報表、稽核和存取權控管，將存放區和其他資源分組，請使用 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 呼叫的個別值建立標籤。這種做法的問題在於，如果標籤值頻繁變更，或標籤鍵使目錄變得雜亂，就難以有效篩選資源並製作報表。

標籤和標記

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

新增及更新標籤

您可以為存放區新增一或多個標籤。您也可以編輯現有標籤的值。

如要為存放區加上標籤，請按照下列步驟操作：

控制台

  1. 在 Google Cloud 控制台中開啟「Repositories」(存放區) 頁面。

    開啟「存放區」頁面

  2. 選取存放區。

  3. 如果存放區清單旁的資訊面板未開啟，請按一下「Show Info Panel」(顯示資訊面板)。

  4. 在資訊面板中，按一下「標籤」分頁。

  5. 新增或編輯標籤：

    1. 如要新增標籤，請按一下「新增標籤」。指定標籤的鍵值組，然後按一下「儲存」。
    2. 如要編輯現有標籤，請變更標籤的值，然後按一下「儲存」。

gcloud

您可以指定要新增或編輯的一或多個標籤。

  • 如果標籤存在，系統會更新對應的值。
  • 如果沒有標籤，系統會自動建立。
  • 如果指令也包含 --clear-labels 標記，系統會先移除所有現有標籤，再新增標籤。

執行下列指令：

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

更改下列內容：

  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，可以省略這個標記，使用預設存放區。
  • PROJECT 是 Google Cloud 專案 ID。如果省略這個旗標，系統會使用目前或預設專案。
  • LOCATION 是存放區的區域或多區域位置。 您可以省略 `--location` 標記，使用預設值。
  • KEY=VALUE,... 是以逗號分隔的標籤清單，指定為鍵/值組合。例如：team=team-1,product=example_product,stage=development。

如要進一步瞭解指令，請執行下列指令：

gcloud artifacts repositories update --help

依標籤篩選存放區

您可以在 Google Cloud 控制台或使用 Google Cloud CLI，依標籤篩選存放區清單。

控制台

  1. 在 Google Cloud 控制台中開啟「Repositories」(存放區) 頁面。

    開啟「存放區」頁面

  2. 在「篩選器」欄位中，選取「標籤」做為篩選條件，然後輸入鍵、值或鍵/值組合。

    舉例來說，如只要顯示具有 env:dev 標籤的存放區，您可以輸入下列任一內容：

    • 輸入金鑰：env
    • 輸入值：dev
    • 輸入鍵/值組合：env:dev

gcloud

如要依標籤篩選，請執行 gcloud artifacts repositories list 指令，並加上 --filter 旗標。

--filter 標記的值必須採用 labels.KEY=VALUE 格式。舉例來說，如要根據含有 env 鍵和 dev 值的標籤，篩選有效專案中的存放區，可以執行以下指令：

gcloud artifacts repositories list --filter labels.env=dev

如要進一步瞭解 gcloud CLI 中的篩選器語法，請參閱 gcloud topic filters 說明文件。

刪除標籤

如要刪除標籤，請按照下列步驟操作：

控制台

  1. 在 Google Cloud 控制台中開啟「Repositories」(存放區) 頁面。

    開啟「存放區」頁面

  2. 按一下「選取存放區」。

  3. 如果存放區清單旁的資訊面板未開啟，請按一下「Show Info Panel」(顯示資訊面板)。

  4. 在資訊面板中，按一下「標籤」分頁。

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

gcloud

您可以刪除特定標籤，或移除存放區的所有標籤。

如要移除特定標籤，請執行下列指令：

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

如要移除所有標籤，請執行下列指令：

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

更改下列內容：

  • REPOSITORY 是存放區的名稱。如果您已設定預設存放區，可以省略這個標記，使用預設存放區。
  • PROJECT 是 Google Cloud 專案 ID。如果省略這個旗標，系統會使用目前或預設專案。
  • LOCATION 是存放區的區域或多區域位置。 使用這個旗標，即可查看特定位置的存放區。如果已設定預設位置，則可省略此標記，使用預設位置。
  • LABEL,... 是以半形逗號分隔的標籤清單，每個 KEY=VALUE 配對中的鍵。例如：team,product。

如要進一步瞭解指令，請執行下列指令：

   gcloud artifacts repositories update --help