Crea utilizzi ricorrenti

Questa pagina contiene le istruzioni per l'operatore dell'infrastruttura (IO) per creare utilizzi ricorrenti per gestire i costi di fatturazione per l'istanza e le informazioni sull'utilizzo dei servizi Google Distributed Cloud (GDC) air-gapped.

La risorsa RecurringUsage ti consente di definire la commissione per uno SKU specifico in un periodo di tempo costante e definito. Ad esempio, ordini un servizio per un anno che inizia e termina entro un anno. Distributed Cloud offre sia stock keeping unit (SKU) che comportano addebiti in base all'utilizzo, sia SKU non basati sull'utilizzo. Per gestire le tariffe fisse ricorrenti mensili, utilizza la RecurringUsage risorsa dell'API Billing.

Determinare i requisiti di fatturazione

La configurazione di abbonamenti a tariffa fissa con una risorsa RecurringUsage è un passaggio facoltativo. Per determinare i requisiti di fatturazione, considera i seguenti casi d'uso:

  • Se utilizzi Google Cloud Billing per monitorare i costi fissi e la fatturazione, non devi configurare le tariffe di utilizzo ricorrenti nel tuo ambiente Distributed Cloud.

  • Se vuoi aggiungere una tariffa ricorrente fissa mensile, ad esempio i costi di assistenza, devi associare la tariffa ricorrente a uno SKU, ad esempio lo SKU di assistenza. In questo caso, devi procedere con la configurazione della risorsa ReccurringUsage.

Prima di iniziare

Prima di continuare, assicurati di avere quanto segue:

  • Il ruolo Visualizzatore fatturazione organizzazione nel cluster amministratore dell'organizzazione. Contatta l'Amministratore sicurezza per ottenere il ruolo Visualizzatore fatturazione organizzazione (organization-billing-viewer) per lo spazio dei nomi billing-system. Questa autorizzazione ti consente di leggere le risorse correlate per la convalida.

  • Un repository iac con un file kustomization.yaml e una directory recurringusages per archiviare i file con la risorsa personalizzata RecurringUsages.

Creare una risorsa personalizzata RecurringUsage

Per creare la risorsa RecurringUsage, segui questi passaggi:

  1. Crea un file YAML con il percorso infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Sostituisci le seguenti variabili:

    • TARGET_CLUSTER: il nome del cluster a cui hai accesso, in questo caso il cluster di amministrazione dell'organizzazione.
    • RECURRING_USAGE_NAME: il nome che assegni al file YAML.

  2. Aggiungi la risorsa RecurringUsage e i seguenti contenuti:

    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

    Sostituisci le seguenti variabili:

    Variabile Descrizione
    RECURRING_USAGE_NAME Il nome da assegnare alla risorsa. Per ogni risorsa creata, devi assegnare nomi univoci. Per rendere univoco il nome, aggiungi un timestamp dopo il nome che assegni a SKU_DESCRIPTION_NAME. Ad esempio:
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME Il nome della descrizione SKU a cui viene fatto riferimento, ovvero la stringa minuscola SKU_ID. Il nome della descrizione dello SKU è composto da 12 caratteri alfanumerici minuscoli, separati da trattini in gruppi di quattro caratteri. Ad esempio: 0000-ffff-aaaa.
    UNITS Un'unità intera di quantità di utilizzo. Ad esempio, se l'addebito è per 1.50 unità, imposta questo campo su 1 e il campo NANOS su 500000000.
    NANOS Un nano di un'intera unità. Ad esempio, se l'addebito è per 1,50 unità, imposta il campo UNITS su 1 e questo campo su 500000000.
    START_TIME Il timestamp per iniziare l'addebito per un determinato SKU. Il timestamp deve seguire il formato RFC 3339. Ad esempio, se ordini un servizio che inizia il giorno 01/01/2024, aggiungi il valore del timestamp come 2024-01-01T00:00:00Z.

    Questo campo è facoltativo e, se non viene impostato, l'addebito viene effettuato non appena invii la richiesta di unione in GitLab. Non puoi impostare questo campo prima di inviare la richiesta di unione in GitLab. Se l'ora di inizio richiesta è nel passato, riassegna l'incidente all'assistenza GDC.
    END_TIME Il timestamp per terminare l'addebito per un determinato SKU. Il timestamp deve seguire il formato RFC 3339. Ad esempio, se ordini un servizio che inizia il giorno 01/01/2024 e termina il giorno 01/01/2025, aggiungi il valore del timestamp come 2025-01-01T00:00:00Z.

    Questo campo è facoltativo e, se non viene impostato, l'addebito continua a essere applicato. Non puoi impostare questo campo prima di inviare la richiesta di unione in GitLab. Se l'ora di fine richiesta è nel passato, riassegna l'incidente all'assistenza GDC.

  3. Salva e archivia l'utilizzo ricorrente nella cartella recurringusages.

  4. Crea una richiesta di pull contenente il file YAML insieme al file kustomization necessario.

  5. Verifica che la risorsa personalizzata RecurringUsage sia stata creata:

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

    Se non riesci a creare la risorsa personalizzata RecurringUsage, segui le istruzioni riportate in "IAC-R0001" per esaminare ulteriormente il problema.