使用 Terraform 管理提醒政策

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

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 配置中的文件。导入块具有以下参数:

    • 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 配置的资源生成定义,请参阅生成配置

后续步骤