建立及連結帳單帳戶

Google Distributed Cloud (GDC) 氣隙環境需要帳單帳戶，才能追蹤專案和機構的費用。如果未將帳單帳戶連結至機構或專案，您將無法取得與資源相關的費用資料。

如要向客戶收取服務使用費，機構內的所有帳單帳戶都必須使用同一份價目表。

事前準備

請要求機構 IAM 管理員授予下列必要角色。這些角色會繫結至專案命名空間 (適用於專案層級帳單)，或是平台命名空間 (適用於機構層級帳單)：

  • 全域機構帳單帳戶管理員：建立、管理及繫結 BillingAccount 資源。請要求機構 IAM 管理員授予您 organization-billing-account-admin 角色。

  • 全域機構帳單帳戶使用者：讀取、列出及繫結 BillingAccount 資源。請要求機構 IAM 管理員授予您 organization-billing-account-user 角色。

  • 全球機構帳單帳戶管理員：讀取、列出、建立及更新 BillingAccountBinding 資源。請要求機構 IAM 管理員授予您 organization-billing-manager 角色。

取得 kubeconfig 檔案

如要對 Global API 伺服器執行指令，請確認您擁有下列資源：

  1. 登入並產生 Global API 伺服器的 kubeconfig 檔案 (如果沒有)。

  2. 請使用 Global API 伺服器的 kubeconfig 檔案路徑，替換這些操作說明中的 GLOBAL_API_SERVER_KUBECONFIG。

建立新的帳單帳戶

帳單帳戶的專屬 ID 為 name 和 namespace。如要建立帳單帳戶，請使用自訂資源建立 name 和 namespace：

  1. 建立 YAML 檔案，並新增 BillingAccount 自訂資源和下列內容：

    apiVersion: billing.global.gdc.goog/v1
kind: BillingAccount
metadata:
  namespace: platform
  name: BIL_ACCOUNT_NAME
spec:
  displayName: BIL_DISPLAY_NAME
  paymentSystemConfig:
    cloudBillingConfig:
      accountID: "012345-6789AB-CDEF01"

    請替換下列變數：

    • BIL_ACCOUNT_NAME：帳單帳戶的名稱。 例如：test-billing-account。
    • BIL_DISPLAY_NAME：帳單帳戶顯示名稱。 例如："Test Billing Account"。

  2. 確認付款設定類型。Distributed Cloud 帳單帳戶必須採用下列其中一種付款設定：

    • cloudBillingConfig：預設付款設定。這項設定會儲存 Cloud Billing 帳戶 ID。

    • customConfig：合作夥伴的自訂設定，用於儲存付款設定，以便向機構收費。customConfig 支援鍵/值字串的字典，且必須包含 payment-config-type 鍵。

    下列範例顯示不同付款設定的 BillingAccount YAML 檔案程式碼片段：

    cloudBillingConfig

    spec:
  paymentSystemConfig:
    cloudBillingConfig:
      accountID: CLOUD_BILLING_ACCOUNT_ID

    將 CLOUD_BILLING_ACCOUNT_ID 替換為您的Google Cloud 帳單帳戶 ID。

    customConfig

    spec:
 paymentSystemConfig:
   customConfig:
      "payment-config-type": PAYMENT_CONFIG_TYPE

    將 PAYMENT_CONFIG_TYPE 替換為您為自訂帳單設定選擇的付款設定類型。

    如果沒有貴機構的customConfig設定資訊，請輸入下列詳細資料：

    spec:
 paymentSystemConfig:
   customConfig:
      "payment-config-type": "N/A"

    下列 YAML 檔案顯示完整的 BillingAccount 資源，其中包含 cloudBillingConfig 設定：

    apiVersion: billing.global.gdc.goog/v1
kind: BillingAccount
metadata:
  namespace: platform
  name: test-billing-account
spec:
  displayName: "Test Billing Account"
  paymentSystemConfig:
    cloudBillingConfig:
      accountID: "012345-6789AB-CDEF01"

  3. 儲存 YAML 檔案。執行 kubectl CLI，在 Global API 伺服器中套用資源：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f billingaccount.yaml

    將 GLOBAL_API_SERVER_KUBECONFIG 替換為全域 API 伺服器 kubeconfig 檔案。

本節提供一系列步驟，說明如何將機構或專案連結至 BillingAccount。

如要將專案連結至 BillingAccount，請按照下列步驟操作：

  1. 將下列內容新增至 billingaccountbinding.yaml 檔案：

    • 在 billingAccountRef 區段中，將 name 欄位填入要連結的 BillingAccount 中 name 欄位的內容。
    • 在 metadata 區段中，使用 BillingAccount 資源中相同欄位的內容填入 namespace 欄位。

    在本範例中，專案命名空間為 PROJECT_NAME：

    apiVersion: billing.global.gdc.goog/v1
kind: BillingAccountBinding
metadata:
  name: billing
  namespace: PROJECT_NAME
spec:
  billingAccountRef:
    name: BIL_ACCOUNT_NAME
    namespace: platform

    將 PROJECT_NAME 替換為繫結至帳單帳戶的專案名稱。

  2. 執行下列 kubectl 指令，套用 billingaccountbinding.yaml 檔案：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f billingaccountbinding.yaml

  3. 檢查 BillingAccountBinding 的狀態，確認沒有錯誤：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n PROJECT_NAME

    將 PROJECT_NAME 替換為繫結至帳單帳戶的專案名稱。

