標記是可附加至Google Cloud 資源的鍵/值組合,用於為資源加上註解,並依條件強制執行政策。這項條件式強制執行功能可讓您精細控管 Google Cloud 資源階層中的資源。
Google Cloud 資源階層會以樹狀結構整理資源,方便您大規模管理資源。不過,這個階層只會模擬少數業務維度,包括組織結構、區域、工作負載類型和成本中心。標記可讓您靈活地在階層中將多個業務維度疊加在一起。
標記和標籤
標籤是另一種建立資源註解的方式。下表列出標記和標籤的部分差異:
| 標記 | 標籤 | |
|---|---|---|
| 資源結構 | 標記鍵、標記值和標記繫結都是獨立資源 | 本身不是資源,而是資源的中繼資料 |
| 定義 | 在組織或專案層級定義 | 由各項資源定義 |
| 存取控管 | 管理及附加標記時,必須具備 Identity and Access Management (IAM) 角色 | 附加標籤需要 IAM 角色,具體取決於服務資源 |
| 附件必備條件 | 必須先定義標記鍵和標記值,才能將標記附加至資源 | 不需任何先備知識 |
| 是否沿用設定 | 標記繫結會由 Google Cloud 階層中資源的子項繼承 | 不會由資源的子項繼承 |
| 刪除規定 | 除非標記沒有任何繫結,否則無法刪除 | 隨時可以從資源中移除 |
| 命名需求 | 標記值和標記鍵規定 | 標籤需求 |
| 鍵/值名稱長度 | 最多 256 個半形字元 | 最多 63 個半形字元 |
| 允許和拒絕政策支援 | 允許政策條件和拒絕政策條件可參照標記 | 不支援允許和拒絕政策 |
| 組織政策支援 | 組織政策條件式限制可參照部分資源的標記 | 不支援組織政策 |
| Cloud Billing 整合 | 執行交易退單、稽核和其他成本分配分析,將 Cloud Billing 費用資料匯出至 BigQuery | 在 Cloud Billing 中依標籤篩選資源,將 Cloud Billing 資料匯出至 BigQuery |
如要進一步瞭解標籤,請參閱「建立及管理標籤」。
語意標記
語意標記是一種鍵/值組合,可為資源提供有意義的中繼資料,並採用 OpenTelemetry (OTel) 慣例支援的強大標準化語意。
您可以將語意標記與 App Hub 資源搭配使用。在 App Hub 中設定服務和工作負載的屬性時,App Hub 會自動將這些屬性複製為直接基礎資源的唯讀系統語意標記。
系統語意標記為唯讀,您無法直接使用 Tags API 或 Google Cloud 控制台編輯或移除這些系統標記。標記管理作業會在 App Hub 內進行。
App Hub 複製的語意標記
如果您使用 App Hub,系統會自動將服務或工作負載上設定的「Environment」(環境) 和「Criticality」(重要性) 屬性,複製為專屬命名空間 google:AppHub 下的唯讀系統語意標記。
支援的系統標記包括:
google:AppHub/environment:衍生自 App Hub 的值,例如PRODUCTION或STAGING。google:AppHub/criticality:衍生自 App Hub 的值,例如MISSION_CRITICAL或HIGH。
將 App Hub 情境顯示為系統標記,可確保 Google Cloud 控制台等下游服務使用權威中繼資料,強制執行管理和安全性政策,避免手動設定帶來的風險。
如要進一步瞭解如何管理語意標記,請參閱「查看及管理語意標記」。
語意目錄
語意目錄會列出可用的語意,以及這些語意與 OpenTelemetry (OTel) 支援屬性的對應關係。您可以在 Google Cloud 控制台瀏覽這個目錄,或使用 API 查看詳細資料。
如要進一步瞭解如何存取目錄,請參閱「查看語意目錄」。
| 語意鍵 | OTel 屬性鍵 | 語意值 | OTel 屬性值 |
|---|---|---|---|
ENVIRONMENT |
deployment.environment.name |
PRODUCTION |
production |
STAGING |
staging |
||
TEST |
test |
||
DEVELOPMENT |
development |
||
CRITICALITY |
service.criticality |
MISSION_CRITICAL |
critical |
HIGH |
high |
||
MEDIUM |
medium |
||
LOW |
low |
語意標記的限制
語意標記有下列限制:
- 自訂繫結:您無法透過 Tags API,直接將
ENVIRONMENT或CRITICALITY語意標記繫結至資源或 Resource Manager 節點 (專案、資料夾或組織)。 - 使用者定義的語意:不支援將現有標記升級為語意標記。
- 僅限直接資源:同步處理作業只會套用至在 App Hub 註冊的直接資源。不會傳播至服務或工作負載中的巢狀或間接資源 (例如 MIG 中的個別 VM)。
建立標記
標記的結構為鍵/值組合。您可以在組織或專案資源下建立標記鍵資源,而標記值則是附加至鍵的資源,例如標記鍵 environment,其值為 production 和 development。
標記管理
管理員可以限制哪些使用者能建立、更新、刪除標記,以及將標記附加至資源,藉此控管標記的使用。他們可以選取個別標記進行編輯,例如新增或移除值,以及更新說明。這樣一來,您就能精細控管代碼。
標記可選擇是否要加上說明,在擷取標記相關資訊時顯示。說明可協助將標記附加至資源的使用者瞭解標記的用途。
在父項專案或組織中,每個標記鍵都不得重複。這可確保每個標記值繫結至資源時,都會與其標記鍵建立不重複的配對。
政策和標記
您可以搭配使用標記和 IAM 條件,以便:
建立標記值後,即可將標記值繫結至資源。接著,您可以建立具有條件的 IAM 政策,根據標記索引鍵是否已繫結至資源,來識別資源。如要瞭解如何使用標記和 IAM 條件,請參閱「標記和條件式存取權」。
代碼異動的影響
如果您使用標記有條件地授予或拒絕存取權,或限定組織政策範圍,則從資源繫結或解除繫結標記可能會變更這些政策的影響。
舉例來說,假設您有一組開發人員需要管理 Compute Engine 執行個體,但只能管理用於開發的執行個體:
- 標記定義:您有一個標記鍵
123456789012/env,其值為dev和prod。 - 條件式存取權:您將 Compute 執行個體管理員角色 (
roles/compute.instanceAdmin) 授予開發人員群組。您在角色繫結中新增條件,規定只有在資源具有env: dev標記時,才能授予存取權。 - 異動影響:
- 繫結標記:將標記
env: dev附加至執行個體。條件式角色繫結現在會授予開發人員管理執行個體的權限。 - 解除繫結標記:之後,同一個執行個體會升級至正式環境。您解除繫結
env: dev標記,並繫結env: prod標記。條件式角色繫結不再授予開發人員管理這個執行個體的權限。
- 繫結標記:將標記
一般來說,代碼變更會在 2 分鐘內生效。不過,變更最多可能需要 7 分鐘才會在系統中全面生效。這項傳播延遲會影響授予或撤銷存取權的速度,或是在標記繫結或解除繫結後,組織政策生效的速度。
使用組織政策強制執行必要標記
您可以使用自訂組織政策,強制對資源套用必要標記。強制執行必要標記時,您只能建立符合組織標記政策的資源,也就是資源會與政策中指定的必要標記鍵標記值繫結。詳情請參閱「設定自訂限制來強制執行標記」。
下列資源類型支援強制執行必要標記:
- Resource Manager 專案和資料夾
- Filestore 執行個體
- AlloyDB for PostgreSQL 叢集和備份資源
- Workflows 工作流程
- Compute Engine 資源:
- 執行個體
- 磁碟
- 外部 VPN 閘道
- VPN 閘道
- 目標 VPN 閘道
- VPN 通道
- 互連網路
- 互連網路連結
- 後端服務
- 區域性後端服務
- 後端 bucket
- 虛擬私有雲資源:
- 網路
- 子網路
- 防火牆規則
- Routes
標記繼承
將標記值附加至資源時,根據預設,資源的所有子系都會沿用相同的標記值。您可以覆寫子系資源上繼承的標記值。如要覆寫沿用的標記值,請將不同的標記值繫結至子系資源。不同的標記值必須使用與繼承標記值相同的標記鍵。
舉例來說,假設您將 environment: development 標記套用至某個資料夾,而該資料夾有兩個子資料夾,分別名為 team-a 和 team-b。您也可以將不同的標記 environment: test 套用至 team-b 資料夾。因此,team-a 資料夾中的專案和其他資源會繼承 environment: development 標記,而 team-b 資料夾中的專案和其他資源會繼承 environment: test 標記:
如果從 team-b 資料夾中移除 environment: test 標記,該資料夾及其資源會繼承 environment: development 標記。
附加至資源並由資源繼承的所有標記,統稱為「有效標記」。資源的有效標記,是直接附加至資源的標記,以及附加至資源在階層中所有祖系的標記組合。
搭配 IAM 條件使用標記時,建議您為 IAM 條件使用的每個標記鍵建立安全的預設標記值。將安全預設標記值繫結至組織,即可套用該標記值,讓組織內的所有資源繼承該值。如要變更標記值,請明確覆寫相關資源的繼承繫結。
舉例來說,假設您有一個 IAM 條件,取決於 enforcement 標記鍵的 on 標記值,而該標記鍵也有 off 標記值。將標記值 enforcement: off 繫結至組織,建立安全的預設值,讓組織內的所有資源繼承。僅將標記值 enforcement: on 繫結至組織內所選資源。
接著,您可以編寫處理 enforcement 標記鍵的政策,並設定條件,在資源為 enforcement: on 或 enforcement: off 時影響資源,並在資源為 enforcement: default 時提供安全案例。如果從資源中移除 enforcement 標記鍵,資源就會從父項資源繼承 enforcement 的標記值。如果沒有任何父項資源具有 enforcement 標記鍵,資源會從組織資源繼承 enforcement: default。
使用安全的預設標記可以提供協助,但為了避免非預期的行為,建議您先檢查標記和政策,並設定條件,再移動資源或移除標記。
刪除標記鍵和值
您必須先刪除所有使用標記值的資源繫結,才能刪除標記值。
防止標記值遭到刪除
您可以將標記保留附加至標記值,為標記值建立額外的保護層。標記保留與標記繫結一樣,可防止使用者刪除標記值。
某些資源會自動對附加至資源的每個標記值建立標記保留。必須先移除這個標記保留項目,才能刪除標記值。
後續步驟
- 如要進一步瞭解如何使用標記,請參閱「建立及管理標記」頁面。
- 如要瞭解如何搭配使用標記和 Compute Engine,請參閱「管理資源標記」。
- 如要瞭解如何使用標記定義跨專案管理界線,請參閱「管理界線和功能總覽」。
- 如要瞭解如何將安全標記用於防火牆政策,請參閱「建立及管理安全標記」。