使用 Terraform 管理提醒政策

本文档介绍如何使用 Google Cloud Terraform 提供程序在 Google Cloud 项目中修改和删除提醒政策。Google Cloud Terraform 提供程序为提醒政策和通知渠道提供了以下资源:

Terraform 是一种用于构建、更改和版本控制基础架构的工具。它使用配置文件来描述运行单个应用或整个基础架构所需的组件。如需详细了解如何使用 Terraform,请参阅以下文档:

准备工作

如需获取使用 Terraform 修改提醒政策所需的权限,请让管理员授予您项目的 Monitoring Editor (roles/monitoring.alertPolicyEditor) IAM 角色。如需详细了解如何授予角色,请参阅管理访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

如需详细了解 Cloud Monitoring 角色,请参阅使用 Identity and Access Management 控制访问权限

修改或删除提醒政策

如需在 Google Cloud 项目中修改或删除提醒政策,请执行以下操作:

  1. 确保 Terraform 已安装在 Cloud Shell 中。

  2. 在 Cloud Shell 中,转到包含 Terraform 配置的目录。

  3. 修改配置文件,找到提醒政策的 google_monitoring_alert_policy 资源,然后修改或删除该资源。

  4. 在 Cloud Shell 中,输入 terraform apply

将提醒政策配置导出到 Terraform 配置

您可以将提醒政策配置从 Google Cloud 导出到 Terraform 配置中的 Terraform 定义。如果您在创建 Terraform 配置之后在 Google Cloud 中创建了提醒政策,则此过程会很有帮助。

如需导出提醒政策,请执行以下操作:

  1. 确保 Terraform 已安装在 Cloud Shell 中。

  2. 在 Cloud Shell 中,转到包含 Terraform 配置的目录。

  3. import 代码块添加到 Terraform 配置中的文件。import 代码块具有以下参数:

    • to:您的 Terraform 配置指定的资源地址。此字段的格式为 google_monitoring_alert_policy.RESOURCE_NAME,其中 RESOURCE_NAME 是您选择的值。我们建议选择能够清楚描述提醒政策的资源名称。

    • id:提醒政策的名称。此字段的格式为 project/PROJECT_ID/alertPolicies/ALERT_POLICY_ID

    例如,如果要导出监控 CPU 使用率的提醒政策,请将 RESOURCE_NAME 设置为 cpu_usage_threshold。然后,将 id 设置为提醒政策名称:

    import {
    to = google_monitoring_alert_policy.cpu_usage_threshold
    id = "projects/my-alerting-project/alertPolicies/7160801095019277297"
    }
    
  4. 在 Cloud Shell 中,运行以下命令:

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

    上面的命令会创建一个名为 generated.tf 的文件,该文件可让您先查看提醒政策定义,然后再将其添加到 Terraform 配置。您可以修改定义、将其移至其他文件,或者保持不变。

  5. 在 Cloud Shell 中,输入 terraform apply 以将提醒政策定义导入 Terraform 配置。

如需详细了解如何为不属于 Terraform 配置的资源生成定义,请参阅生成配置

后续步骤