Faça a gestão das políticas de alerta com o Terraform

Este documento descreve como usar o Google Cloud Terraform Provider para editar e eliminar políticas de alerta no seu Google Cloud projeto. O Google Cloud fornecedor do Terraform disponibiliza os seguintes recursos para políticas de alerta e canais de notificação:

O Terraform é uma ferramenta para criar, alterar e controlar versões de infraestruturas. Usa ficheiros de configuração para descrever os componentes necessários para executar uma única aplicação ou toda a sua infraestrutura. Para mais informações sobre a utilização do Terraform, consulte os seguintes documentos:

Esta funcionalidade só é suportada para projetos do Google Cloud . Para configurações do App Hub, selecione o projeto anfitrião ou o projeto de gestão do App Hub.

Antes de começar

Para receber as autorizações de que precisa para modificar as políticas de alerta através do Terraform, peça ao seu administrador que lhe conceda as seguintes funções de IAM no seu projeto:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções do Cloud Monitoring, consulte o artigo Controle o acesso com a gestão de identidade e acesso.

Edite ou elimine políticas de alerta

Para editar ou eliminar uma política de alerta no seu Google Cloud projeto, faça o seguinte:

  1. Instale e configure o Terraform para o seu projeto. Para configurações do App Hub, selecione o projeto anfitrião ou o projeto de gestão do App Hub.

  2. No Cloud Shell, aceda ao diretório que contém a configuração do Terraform.

  3. Edite o ficheiro de configuração, localize o google_monitoring_alert_policyrecurso para a sua política de alertas e, em seguida, modifique ou elimine esse recurso.

  4. No Cloud Shell, introduza terraform apply.

Exporte uma configuração de política de alerta para uma configuração do Terraform

Pode exportar uma configuração de política de alerta de Google Cloud para uma definição do Terraform na sua configuração do Terraform. Este processo é útil se tiver criado uma política de alerta no Google Cloud depois de criar a configuração do Terraform.

Para exportar a sua política de alertas, faça o seguinte:

  1. Instale e configure o Terraform para o seu projeto. Para configurações do App Hub, selecione o projeto anfitrião ou o projeto de gestão do App Hub.

  2. No Cloud Shell, aceda ao diretório que contém a configuração do Terraform.

  3. Adicione um bloco import a um ficheiro na sua configuração do Terraform. O bloco de importação tem os seguintes argumentos:

    • to: o endereço do recurso, conforme especificado na sua configuração do Terraform. Este campo tem o formato google_monitoring_alert_policy.RESOURCE_NAME, em que RESOURCE_NAME é um valor à sua escolha. Recomendamos que escolha um nome de recurso que descreva claramente a sua política de alertas.

    • id: o nome da política de alerta. Este campo tem o formato de project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID.

    Por exemplo, quer exportar uma política de alertas que monitorize a utilização da CPU, pelo que define RESOURCE_NAME como cpu_usage_threshold. Em seguida, define id como o nome da política de alerta:

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

  4. No Cloud Shell, execute o seguinte comando:

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

    O comando anterior cria um ficheiro denominado generated.tf, que lhe permite rever a definição da política de alertas antes de a adicionar à configuração do Terraform. Pode editar a definição, movê-la para um ficheiro diferente ou deixá-la inalterada.

  5. No Cloud Shell, introduza terraform apply para importar a definição da política de alerta para a configuração do Terraform.

Para mais informações sobre como gerar definições para recursos que não fazem parte da sua configuração do Terraform, consulte o artigo Gerar configuração.

O que se segue?

  • Saiba mais sobre o Terraform.
  • Experimente exemplos de código que usam o Google Cloud fornecedor do Terraform com o Cloud Monitoring.
  • Veja o repositório do Google Cloud fornecedor do Terraform no GitHub.
  • Apresente um problema do GitHub para comunicar um erro ou fazer uma pergunta sobre o Terraform.