Ce document explique comment utiliser le fournisseur Terraform Google Cloud pour créer des canaux de notification dans votre projet Google Cloud. Le fournisseur Terraform pour Google Cloud propose les ressources suivantes pour les règles d'alerte et les canaux de notification:
Terraform est un outil permettant de créer, de modifier et de gérer les versions d'infrastructure. Il utilise des fichiers de configuration pour décrire les composants nécessaires à l'exécution d'une application donnée ou de l'ensemble de votre infrastructure. Pour en savoir plus sur l'utilisation de Terraform, consultez les ressources suivantes:
- Documentation Terraform sur Google Cloud
- Fournisseur Terraform pour Google Cloud
- Premiers pas avec Google Cloud
Avant de commencer
Pour obtenir les autorisations nécessaires pour créer et modifier des canaux de notification à l'aide de Terraform, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de canaux de notification (roles/monitoring.notificationChannelEditor
) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Pour en savoir plus sur les rôles Cloud Monitoring, consultez Contrôler les accès avec Identity and Access Management.
Créer un canal de notification
Pour créer un canal de notification dans votre projet Google Cloud, procédez comme suit:
Assurez-vous que Terraform est installé dans Cloud Shell.
Dans Cloud Shell, accédez au répertoire contenant votre configuration Terraform.
Modifiez le fichier de configuration et ajoutez votre canal de notification.
Par exemple, la configuration suivante définit un canal de notification par e-mail:
resource "google_monitoring_notification_channel" "email" { display_name = "Tier 1 Support Email" type = "email" labels = { email_address = "USER_EMAIL" } }
Dans Cloud Shell, saisissez
terraform apply
.
Modifier ou supprimer des canaux de notification
Pour modifier ou supprimer un canal de notification dans votre projet Google Cloud, procédez comme suit:
Assurez-vous que Terraform est installé dans Cloud Shell.
Dans Cloud Shell, accédez au répertoire contenant votre configuration Terraform.
Modifiez votre fichier de configuration, recherchez la ressource
google_monitoring_notification_channel
de votre canal de notification, puis modifiez-la ou supprimez-la.Dans Cloud Shell, saisissez
terraform apply
.
Étape suivante
- Créez des règles d'alerte avec Terraform.
- Apprenez-en plus sur Terraform.
- Testez des exemples de code qui utilisent le fournisseur Terraform pour Google Cloud avec Cloud Monitoring.
- Consultez le dépôt GitHub du fournisseur Terraform pour Google Cloud.
- Ouvrez une demande sur GitHub pour signaler un bug ou poser une question sur Terraform.