Tablestore:Integrate Tablestore by using Terraform

1. Install and configure Terraform

1. Download a software package suitable for your operating system from the official Terraform website.

2. Decompress the package to the /usr/local/bin directory.

   If you decompress the executable file to another directory, you must add the path to global variables.

3. Run the following command to check whether Terraform is installed:

   terraform

   If the following output is returned, Terraform is installed.

   

4. Create a working directory for your Terraform project.

   Important

   You must create a working directory for each Terraform project.

   mkdir terraform-test

5. Go to the working directory named terraform-test.

   cd terraform-test

   Terraform reads all *.tf and *.tfvars files in the directory when Terraform is running. You can write configurations to different files based on your business requirements. The following table describes the common configuration files.

   File	Description
   provider.tf	The provider configuration file.
   terraform.tfvars	The configuration file that contains variables required to configure the provider.
   variable.tf	The configuration file that contains common variables.
   resource.tf	The resource configuration file.
   data.tf	The package configuration file.
   output.tf	The output file.

   1. Create a configuration file name provider.tf for authentication.

      vim provider.tf

      The following sample code provides an example on how to specify the configuration file:

      provider "alicloud" {
        region = "cn-hangzhou"
        access_key = "LTA**********NO2"
        secret_key = "MOk8x0*********************wwff"
      }

      The following table describes the parameters in the configuration file.

      Parameter	Example	Description
      region	cn-hangzhou	The ID of the region. For more information, see Regions.
      access_key	LTA**********NO2	The AccessKey ID and AccessKey secret of your Alibaba Cloud account or RAM user.
      secret_key	MOk8x0*********************wwff

   2. Initialize the terraform-test working directory.

      Important

      After you create a working directory and configuration files for a Terraform project, you must initialize the working directory.

      terraform init

      If the following output is returned, the working directory is loaded.

      

2. Write a template

Create a file named main.tf in the terraform-test working directory and enter the following code.

For more information about the syntax, description, and examples of how to create a Tablestore instance, see alicloud_ots_instance.

variable "name" {
  default = "tf-example"
}

resource "random_integer" "default" {
  min = 10000
  max = 99999
}

resource "alicloud_ots_instance" "default" {
  name        = "${var.name}-${random_integer.default.result}"  #The name of the instance.
  description = var.name  #The description of the instance.
  accessed_by = "Vpc"  #The networks over which you can access the instance.
  tags = {  #The tags of the instance.
    Created = "TF"
    For     = "Building table"
  }
}

3. Run the template

1. Check whether the template syntax is valid.

   terraform validate

   If the following output is returned, the template syntax is valid.

   

2. Create an execution plan and preview the operations that you want to perform.

   terraform plan

   If the following output is returned, the execution plan is created.

   

3. Run the template to apply the execution plan.

   terraform apply

   Enter yes to change resources.

   

   If the following output is returned, the resources are changed.

   

   In the output, id indicates the name of the instance.

4. You can perform the following steps to view the instance that you created:

   1. Log on to the Tablestore console.

   2. In the top navigation bar, select a resource group and a region.

   3. In the instance list of the Overview page, search for the instance name.