如要將機構連結至 BillingAccount，請按照下列步驟操作：

  1. 將下列內容新增至 YAML 檔案 billingaccountbinding.yaml：

    • 在 billingAccountRef 區段中，使用要連結的 BillingAccount 內 name 欄位內容，填入 name 欄位。
    • 在 metadata 區段中，使用 BillingAccount 資源中相同欄位的內容填入 namespace 欄位。在本例中，機構命名空間為 platform：
    apiVersion: billing.global.gdc.goog/v1
kind: BillingAccountBinding
metadata:
  name: billing
  namespace: platform
spec:
  billingAccountRef:
    name: BIL_ACCOUNT_NAME
    namespace: platform

  2. 執行下列 kubectl 指令，套用 billingaccountbinding.yaml 檔案：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f billingaccountbinding.yaml

  3. 檢查 BillingAccountBinding 的狀態，確認沒有錯誤：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n platform

列出帳單帳戶繫結

查看機構中所有命名空間的所有已部署 BillingAccountBinding 資源清單，以及這些資源的目前狀態：

  kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG get billingaccountbinding -A -o 'custom-columns=NAME:metadata.name,NAMESPACE:metadata.namespace,BillingAccountName:spec.billingAccountRef.name,STATUS:status.conditions[0].status'

這項指令會輸出每個 BillingAccountBinding 的 NAME、NAMESPACE、BillingAccountName 和 STATUS。STATUS 欄位會指出繫結是否有效，或是否有任何錯誤。

帳單帳戶階層和行為

將帳單帳戶連結至機構和專案時，適用下列階層和行為：

  • 專案層級的關聯優先：如果特定專案 (例如 project-A) 明確連結至 BillingAccount (例如 billing-account-1)，則 project-A 的所有費用都會只向 billing-account-1 收取。無論機構層級的帳單帳戶設定為何，這項專案層級的關聯都會維持有效。

  • 未連結專案的機構層級關聯：如果機構已連結至 BillingAccount (例如 billing-account-0)，則該機構內所有沒有明確 BillingAccountBinding 的專案都會自動與 billing-account-0 建立關聯，並由 billing-account-0 支付費用。這項關聯通常會在約 15 分鐘後生效。

  • 變更機構帳單帳戶：如果連結至機構的帳單帳戶變更 (例如從 billing-account-0 變更為 billing-account-new)，先前繼承 billing-account-0 的專案不會自動切換為 billing-account-new。這些專案仍會綁定 billing-account-0，如要改用 billing-account-new，必須手動更新專案的帳單帳戶。

變更連結的帳單帳戶

在 Distributed Cloud 中，您無法刪除帳單帳戶。如要變更帳單設定，請修改 BillingAccountBinding，變更連結至機構或專案的帳單帳戶。這個應用實例的部分情境包括以下範例：

  • 貴公司的會計規則要求您將與開發人員和生產層級工作負載相關的費用，拆分到不同帳戶。
  • 您建立帳單帳戶，以便收取為期一年的客戶合約費用。合約到期後，您必須支付超過一年的剩餘期間費用。

變更專案的連結帳單帳戶

如要變更專案的連結帳單帳戶，請按照下列步驟操作：

  1. 建立新的 BillingAccount，然後連結至專案。這個帳戶會取代舊帳戶。

  2. 在專案命名空間中找出 BillingAccountBinding 資源 YAML 檔案，查看連結的帳單帳戶：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n PROJECT_NAME

  3. 修改 BillingAccountBinding，連結至新的帳單帳戶。在 billingAccountRef 區段中，使用本節步驟 1 建立的新 BillingAccount 名稱填入 name 欄位。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG edit billingaccountbinding billing -n PROJECT_NAME

  4. 變更完成後，請確認帳單帳戶已正確更新：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n PROJECT_NAME

以下範例顯示的 BillingAccountBinding YAML 檔案中，帳戶 expired-billing-account 已連結至專案 project-one：

  apiVersion: billing.global.gdc.goog/v1
  kind: BillingAccountBinding
  metadata:
    # The name of a BillingAccountBinding will typically always be `billing`.
    name: billing
    # This is the project.
    namespace: project-one
  spec:
    billingAccountRef:
      # This is an example of a BillingAccount that has expired.
      name: expired-billing-account
      namespace: platform

以下範例顯示先前範例中的 BillingAccountBinding YAML 檔案經過修改，可連結名為 new billing account 的新帳戶：

  apiVersion: billing.global.gdc.goog/v1
  kind: BillingAccountBinding
  metadata:
    name: billing
    # This is the project.
    namespace: project-one
  spec:
    billingAccountRef:
      # This is the example of the new BillingAccount.
      name: new-billing-account
      namespace: platform

變更機構的連結帳單帳戶

如要變更機構的連結帳單帳戶，請按照下列步驟操作：

  1. 建立新的 BillingAccount，連結至機構。這個帳戶會取代舊帳戶。

  2. 在 platform 命名空間中找出 BillingAccountBinding 資源 YAML 檔案，查看連結的帳單帳戶：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n platform

  3. 修改 BillingAccountBinding，連結至新的帳單帳戶。在 billingAccountRef 區段中，使用步驟 1 建立的新 BillingAccount 名稱填入 name 欄位。

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG edit billingaccountbinding billing -n platform

  4. 變更完成後，請確認帳單帳戶已正確更新：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG describe billingaccountbinding billing -n platform