建立週期性用量

本頁面說明基礎架構營運商 (IO) 如何建立週期性用量，以管理 Google Distributed Cloud (GDC) 氣隙執行個體的帳單費用和服務用量資訊。

RecurringUsage 資源可讓您在固定的時間軸內，為特定 SKU 定義費用。舉例來說，您訂購的服務為期一年，且開始和結束時間都在同一個年度。Distributed Cloud 提供兩種庫存單位 (SKU)，一種是根據用量計費，另一種則不是。如要管理每月週期性固定費用，請使用 Billing API 的 RecurringUsage 資源。

確認計費規定

使用 RecurringUsage 資源設定固定費用訂閱方案是選用步驟。如要判斷帳單需求，請參考下列用途：

  • 如果您使用 Google Cloud 帳單追蹤固定費用和月結單，則不需要在 Distributed Cloud 環境中設定週期性使用費。

  • 如要新增每月固定週期性費用 (例如支援費用)，必須將週期性費用與 SKU 建立關聯 (例如支援 SKU)。在這種情況下，您必須繼續設定 ReccurringUsage 資源。

事前準備

請務必備妥下列資訊再繼續操作：

  • 機構管理叢集中的「機構帳單檢視者」角色。請與安全管理員聯絡，要求對方授予您 billing-system 命名空間的「機構帳單檢視者」organization-billing-viewer 角色。這個權限可讓您讀取相關資源以進行驗證。

  • 具有 kustomization.yaml 檔案和 recurringusages 目錄的 iac 存放區，用於儲存含有 RecurringUsages 自訂資源的檔案。

建立RecurringUsage自訂資源

如要建立 RecurringUsage 資源，請完成下列步驟：

  1. 建立路徑為 infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml 的 YAML 檔案。

    請替換下列變數：

    • TARGET_CLUSTER：您有權存取的叢集名稱，這裡是機構管理員叢集。
    • RECURRING_USAGE_NAME：您為 YAML 檔案指定的名稱。

  2. 加入 RecurringUsage 資源和下列內容：

    apiVersion: billing.private.gdc.goog/v1alpha1
kind: RecurringUsage
metadata:
  name: RECURRING_USAGE_NAME
  namespace: billing-system
skuDescriptionRef:
  name: SKU_DESCRIPTION_NAME
  namespace: billing-system
usageQuantity:
  units: UNITS
  nanos: NANOS
startTime: START_TIME
endTime: END_TIME

    請替換下列變數：

    變數 說明
    RECURRING_USAGE_NAME 要提供給資源的名稱。您必須為建立的每個資源命名，且名稱不得重複。如要讓名稱不重複，請在 SKU_DESCRIPTION_NAME 的名稱後方加上時間戳記。例如：
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME 所參照 SKU 說明的名稱，也就是小寫的 SKU_ID。SKU 說明名稱由 12 個小寫英數字元組成，並以破折號分隔，每四個字元為一組。例如：0000-ffff-aaaa。
    UNITS 用量數量的整數單位。舉例來說，如果費用是 1.50 個單位，請將這個欄位設為 1，並將 NANOS 欄位設為 500000000。
    NANOS 整數單位的十億分之一。舉例來說，如果費用為 1.50 個單位，請將 UNITS 欄位設為 1，這個欄位則設為 500000000。
    START_TIME 開始收取特定 SKU 費用的時間戳記。時間戳記必須採用 RFC 3339 格式。舉例來說，如果訂購的服務在 01/01/2024 開始，請將時間戳記值新增為 2024-01-01T00:00:00Z。

    這個欄位為選填，如果未設定，只要您在 GitLab 中提交合併要求，就會產生費用。您無法在 GitLab 中提交合併要求之前設定這個欄位。如果要求的開始時間在過去，請將事件提報給 GDC 支援團隊。
    END_TIME 特定 SKU 的費用結算時間戳記。時間戳記必須採用 RFC 3339 格式。舉例來說，如果您訂購的服務開始時間為 01/01/2024，結束時間為 01/01/2025，請將時間戳記值新增為 2025-01-01T00:00:00Z。

    這個欄位為選填欄位，如果未設定，系統會繼續收費。您無法在 GitLab 中提交合併要求之前設定這個欄位。如果要求的結束時間已過，請將事件提報給 GDC 支援團隊。

  3. 將重複使用的項目儲存到 recurringusages 資料夾。

  4. 建立包含 YAML 檔案和必要 kustomization 檔案的拉取要求。

  5. 確認是否已建立 RecurringUsage 自訂資源：

    kubectl get recurringusages.billing.private.gdc.goog RECURRING_USAGE_NAME -n billing-system -o yaml

    如果無法建立RecurringUsage自訂資源，請按照「IAC-R0001」中的操作說明，進一步調查問題。