Tablestore:Gunakan Terraform untuk membuat instans Tablestore

Prasyarat

• Untuk meminimalkan risiko keamanan, gunakan pengguna RAM dengan izin minimum yang diperlukan untuk menyelesaikan tutorial ini. Untuk informasi selengkapnya, lihat Buat pengguna RAM dan Berikan izin kepada pengguna RAM. Kebijakan berikut memberikan izin minimum yang diperlukan untuk tutorial ini:

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "ots:GetInstance",
          "ots:BindInstance2Vpc",
          "ots:ListVpcInfoByInstance",
          "ots:UnbindInstance2Vpc",
          "ots:DeleteInstance",
          "ots:InsertInstance",
          "ots:UpdateInstance",
          "ots:ListInstance"
        ],
        "Resource": "*"
      }
    ]
  }

• Siapkan lingkungan runtime Terraform. Anda dapat menggunakan salah satu metode berikut:

  • Explorer: Alibaba Cloud menyediakan lingkungan runtime online untuk Terraform. Anda dapat masuk untuk menggunakan dan bereksperimen dengan Terraform tanpa perlu menginstalnya. Ini merupakan cara cepat, praktis, dan gratis untuk mencoba serta melakukan debug Terraform.

  • Gunakan Terraform untuk membuat resource secara cepat: Terraform telah diinstal sebelumnya di Cloud Shell dan kredensial identitas telah dikonfigurasi sebelumnya. Anda dapat langsung menjalankan perintah Terraform di Cloud Shell. Metode ini memberikan akses cepat, praktis, dan berbiaya rendah ke Terraform.

  • Instal dan konfigurasi Terraform: Metode ini cocok untuk skenario dengan koneksi jaringan yang buruk atau ketika diperlukan lingkungan pengembangan kustom.

Resource yang digunakan

• alicloud_ots_instance: sebuah instans Tablestore.

Buat instans Tablestore

1. Buat direktori kerja, buat file konfigurasi bernama main.tf di direktori tersebut, lalu salin kode berikut ke dalam main.tf.

   variable "name" {
     default = "tf-example"
   }
   
   variable "region" {
     default = "cn-hangzhou"
   }
   
   provider "alicloud" {
     region = var.region
   }
   
   resource "random_integer" "default" {
     min = 10000
     max = 99999
   }
   
   # Instans Tablestore
   resource "alicloud_ots_instance" "default" {
     name        = "${var.name}-${random_integer.default.result}"  # Nama instans
     description = var.name  # Deskripsi instans
     accessed_by = "Vpc"  # Jenis jaringan untuk akses instans
     tags = {  # Tag instans
       Created = "TF"
       For     = "Building table"
     }
   }

2. Jalankan perintah berikut untuk menginisialisasi lingkungan runtime Terraform.

   terraform init

   Output berikut menunjukkan bahwa Terraform berhasil diinisialisasi.

   Terraform has been successfully initialized!
   
   You may now begin working with Terraform. Try running "terraform plan" to see
   any changes that are required for your infrastructure. All Terraform commands
   should now work.
   
   If you ever set or change modules or backend configuration for Terraform,
   rerun this command to reinitialize your working directory. If you forget, other
   commands will detect it and remind you to do so if necessary.

3. Jalankan perintah berikut untuk menerapkan konfigurasi.

   terraform apply

   Saat diminta, ketik yes dan tekan Enter. Tunggu hingga perintah selesai. Output berikut menunjukkan bahwa resource berhasil diterapkan.

   You can apply this plan to save these new output values to the Terraform state, without changing any real infrastructure.
   
   Do you want to perform these actions?
     Terraform will perform the actions described above.
     Only 'yes' will be accepted to approve.
   
     Enter a value: yes
   
   
   Apply complete! Resources: 2 added, 0 changed, 0 destroyed.

4. Verifikasi hasilnya.

   Terraform show

   Jalankan perintah berikut di direktori kerja Anda untuk melihat detail resource yang dibuat oleh Terraform:

   terraform show

   

   Konsol Tablestore

   Masuk ke Konsol Tablestore. Di halaman All Instances, temukan dan lihat instans yang telah Anda buat.

   

Lepaskan sumber daya

Jika Anda tidak lagi memerlukan resource yang dibuat atau dikelola oleh Terraform, jalankan perintah berikut. Untuk informasi selengkapnya tentang perintah terraform destroy, lihat Perintah umum.

terraform destroy

Selama eksekusi, Terraform akan menampilkan pratinjau resource yang akan dihapus. Untuk mengonfirmasi penghapusan, ketik yes saat prompt muncul dan tekan Enter. Tunggu hingga perintah selesai. Output berikut menunjukkan bahwa resource berhasil dihapus.

Plan: 0 to add, 0 to change, 2 to destroy.

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: 2 destroyed.

Contoh lengkap

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

variable "region" {
  default = "cn-hangzhou"
}

provider "alicloud" {
  region = var.region
}

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

# Instans Tablestore
resource "alicloud_ots_instance" "default" {
  name        = "${var.name}-${random_integer.default.result}"  # Nama instans
  description = var.name  # Deskripsi instans
  accessed_by = "Vpc"  # Jenis jaringan untuk akses instans
  tags = {  # Tag instans
    Created = "TF"
    For     = "Building table"
  }
}

Untuk contoh yang lebih lengkap, kunjungi folder layanan cloud yang sesuai di More Complete Examples.

FAQ

1. Bagaimana cara meningkatkan efisiensi pembuatan dan penghapusan instans Tablestore saat menyediakan beberapa layanan cloud dengan Terraform?

• Use case: Alur kerja berhasil membuat instans Tablestore, tetapi gagal membuat resource berikutnya. Pengguna melakukan rollback alur kerja, yang mencoba menghapus instans yang telah dibuat, lalu bersiap menjalankan ulang alur kerja tersebut. Namun, penghapusan instans Tablestore memerlukan waktu, dan nama instans harus unik dalam satu Wilayah. Oleh karena itu, pengguna tidak dapat menjalankan ulang alur kerja untuk membuat instans dengan nama yang sama hingga instans asli dihapus.

• Solusi: Tambahkan akhiran bilangan acak atau ID auto-increment pada nama instans Tablestore untuk memastikan nama unik pada setiap eksekusi alur kerja. Dengan demikian, jika alur kerja gagal dan perlu di-rollback lalu dijalankan ulang, Anda dapat segera menjalankan ulang alur kerja tanpa menunggu instans sebelumnya dihapus.