Criar usos recorrentes

Esta página contém instruções para o operador de infraestrutura (IO) criar usos recorrentes para gerenciar custos de faturamento da sua instância isolada do Google Distributed Cloud (GDC) e informações de uso do serviço.

O recurso RecurringUsage permite definir a taxa de uma SKU específica em uma linha do tempo constante e definida. Por exemplo, você pede um serviço por um ano que começa e termina dentro de um ano civil. O Distributed Cloud oferece unidades de manutenção de estoque (SKUs) que geram cobranças com base no uso e SKUs que não são baseadas no uso. Para gerenciar taxas fixas recorrentes mensais, use o recurso RecurringUsage da API Billing.

Determinar os requisitos de faturamento

Configurar assinaturas de taxa fixa com um recurso RecurringUsage é uma etapa opcional. Para determinar seus requisitos de faturamento, considere os seguintes casos de uso:

  • Se você usa o faturamento do Google Cloud para rastrear custos fixos e faturamento, não é necessário configurar taxas de uso recorrentes no ambiente do Distributed Cloud.

  • Se você quiser adicionar uma taxa recorrente mensal fixa, por exemplo, custos de suporte, associe a taxa a uma SKU, como uma SKU de suporte. Nesse caso, continue com a configuração do recurso ReccurringUsage.

Antes de começar

Antes de continuar, verifique se você tem o seguinte:

  • O papel de leitor de faturamento da organização no cluster de administrador da organização. Entre em contato com seu administrador de segurança para conceder a você o papel de Leitor de faturamento da organização (organization-billing-viewer) para o namespace billing-system. Essa permissão permite ler recursos relacionados para validação.

  • Um repositório iac com um arquivo kustomization.yaml e um diretório recurringusages para armazenar os arquivos com o recurso personalizado RecurringUsages.

Criar um recurso personalizado RecurringUsage

Para criar o recurso RecurringUsage, siga estas etapas:

  1. Crie um arquivo YAML com o caminho infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Substitua as seguintes variáveis:

    • TARGET_CLUSTER: o nome do cluster a que você tem acesso, aqui com o cluster de administrador da organização.
    • RECURRING_USAGE_NAME: o nome que você dá ao arquivo YAML.

  2. Adicione o recurso RecurringUsage e o seguinte conteúdo:

    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

    Substitua as seguintes variáveis:

    Variável Descrição
    RECURRING_USAGE_NAME O nome a ser atribuído ao recurso. Para cada recurso criado, você precisa dar nomes exclusivos. Para tornar o nome exclusivo, anexe um carimbo de data/hora depois do nome que você der a SKU_DESCRIPTION_NAME. Por exemplo:
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME O nome da descrição da SKU referenciada, que é SKU_ID em letras minúsculas. O nome da descrição da SKU consiste em 12 caracteres alfanuméricos minúsculos, separados por traços em grupos de quatro caracteres. Por exemplo, 0000-ffff-aaaa.
    UNITS Uma unidade inteira de quantidade de uso. Por exemplo, se a cobrança for de 1.50 unidades, defina este campo como 1 e o campo NANOS como 500000000.
    NANOS Um nano de uma unidade inteira. Por exemplo, se a cobrança for de 1,50 unidade, defina o campo UNITS como 1 e este campo como 500000000.
    START_TIME O carimbo de data/hora para iniciar a cobrança de uma determinada SKU. O carimbo de data/hora precisa seguir o formato RFC 3339. Por exemplo, se você pedir um serviço que começa em 01/01/2024, adicione o valor de carimbo de data/hora como 2024-01-01T00:00:00Z.

    Esse campo é opcional. Se não for definido, a cobrança será feita assim que você enviar a solicitação de mesclagem no GitLab. Não é possível definir esse campo antes de enviar a solicitação de mesclagem no GitLab. Se o horário de início solicitado for no passado, encaminhe o incidente para o suporte do GDC.
    END_TIME O carimbo de data/hora para encerrar a cobrança de uma determinada SKU. O carimbo de data/hora precisa seguir o formato RFC 3339. Por exemplo, se você pedir um serviço que começa em 01/01/2024 e termina em 01/01/2025, adicione o valor de carimbo de data/hora como 2025-01-01T00:00:00Z.

    Esse campo é opcional e, se não for definido, a cobrança vai continuar sendo feita. Não é possível definir esse campo antes de enviar a solicitação de mesclagem no GitLab. Se o horário de término solicitado já passou, encaminhe o incidente para o suporte do GDC.

  3. Salve e armazene o uso recorrente na pasta recurringusages.

  4. Crie uma solicitação de envio com o arquivo YAML e o arquivo kustomization necessário.

  5. Verifique se o recurso personalizado RecurringUsage foi criado:

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

    Se não for possível criar o recurso personalizado RecurringUsage, siga as instruções em IAC-R0001 para investigar o problema.