ENS:Contoh integrasi Terraform

Kode contoh ini mendukung penerapan satu klik. Run in Terraform Explorer untuk menerapkan kode contoh secara online tanpa perlu menginstal Terraform.

Prasyarat

Persiapkan hal-hal berikut sebelum menjalankan kode contoh. Lingkungan runtime yang Anda pilih menentukan apakah Anda perlu mengonfigurasi kredensial sendiri:

• RAM user dan Pasangan Kunci Akses — Akun Alibaba Cloud memiliki izin atas semua sumber daya, dan kebocoran kredensialnya menimbulkan risiko signifikan. (Disarankan) Gunakan Resource Access Management (RAM) user dan buat Pasangan Kunci Akses untuk RAM user tersebut. Untuk informasi selengkapnya, lihat Create a RAM user dan Create an AccessKey.

• Izin ENS — Berikan izin AliyunENSFullAccess kepada RAM user agar dapat mengelola resource ENS. Untuk informasi selengkapnya, lihat Manage RAM user permissions. Isi kebijakan berikut menjelaskan izin yang dibutuhkan oleh kode contoh ini:

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": "ens:*",
        "Resource": "*"
      }
    ]
  }

• Lingkungan runtime Terraform — Siapkan lingkungan runtime Terraform dengan salah satu cara berikut:

  • (Disarankan) Gunakan Terraform di Terraform Explorer: Alibaba Cloud menyediakan lingkungan runtime Terraform online. Anda tidak perlu menginstal Terraform. Login dan gunakan Terraform secara online. Opsi ini cocok untuk skenario di mana Anda ingin mencoba dan men-debug Terraform dengan cepat tanpa biaya. Tautan penerapan satu klik dalam topik ini akan membuka kode contoh di lingkungan ini.

  • Create resources with Terraform: Alibaba Cloud Cloud Shell telah dilengkapi komponen Terraform yang telah diinstal sebelumnya dan kredensial yang telah dikonfigurasi, sehingga Anda dapat langsung menjalankan perintah Terraform di Cloud Shell. Opsi ini cocok untuk skenario di mana Anda membutuhkan akses cepat dan hemat biaya ke Terraform.

  • Install and configure Terraform: Opsi ini cocok untuk skenario di mana konektivitas jaringan buruk atau Anda memerlukan lingkungan pengembangan yang disesuaikan.

    Terlepas dari opsi yang Anda pilih, pastikan versi Terraform adalah v0.12.28 atau lebih baru. Untuk memeriksa versi yang terinstal, jalankan perintah terraform --version.

Resource yang digunakan

alicloud_ens_eip: membuat resource EIP ENS.

Integrasikan resource dengan menggunakan Terraform

Pada bagian ini, Anda mendefinisikan resource EIP ENS dalam file konfigurasi Terraform, lalu menerapkan konfigurasinya.

1. Buat direktori kerja, lalu buat file konfigurasi bernama main.tf di dalamnya. File main.tf merupakan file utama Terraform yang mendefinisikan resource yang akan diterapkan.

   variable "name" {
     default = "terraform-example"
   }
   # Create an ENS EIP resource.
   resource "alicloud_ens_eip" "default" {
     # (Optional) The description of the EIP.
     description   = "EipDescription_autotest"
     # (Optional, computed) The peak bandwidth of the EIP. Default value: 5. Valid values: 5 to 10000.
     bandwidth     = "5"
     # (Optional, forces new resource) The Internet service provider.
     isp           = "cmcc"
     # (Required, forces new resource) The billing method of the EIP. Valid value: PayAsYouGo (pay-as-you-go).
     payment_type  = "PayAsYouGo"
     # (Required, forces new resource) The ID of the ENS edge zone.
     ens_region_id = "cn-chenzhou-telecom_unicom_cmcc"
     # (Optional) The name of the EIP.
     eip_name      = var.name
     # (Required, forces new resource) Valid value: 95BandwidthByMonth.
     internet_charge_type = "95BandwidthByMonth"
   }

2. Jalankan perintah berikut untuk menginisialisasi lingkungan runtime Terraform:

   terraform init

   Initializing the backend...
   
   Initializing provider plugins...
   - Reusing previous version of hashicorp/alicloud from the dependency lock file
   - Using previously-installed hashicorp/alicloud v1.231.0
   
   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 membuat rencana eksekusi dan melihat pratinjau perubahan:

   terraform plan

4. Jalankan perintah berikut untuk membuat resource EIP ENS:

   terraform apply

   Masukkan yes dan tekan tombol Enter. Tunggu hingga perintah selesai. Output berikut menunjukkan bahwa resource EIP ENS telah berhasil dibuat.

   

Verifikasi hasil

Konfirmasi keberadaan resource EIP ENS dengan salah satu cara berikut.

terraform show

Clean up resources

Jika Anda tidak lagi memerlukan resource yang telah dibuat atau dikelola menggunakan Terraform, jalankan perintah berikut untuk melepaskannya:

terraform destroy

Untuk informasi selengkapnya tentang terraform destroy, lihat Common commands.

Contoh lengkap

Konfigurasi berikut merupakan kode contoh lengkap untuk membuat resource EIP ENS. Run in Terraform Explorer untuk menerapkannya tanpa perlu menyiapkan lingkungan runtime lokal.

variable "name" {
  default = "terraform-example"
}
# Create an ENS EIP resource.
resource "alicloud_ens_eip" "default" {
  # (Optional) The description of the EIP.
  description   = "EipDescription_autotest"
  # (Optional, computed) The peak bandwidth of the EIP. Default value: 5. Valid values: 5 to 10000.
  bandwidth     = "5"
  # (Optional, forces new resource) The Internet service provider.
  isp           = "cmcc"
  # (Required, forces new resource) The billing method of the EIP. Valid value: PayAsYouGo (pay-as-you-go).
  payment_type  = "PayAsYouGo"
  # (Required, forces new resource) The ID of the ENS edge zone.
  ens_region_id = "cn-chenzhou-telecom_unicom_cmcc"
  # (Optional) The name of the EIP.
  eip_name      = var.name
  # (Required, forces new resource) Valid value: 95BandwidthByMonth.
  internet_charge_type = "95BandwidthByMonth"
}