Gestire i criteri di avviso con Terraform

Questo documento descrive come utilizzare il providerGoogle Cloud Terraform per modificare ed eliminare le policy di avviso nel tuo progetto Google Cloud . Il Google Cloud provider Terraform fornisce le seguenti risorse per i criteri di avviso e i canali di notifica:

Terraform è uno strumento per creare, modificare e sottoporre al controllo delle versioni l'infrastruttura. Utilizza i file di configurazione per descrivere i componenti necessari per eseguire una singola applicazione o l'intera infrastruttura. Per saperne di più sull'utilizzo di Terraform, consulta i seguenti documenti:

Questa funzionalità è supportata solo per i progetti Google Cloud . Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

Prima di iniziare

Per ottenere le autorizzazioni necessarie per modificare le policy di avviso utilizzando Terraform, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sui ruoli Cloud Monitoring, consulta Controllare l'accesso con Identity and Access Management.

Modificare o eliminare le policy di avviso

Per modificare o eliminare un criterio di avviso nel tuo Google Cloud progetto:

  1. Installa e configura Terraform per il tuo progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

  2. In Cloud Shell, vai alla directory che contiene la configurazione Terraform.

  3. Modifica il file di configurazione, individua la risorsa google_monitoring_alert_policy per il criterio di avviso, quindi modifica o elimina la risorsa.

  4. In Cloud Shell, inserisci terraform apply.

Esportare la configurazione di un criterio di avviso in una configurazione Terraform

Puoi esportare una configurazione di criterio di avviso da Google Cloud a una definizione Terraform nella tua configurazione Terraform. Questo processo è utile se hai creato una criterio di avviso in Google Cloud dopo aver creato la configurazione Terraform.

Per esportare il criterio di avviso:

  1. Installa e configura Terraform per il tuo progetto. Per le configurazioni di App Hub, seleziona il progetto host di App Hub o il progetto di gestione della cartella app.

  2. In Cloud Shell, vai alla directory che contiene la configurazione Terraform.

  3. Aggiungi un blocco import a un file nella tua configurazione Terraform. Il blocco di importazione ha i seguenti argomenti:

    • to: l'indirizzo della risorsa specificato nella configurazione di Terraform. Questo campo ha il formato google_monitoring_alert_policy.RESOURCE_NAME, dove RESOURCE_NAME è un valore a tua scelta. Ti consigliamo di scegliere un nome risorsa che descriva chiaramente la tuacriterio di avvisoo.

    • id: il nome della criterio di avviso. Questo campo ha il formato project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    Ad esempio, vuoi esportare una criterio di avviso che monitora l'utilizzo della CPU, quindi imposti RESOURCE_NAME su cpu_usage_threshold. Poi imposta id come nome della policy di avviso:

    import {
to = google_monitoring_alert_policy.cpu_usage_threshold
id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
}

  4. In Cloud Shell, esegui questo comando:

    terraform plan -generate-config-out=generated.tf

    Il comando precedente crea un file denominato generated.tf, che ti consente di esaminare la definizionecriterio di avvisoo prima di aggiungerla alla configurazione di Terraform. Puoi modificare la definizione, spostarla in un altro file o lasciarla invariata.

  5. In Cloud Shell, inserisci terraform apply per importare la definizione criterio di avviso nella configurazione Terraform.

Per saperne di più sulla generazione di definizioni per le risorse che non fanno parte della configurazione Terraform, consulta Generazione della configurazione.

Passaggi successivi

  • Scopri di più su Terraform.
  • Prova gli esempi di codice che utilizzano il provider TerraformGoogle Cloud con Cloud Monitoring.
  • Visualizza il Google Cloud repository del provider Terraform su GitHub.
  • Invia una segnalazione su GitHub per segnalare un bug o porre una domanda su Terraform.