Managed Service for Prometheus:Use Terraform to manage environment instances

Prerequisites

• Terraform V0.12.28 or later is installed. Run the terraform --version command to check your installed version.

  • Method 1: Use Terraform in Cloud Shell. Cloud Shell comes with Terraform preinstalled and your account already configured. No additional setup is required. For more information, see Use Terraform in Cloud Shell.

  • Method 2: Install Terraform on your local computer. For more information, see Install and configure Terraform in the local PC.

  Note

  While Resource Orchestration Service (ROS) is a native infrastructure-as-code (IaC) service provided by Alibaba Cloud, it also supports the integration of Terraform templates. By using Terraform with ROS, you can define and manage resources in Alibaba Cloud, Amazon Web Services (AWS), or Microsoft Azure, specify resource parameters, and configure dependency relationships for the resources. For more information, see Create a Terraform template and Create a Terraform stack.

• Your Alibaba Cloud account information is configured. Use one of the following methods:

  • Method 1: Set environment variables to store your credentials.

    export ALICLOUD_ACCESS_KEY="************"
    export ALICLOUD_SECRET_KEY="************"
    export ALICLOUD_REGION="cn-beijing"

  • Method 2: Specify your credentials in the provider block of the configuration file.

    provider "alicloud" {
     access_key = "************"
     secret_key = "************"
     region = "cn-beijing"
    }

  Note

  For better flexibility and security, we recommend that you create a Resource Access Management (RAM) user named Terraform, create an AccessKey pair for the RAM user, and then grant the required permissions. For more information, see Create a RAM user and Grant permissions to a RAM user.

• Managed Service for Prometheus is activated.

Create an environment instance

You can create environment instances for three resource types -- ACK clusters, ECS instances, and cloud services -- using the alicloud_arms_environment Terraform resource. Each type uses different parameter values, as summarized in the following table.

# provider, use alicloud
provider "alicloud" {
# access_key = "************"
# secret_key = "************"
# region = "cn-beijing"
}

# Configurations of the ACK environment instance.
resource "alicloud_arms_environment" "my_ack-env1" {
 environment_name = "The name of the environment instance. Example: my_ack-env1."
 environment_type = "CS"
 environment_sub_type = "ACK"
 bind_resource_id = "The ID of the Container Service for Kubernetes (ACK) cluster."
}

#provider, use alicloud
provider "alicloud" {
 #access_key = "************"
 #secret_key = "************"
 #region = "cn-beijing"
}

# Configurations of the ECS environment instance.
resource "alicloud_arms_environment" "my_ecs-env1" {
 environment_name = "The name of the environment instance. Example: my_ecs-env1."
 environment_type = "ECS"
 environment_sub_type = "ECS"
 bind_resource_id = "The ID of the virtual private cloud (VPC). Example: vpc-bp1jxxx."
}

#provider, use alicloud
provider "alicloud" {
 #access_key = "************"
 #secret_key = "************"
 #region = "cn-beijing"
}

# Configurations of the cloud-service environment instance.
resource "alicloud_arms_environment" "my_cloud-env1" {
 environment_name = "The name of the environment instance. Example: my_cloud-env1."
 environment_type = "Cloud"
 environment_sub_type = "Cloud"
 bind_resource_id = "The ID of the region where the cloud service is deployed. Example: cn-hangzhou."
}

Delete an environment instance

To delete an environment instance that was created with Terraform, perform the following steps:

1. Run the following command in the working directory that contains the main.tf file for the environment instance:

   terraform destroy

   When prompted with Enter a value, type yes and press Enter to confirm.

   Expected output:

   ...
   Do you really want to destroy all resources?
    Terraform will destroy all your managed infrastructure, as shown above.
    There is no undo. Only 'yes' will be accepted to confirm.
   
    Enter a value: yes
   ...
   Destroy complete! Resources: 1 destroyed.

2. Log on to the ARMS console. On the Integration Management page, verify that the environment instance has been deleted.