Crea usos recurrentes

En esta página, se incluyen instrucciones para que el operador de infraestructura (IO) cree usos recurrentes para administrar los costos de facturación de tu instancia y la información de uso de los servicios de Google Distributed Cloud (GDC) aislados.

El recurso RecurringUsage te permite definir la comisión para un SKU en particular en un período constante y definido. Por ejemplo, pides un servicio por un año que comienza y finaliza dentro de un año anual. Distributed Cloud ofrece tanto unidades de mantenimiento de existencias (SKU) que generan cargos según el uso como SKU que no se basan en el uso. Para administrar las comisiones fijas recurrentes mensuales, usa el recurso RecurringUsage de la API de Billing.

Determina tus requisitos de facturación

Configurar suscripciones de tarifa fija con un recurso RecurringUsage es un paso opcional. Para determinar tus requisitos de facturación, considera los siguientes casos de uso:

  • Si usas Google Cloud Billing para hacer un seguimiento de los costos fijos y la facturación, no es necesario que configures tarifas de uso recurrentes en tu entorno de Distributed Cloud.

  • Si deseas agregar una tarifa recurrente fija mensual, por ejemplo, costos de asistencia, debes asociar la tarifa recurrente con un SKU, por ejemplo, un SKU de asistencia. En este caso, debes continuar con la configuración del recurso ReccurringUsage.

Antes de comenzar

Antes de continuar, asegúrate de tener lo siguiente:

  • El rol de visualizador de facturación de la organización en el clúster de administrador de la organización Comunícate con tu administrador de seguridad para que te otorgue el rol de visualizador de facturación de la organización (organization-billing-viewer) para el espacio de nombres billing-system. Este permiso te permite leer recursos relacionados para la validación.

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

Crea un recurso personalizado RecurringUsage

Para crear el recurso RecurringUsage, sigue estos pasos:

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

    Reemplaza las siguientes variables:

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

  2. Agrega 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

    Reemplaza las siguientes variables:

    Variable Descripción
    RECURRING_USAGE_NAME Nombre que se le dará al recurso. Debes asignar nombres únicos a cada recurso que crees. Para que el nombre sea único, agrega 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 al que se hace referencia, 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 Es una unidad completa de cantidad de uso. Por ejemplo, si el cargo es por 1.50 unidades, establece este campo en 1 y el campo NANOS en 500000000.
    NANOS Es una nanounidad de una unidad entera. Por ejemplo, si el cargo es por 1.50 unidades, establece el campo UNITS en 1 y este campo en 500000000.
    START_TIME Es la marca de tiempo para comenzar el cargo de un SKU determinado. La marca de tiempo debe seguir el formato RFC 3339. Por ejemplo, si solicitas un servicio que comienza el 01/01/2024, agrega el valor de la marca de tiempo como 2024-01-01T00:00:00Z.

    Este campo es opcional y, si no se configura, el cargo se aplica en cuanto envías la solicitud de combinación en GitLab. No puedes configurar este campo antes de enviar la solicitud de combinación en GitLab. Si la hora de inicio solicitada es anterior a la actual, deriva el incidente al equipo de asistencia de GDC.
    END_TIME Es la marca de tiempo que indica el final del cargo para un SKU determinado. La marca de tiempo debe seguir el formato RFC 3339. Por ejemplo, si solicitas un servicio que comienza el 01/01/2024 y finaliza el 01/01/2025, agrega el valor de la marca de tiempo como 2025-01-01T00:00:00Z.

    Este campo es opcional y, si no se configura, se seguirá aplicando el cargo. No puedes configurar este campo antes de enviar la solicitud de combinación en GitLab. Si la hora de finalización solicitada ya pasó, deriva el incidente al equipo de asistencia de GDC.

  3. Guarda y almacena el uso recurrente 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 en "IAC-R0001" para investigar el problema más a fondo.