Crear usos periódicos

En esta página se explica cómo puede crear un operador de infraestructura (IO) usos recurrentes para gestionar los costes de facturación de su instancia aislada de Google Distributed Cloud (GDC) y la información sobre el uso de los servicios.

El recurso RecurringUsage le permite definir la tarifa de un SKU concreto en una cronología constante y definida. Por ejemplo, pides un servicio durante un año que empieza y termina en el mismo año natural. Distributed Cloud ofrece unidades de mantenimiento de stock (SKUs) que incurren en cargos basados en el uso y SKUs que no se basan en el uso. Para gestionar las tarifas fijas periódicas mensuales, usa el recurso RecurringUsage de la API Billing.

Determinar los requisitos de facturación

Configurar suscripciones de tarifa fija con un recurso de RecurringUsage es un paso opcional. Para determinar tus requisitos de facturación, ten en cuenta los siguientes casos prácticos:

  • Si usas la Google Cloud facturación para monitorizar los costes fijos y la facturación, no tienes que configurar tarifas de uso recurrentes en tu entorno de Distributed Cloud.

  • Si quieres añadir una cuota periódica fija mensual, como los costes de asistencia, debes asociar la cuota periódica a un SKU, por ejemplo, un SKU de asistencia. En ese caso, debes continuar con la ReccurringUsage configuración de recursos.

Antes de empezar

Antes de continuar, asegúrate de que tienes lo siguiente:

  • El rol Lector de facturación de la organización en el clúster de administrador de la organización. Ponte en contacto con tu administrador de seguridad para que te conceda el rol de lector de facturación de la organización (organization-billing-viewer) en el espacio de nombres billing-system. Este permiso te permite leer recursos relacionados para la validación.

  • Un repositorio iac con un archivo kustomization.yaml y un directorio recurringusages para almacenar los archivos con el recurso personalizado RecurringUsages.

Crear un recurso personalizado RecurringUsage

Para crear el recurso RecurringUsage, sigue estos pasos:

  1. Crea un archivo YAML con la ruta infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Sustituye las siguientes variables:

    • TARGET_CLUSTER: el nombre del clúster al que tienes acceso, en este caso, el clúster de administrador de la organización.
    • RECURRING_USAGE_NAME: el nombre que le asignes al archivo YAML.

  2. Añade el recurso RecurringUsage y el siguiente contenido:

    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

    Sustituye las siguientes variables:

    Variable Descripción
    RECURRING_USAGE_NAME Nombre que se va a asignar al recurso. Cada recurso que cree debe tener un nombre único. Para que el nombre sea único, añade una marca de tiempo después del nombre que le asignes a SKU_DESCRIPTION_NAME. Por ejemplo:
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME Nombre de la descripción del SKU referenciado, que es SKU_ID en minúsculas. El nombre de la descripción del SKU consta de 12 caracteres alfanuméricos en minúscula, separados por guiones en grupos de cuatro caracteres. Por ejemplo: 0000-ffff-aaaa.
    UNITS Una unidad completa de cantidad de uso. Por ejemplo, si el cargo es de 1.50 unidades, define este campo como 1 y el campo NANOS como 500000000.
    NANOS Una unidad nano de una unidad completa. Por ejemplo, si el cargo es de 1,50 unidades, defina el campo UNITS como 1 y este campo como 500000000.
    START_TIME Marca de tiempo para iniciar el cargo de un SKU determinado. La marca de tiempo debe seguir el formato RFC 3339. Por ejemplo, si pide un servicio que empieza el 01/01/2024, añada el valor de la marca de tiempo como 2024-01-01T00:00:00Z.

    Este campo es opcional. Si no se define, el cargo se aplicará en cuanto envíes la solicitud de combinación en GitLab. No puedes definir este campo antes de enviar la solicitud de combinación en GitLab. Si la hora de inicio solicitada ya ha pasado, deriva el incidente al equipo de Asistencia del GDC.
    END_TIME Marca de tiempo que indica cuándo finaliza el cargo de un SKU determinado. La marca de tiempo debe seguir el formato RFC 3339. Por ejemplo, si pide un servicio que empieza el 01/01/2024 y termina el 01/01/2025, añada el valor de la marca de tiempo como 2025-01-01T00:00:00Z.

    Este campo es opcional. Si no se define, se seguirá cobrando. No puedes definir este campo antes de enviar la solicitud de combinación en GitLab. Si la hora de finalización solicitada ya ha pasado, deriva el incidente al equipo de Asistencia de GDC.

  3. Guarda y almacena el uso periódico en la carpeta recurringusages.

  4. Crea una solicitud de extracción que contenga el archivo YAML junto con el archivo kustomization necesario.

  5. Verifica que se haya creado el recurso personalizado RecurringUsage:

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

    Si no puedes crear el recurso personalizado RecurringUsage, sigue las instrucciones de IAC-R0001 para investigar el problema.