创建和关联结算账号

Google Distributed Cloud (GDC) 空气隔离环境需要结算账号来跟踪项目和组织的费用。如果您未将结算账号与组织或项目相关联，则会丢失与相应资源相关联的费用数据。

为了向客户收取服务使用费，组织内的所有结算账号都使用同一份价目表。

准备工作

请让组织 IAM 管理员为您授予以下必需的角色。这些角色绑定到项目级结算的项目命名空间或组织级结算的平台命名空间：

  • 全局组织结算账号管理员：创建、管理和绑定 BillingAccount 资源。请让组织 IAM 管理员为您授予 organization-billing-account-admin 角色。

  • 全局组织结算账号用户：读取、列出和绑定 BillingAccount 资源。请让组织 IAM 管理员为您授予 organization-billing-account-user 角色。

  • Global Organization Billing Account Manager：读取、列出、创建和更新 BillingAccountBinding 资源。请让您的组织 IAM 管理员为您授予 organization-billing-manager 角色。

获取 kubeconfig 文件

如需针对全球 API 服务器运行命令，请确保您拥有以下资源：

  1. 登录并生成全局 API 服务器的 kubeconfig 文件（如果您还没有）。

  2. 使用全局 API 服务器的 kubeconfig 文件路径替换这些说明中的 GLOBAL_API_SERVER_KUBECONFIG。

创建新结算账号

结算账号由其 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 以在全局 API 服务器中应用资源：

    kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG apply -f billingaccount.yaml

    将 GLOBAL_API_SERVER_KUBECONFIG 替换为全局 API 服务器 kubeconfig 文件。

本部分提供了一系列将组织或项目与 BillingAccount 相关联的步骤。

如需将项目与 BillingAccount 相关联，请执行以下操作：

  1. 将以下内容添加到文件 billingaccountbinding.yaml 中：

    • 在 billingAccountRef 部分中，使用要链接的 BillingAccount 中的内容填充 name 字段。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