建立並連結帳單帳戶

kubectl

帳單帳戶的專屬 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，在 Org Global 叢集中套用資源：

   kubectl --kubeconfig ORG_GLOBAL_CLUSTER_KUBECONFIG apply -f billingaccount.yaml
   

   將 ORG_GLOBAL_CLUSTER_KUBECONFIG 替換為機構全域叢集 kubeconfig 檔案。

CLI

如要建立帳單帳戶，請使用 gdcloud billing accounts create 指令。

詳情請參閱 gdcloud billing accounts create。

連結機構

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

1. 在 YAML 檔案 billingaccountbinding.yaml 中新增下列內容：

   • 在 billingAccountRef 區段中，將 name 欄位填入要連結的 BillingAccount 中 name 欄位的內容。
   • 在 metadata 區段中，填入 namespace 欄位的值，該值與 BillingAccount 資源中相同欄位的值相同。在本例中，BillingAccount 資源的機構命名空間為 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 ORG_GLOBAL_CLUSTER_KUBECONFIG apply -f billingaccountbinding.yaml
   

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

   kubectl --kubeconfig ORG_GLOBAL_CLUSTER_KUBECONFIG describe billingaccountbinding billing -n platform
   

連結專案

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

1. 在 billingaccountbinding.yaml 檔案中新增下列內容：

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

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

   請替換下列變數：

   • PROJECT_NAME，並填入與帳單帳戶綁定的專案名稱。
   • BIL_ACCOUNT_NAME：帳單帳戶名稱，例如 test-billing-account。

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

   kubectl --kubeconfig ORG_GLOBAL_CLUSTER_KUBECONFIG apply -f billingaccountbinding.yaml
   

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

   kubectl --kubeconfig ORG_GLOBAL_CLUSTER_KUBECONFIG describe billingaccountbinding billing -n PROJECT_NAME
   

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