Crie utilizações recorrentes

Esta página abrange instruções para o operador de infraestrutura (IO) criar utilizações recorrentes para gerir os custos de faturação da sua instância isolada do Google Distributed Cloud (GDC) e informações de utilização do serviço.

O recurso RecurringUsage permite-lhe definir a taxa de um SKU específico numa cronologia constante e definida. Por exemplo, encomenda um serviço durante um ano que começa e termina num ano anual. O Distributed Cloud oferece unidades de controlo do stock (SKU) que incorrem em custos com base na utilização e SKUs que não se baseiam na utilização. Para gerir taxas fixas recorrentes mensais, use o recurso RecurringUsage da API Billing.

Determine os seus requisitos de faturação

A configuração de subscrições de taxa fixa com um recurso RecurringUsage é um passo opcional. Para determinar os seus requisitos de faturação, considere os seguintes exemplos de utilização:

  • Se usar a Google Cloud faturação para acompanhar os custos fixos e a faturação, não tem de configurar taxas de utilização recorrentes no seu ambiente da Distributed Cloud.

  • Se quiser adicionar uma taxa recorrente fixa mensal, por exemplo, custos de apoio técnico, tem de associar a taxa recorrente a um SKU, por exemplo, um SKU de apoio técnico. Neste caso, tem de continuar com a configuração do recurso ReccurringUsage.

Antes de começar

Antes de continuar, certifique-se de que tem o seguinte:

  • A função de visitante de faturação da organização no cluster de administrador da organização. Contacte o seu administrador de segurança para lhe conceder a função de visualizador de faturação da organização (organization-billing-viewer) para o espaço de nomes billing-system. Esta autorização permite-lhe ler recursos relacionados para validação.

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

    SKUDescription

Crie um RecurringUsage recurso personalizado

Para criar o recurso RecurringUsage, siga os seguintes passos:

  1. Crie um ficheiro 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 ao qual tem acesso, aqui com o cluster de administrador da organização.
    • RECURRING_USAGE_NAME: o nome que atribui ao ficheiro YAML.

  2. Adicione o recurso RecurringUsage e os seguintes conteúdos:

    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 atribuir ao recurso. Para cada recurso que criar, tem de atribuir nomes exclusivos. Para tornar o nome exclusivo, anexe uma data/hora após o nome que atribui 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 do SKU referenciado, que é o SKU_ID em letras minúsculas. O nome da descrição do SKU consiste em 12 carateres alfanuméricos em minúsculas, separados por traços em grupos de quatro carateres. Por exemplo: 0000-ffff-aaaa.
    UNITS Uma unidade inteira da quantidade de utilização. 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 o custo for de 1,50 unidades, defina o campo UNITS como 1 e este campo como 500000000.
    START_TIME A indicação de tempo para iniciar a cobrança de um determinado SKU. A data/hora tem de seguir o formato RFC 3339. Por exemplo, se encomendar um serviço que começa a 01/01/2024, adicione o valor da data/hora como 2024-01-01T00:00:00Z.

    Este campo é opcional e, se não for definido, a cobrança é feita assim que enviar o pedido de união no GitLab. Não pode definir este campo antes de enviar o pedido de união no GitLab. Se a hora de início pedida for no passado, encaminhe o incidente para o apoio técnico do GDC.
    END_TIME A data/hora para terminar a cobrança de um determinado SKU. A data/hora tem de seguir o formato RFC 3339. Por exemplo, se encomendar um serviço que começa a 01/01/2024 e termina a 01/01/2025, adicione o valor da data/hora como 2025-01-01T00:00:00Z.

    Este campo é opcional e, se não for definido, a cobrança continua a ser aplicada. Não pode definir este campo antes de enviar o pedido de união no GitLab. Se a hora de fim pedida for no passado, encaminhe o incidente para o apoio técnico do GDC.

  3. Guarde e armazene a utilização recorrente na pasta recurringusages.

  4. Crie um pedido de obtenção que contenha o ficheiro YAML juntamente com o ficheiro 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 conseguir criar o recurso personalizado RecurringUsage, siga as instruções em "IAC-R0001" para investigar o problema mais detalhadamente.