Créer des utilisations récurrentes

Cette page explique comment l'opérateur d'infrastructure (IO) peut créer des utilisations récurrentes pour gérer les coûts de facturation de votre instance Google Distributed Cloud (GDC) isolée et les informations sur l'utilisation des services.

La ressource RecurringUsage vous permet de définir les frais pour un SKU particulier sur une période constante et définie. Par exemple, vous commandez un service pour un an qui commence et se termine au cours d'une année civile. Distributed Cloud propose des unités de gestion des stocks (SKU) qui entraînent des frais en fonction de l'utilisation et des SKU qui ne sont pas basés sur l'utilisation. Pour gérer les frais fixes récurrents mensuels, utilisez la ressource RecurringUsage de l'API Billing.

Déterminer vos exigences liées à la facturation

La configuration d'abonnements à prix fixe avec une ressource RecurringUsage est facultative. Pour déterminer vos exigences de facturation, tenez compte des cas d'utilisation suivants :

  • Si vous utilisez la facturation Google Cloud pour suivre les coûts fixes et la facturation, vous n'avez pas besoin de configurer les frais d'utilisation récurrents dans votre environnement Distributed Cloud.

  • Si vous souhaitez ajouter des frais récurrents fixes mensuels (par exemple, des frais d'assistance), vous devez les associer à un SKU (par exemple, un SKU d'assistance). Dans ce cas, vous devez configurer la ressource ReccurringUsage.

Avant de commencer

Avant de continuer, assurez-vous de disposer des éléments suivants :

  • Le rôle de lecteur de la facturation de l'organisation dans le cluster d'administrateur de l'organisation. Contactez votre Administrateur de sécurité pour qu'il vous attribue le rôle Lecteur de la facturation de l'organisation (organization-billing-viewer) pour l'espace de noms billing-system. Cette autorisation vous permet de lire les ressources associées pour la validation.

  • Un dépôt iac avec un fichier kustomization.yaml et un répertoire recurringusages pour stocker les fichiers avec la ressource personnalisée RecurringUsages.

Créer une ressource personnalisée RecurringUsage

Pour créer la ressource RecurringUsage, procédez comme suit :

  1. Créez un fichier YAML avec le chemin d'accès infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Remplacez les variables suivantes :

    • TARGET_CLUSTER : nom du cluster auquel vous avez accès, ici avec le cluster d'administrateur de l'organisation.
    • RECURRING_USAGE_NAME : nom que vous attribuez au fichier YAML.

  2. Ajoutez la ressource RecurringUsage et le contenu suivant :

    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

    Remplacez les variables suivantes :

    Variable Description
    RECURRING_USAGE_NAME Nom à attribuer à la ressource. Vous devez attribuer des noms uniques à chaque ressource que vous créez. Pour rendre le nom unique, ajoutez un code temporel après le nom que vous attribuez à SKU_DESCRIPTION_NAME. Par exemple :
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME Nom de la description du SKU référencé, qui est SKU_ID en minuscules. Le nom de la description du SKU se compose de 12 caractères alphanumériques en minuscules, séparés par des tirets en groupes de quatre caractères. Exemple : 0000-ffff-aaaa.
    UNITS Unité entière de quantité d'utilisation. Par exemple, si le montant facturé correspond à 1.50 unités, définissez ce champ sur 1 et le champ NANOS sur 500000000.
    NANOS Nano d'une unité entière. Par exemple, si le montant facturé est de 1,50 unité, définissez le champ UNITS sur 1 et ce champ sur 500000000.
    START_TIME Code temporel à partir duquel la facturation d'un SKU donné commence. Le code temporel doit être au format RFC 3339. Par exemple, si vous commandez un service qui commence le 01/01/2024, ajoutez la valeur du code temporel sous la forme 2024-01-01T00:00:00Z.

    Ce champ est facultatif. Si vous ne le définissez pas, les frais sont facturés dès que vous envoyez la demande de fusion dans GitLab. Vous ne pouvez pas définir ce champ avant d'envoyer la demande de fusion dans GitLab. Si l'heure de début demandée est passée, escaladez l'incident au service d'assistance GDC.
    END_TIME Code temporel de fin de la facturation pour un SKU donné. Le code temporel doit être au format RFC 3339. Par exemple, si vous commandez un service qui commence le 01/01/2024 et se termine le 01/01/2025, ajoutez la valeur du code temporel sous la forme 2025-01-01T00:00:00Z.

     Ce champ est facultatif. Si vous ne le définissez pas, les frais continueront à s'appliquer. Vous ne pouvez pas définir ce champ avant d'envoyer la demande de fusion dans GitLab. Si l'heure de fin demandée est passée, escaladez l'incident à l'assistance GDC.

  3. Enregistrez et stockez l'utilisation récurrente dans le dossier recurringusages.

  4. Créez une demande d'extraction contenant le fichier YAML ainsi que le fichier kustomization nécessaire.

  5. Vérifiez que la ressource personnalisée RecurringUsage est créée :

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

    Si vous ne parvenez pas à créer la ressource personnalisée RecurringUsage, suivez les instructions de la section IAC-R0001 pour examiner le problème plus en détail.