Terraform:Mengelola Sumber Daya yang Ada

Prasyarat

1. Unduh dan instal Terraformer

   Paket penerapan Terraformer open-source tersedia sebagai paket komprehensif untuk semua penyedia atau sebagai paket individu untuk setiap penyedia. Unduh paket yang Anda butuhkan. Contoh berikut menunjukkan cara mengunduh paket di Linux dan macOS. Untuk informasi lebih lanjut, lihat Instalasi.

   • Pengguna Linux

   export PROVIDER=all
   curl -LO "https://github.com/GoogleCloudPlatform/terraformer/releases/download/$(curl -s https://api.github.com/repos/GoogleCloudPlatform/terraformer/releases/latest | grep tag_name | cut -d '"' -f 4)/terraformer-${PROVIDER}-linux-amd64"
   chmod +x terraformer-${PROVIDER}-linux-amd64
   sudo mv terraformer-${PROVIDER}-linux-amd64 /usr/local/bin/terraformer

   • Pengguna macOS

   export PROVIDER=all
   curl -LO "https://github.com/GoogleCloudPlatform/terraformer/releases/download/$(curl -s https://api.github.com/repos/GoogleCloudPlatform/terraformer/releases/latest | grep tag_name | cut -d '"' -f 4)/terraformer-${PROVIDER}-darwin-amd64"
   chmod +x terraformer-${PROVIDER}-darwin-amd64
   sudo mv terraformer-${PROVIDER}-darwin-amd64 /usr/local/bin/terraformer

2. Dependensi

   1. Berikan izin read-only untuk sumber daya terkait ke akun saat ini.

   2. Instal Terraform

      Catatan

      Anda dapat melewati langkah ini jika menjalankan perintah di Cloud Shell.

      Untuk informasi lebih lanjut, lihat Instal dan Konfigurasikan Terraform Secara Lokal.

   3. Unduh penyedia terkait. Anda dapat mengonfigurasi penyedia dengan salah satu dari dua cara berikut:

      • Inisialisasi penyedia di direktori tempat Anda menjalankan perintah Terraformer.

      • Unduh penyedia ke jalur ~/.terraform.d/plugins/.

   4. Konfigurasikan kredensial akses. Terraformer saat ini hanya mendukung autentikasi dengan membaca profil lokal. Secara default, kredensial pertama dalam profil digunakan untuk impor. Untuk informasi lebih lanjut tentang cara mengonfigurasi kredensial akses Alibaba Cloud, lihat Konfigurasikan Kredensial.

Penggunaan

Contoh berikut menggunakan terraformer-all-darwin-amd64 v0.8.24.

Terraformer mendukung empat perintah: help, import, plan, and version.

1. help: Menampilkan detail tentang perintah.

   

2. version: Menampilkan nomor versi saat ini.

   

3. import: Mengimpor sumber daya untuk penyedia tertentu.

   

4. plan: Melihat pratinjau sumber daya yang akan diimpor untuk penyedia tertentu.

Contoh

Contoh berikut menunjukkan cara mengimpor semua VPC Alibaba Cloud di wilayah China (Hangzhou).

1. Buat direktori untuk menyimpan template dan file status yang diimpor.

   mkdir example && cd example

2. Jalankan perintah berikut:

   terraformer-all-darwin-arm64 import alicloud --resources=vpc --regions=cn-hangzhou --path-pattern={output} --path-output=./     

   • --resources: Menentukan koleksi sumber daya yang akan diimpor.

   • --regions: Menentukan wilayah tempat sumber daya berada.

   • --path-pattern: Menentukan pola untuk struktur direktori yang dihasilkan.

   • --path-output: Menentukan jalur keluaran untuk file yang dihasilkan.

3. File template yang dihasilkan adalah sebagai berikut. Secara default, informasi wilayah ditambahkan ke jalur direktori. Untuk menekan semua template sumber daya menjadi satu file, tentukan parameter --compact. Parameter ini mengeluarkan semua sumber daya ke file resources.tf.

   └── cn-hangzhou
       ├── outputs.tf
       ├── provider.tf
       ├── terraform.tfstate
       ├── variables.tf
       ├── vpc.tf
       └── vswitch.tf
   
   2 directories, 6 files

4. Jika versi Terraform lokal Anda adalah >=0.13.0, Anda harus menjalankan perintah berikut untuk memodifikasi file status agar kompatibel dengan versi Terraform baru.

   terraform state replace-provider -auto-approve "registry.terraform.io/-/alicloud" "aliyun/alicloud"

Prasyarat

1. Unduh dan instal

   aliterraformer disimpan di Alibaba Cloud Object Storage Service (OSS). Anda dapat mengunduhnya dari lokasi berikut:

   macOS

   # amd64
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_darwin_amd64.zip
   
   # arm64
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_darwin_arm64.zip

   Linux

   # amd64
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_linux_amd64.zip
   
   # arm
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_linux_arm.zip
   
   # arm64
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_linux_arm64.zip

   Windows

   # amd64
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_windows_amd64.zip
   
   # 386
   wget https://terraform-share.oss-cn-hangzhou.aliyuncs.com/aliterraformer/aliterraformer_windows_386.zip

   Sebagai contoh, di macOS, ekstrak file setelah mengunduh:

   unzip aliterraformer_darwin_amd64.zip
   chmod +x aliterraformer
   sudo mv aliterraformer /usr/local/bin/aliterraformer

2. Dependensi

   Sama seperti Terraformer open-source, Anda harus menyiapkan file terraform dan terraform-provider-alicloud serta mengonfigurasi kontrol akses.

   1. Berikan izin read-only untuk sumber daya terkait ke akun Resource Access Management (RAM).

   2. Instal Terraform

      Untuk informasi lebih lanjut, lihat Instal dan Konfigurasikan Terraform Secara Lokal. Anda dapat melewati langkah ini jika menjalankan perintah di Cloud Shell.

   3. Unduh terraform-provider-alicloud

      Anda dapat menyetel versi penyedia untuk impor. Struktur direktori cache yang dibuat oleh perintah init berbeda untuk versi sebelum v0.13.0 dibandingkan dengan versi v0.13.0 dan lebih baru. Contoh berikut menunjukkan cara membaca direktori untuk versi v0.13.0 dan lebih baru:

      # 1. Set menggunakan variabel lingkungan TF_DATA_TFER_DIR
      <$TF_DATA_TFER_DIR>/providers/registry.terraform.io/aliyun/alicloud/1.239.0/darwin_arm64/terraform-provider-alicloud_v1.239.0
      
      # 2. Set di direktori tersembunyi direktori kerja saat ini
      .terraform/providers/registry.terraform.io/aliyun/alicloud/1.239.0/darwin_arm64/terraform-provider-alicloud_v1.239.0
      
      # 3. Set di direktori tersembunyi direktori root pengguna
      <HOME>/.terraform.d/plugins/registry.terraform.io/aliyun/alicloud/1.239.0/darwin_arm64/terraform-provider-alicloud_v1.239.0

   4. Konfigurasikan kredensial akses

      Selain menggunakan profil, Anda dapat menyetel kredensial akses di aliterraformer menggunakan variabel lingkungan dan parameter perintah:

      # 1. Menggunakan variabel lingkungan ALICLOUD_ACCESS_KEY dan ALICLOUD_SECRET_KEY
      $ export ALICLOUD_ACCESS_KEY=xxxx
      $ export ALICLOUD_SECRET_KEY=xxxxx
      
      # 2. Dengan meneruskan parameter perintah --access-key dan --secret-key
      $ aliterraformer import alicloud --access-key=xxxx --secret-key=xxx ...
      
      # 3. Dengan menyetel dan meneruskan AK melalui mekanisme profil
      $ aliterraformer import alicloud --profile=default ...

Penggunaan

aliterraformer mendukung lima perintah: help, version, products, resources, import. Ini menambahkan perintah products, resources ke Terraformer open-source asli.

1. help: Lihat detail tentang perintah yang didukung.

   aliterraformer help

   

2. version: Lihat versi Terraformer saat ini.

   aliterraformer version

3. products: Lihat daftar produk yang didukung versi saat ini untuk impor.

   aliterraformer products

   

4. resources: Lihat daftar sumber daya untuk produk yang didukung versi saat ini untuk impor. Gunakan -p untuk menentukan produk.

   aliterraformer resources -p <productName>

   

   

5. import: Melakukan operasi impor. Saat Anda mengimpor sumber daya Alibaba Cloud, Anda harus menentukan alicloud. Jalankan perintah berikut untuk melihat parameter yang didukung untuk mengimpor sumber daya Alibaba Cloud:

   aliterraformer import alicloud -h

   

   Saat melakukan impor, Anda harus terlebih dahulu mendefinisikan koleksi sumber daya yang akan diimpor. Anda kemudian dapat menyaring sumber daya ini dan mengekstrak properti tertentu sebagai parameter.

   • Buat koleksi sumber daya:

     Perintah impor menyediakan empat bendera untuk mendefinisikan ruang lingkup sumber daya yang akan diimpor: <--products>, <--resources>, <--excludes-products>, dan <--excludes>. Anda dapat menggabungkan bendera ini untuk membangun koleksi sumber daya. Contoh berikut menunjukkan cara menggunakan bendera ini:

     • Impor sumber daya tertentu

       # Impor VPC, vSwitch, dan instance ECS
       aliterraformer import alicloud -r=vpc,vswitch,instance

     • Impor produk tertentu

       # Impor semua sumber daya di bawah produk ACK dan ALB
       aliterraformer import alicloud --products=ACK,ALB

     • Impor produk dan sumber daya tertentu

       # Impor semua sumber daya di bawah produk ACK dan ECS, serta semua VPC dan vSwitch
       aliterraformer import alicloud --products=ACK,ECS -r=vpc,vswitch

     • Impor produk tertentu, tetapi kecualikan beberapa sumber daya dalam produk tersebut

       # Impor semua sumber daya di bawah ACK kecuali alicloud_cs_kubernetes
       aliterraformer import alicloud --products=ACK --excludes=cs_kubernetes

     • Impor semua sumber daya dari semua produk

       # Memasukkan ALL untuk produk berarti semua produk
       aliterraformer import alicloud --products=ALL

     • Impor semua sumber daya dari semua produk, tetapi kecualikan produk tertentu

       # Impor semua produk kecuali VPNGateway dan WAF
       aliterraformer import alicloud --products=ALL --excludes-products=VPNGateway,WAF

     • Impor semua sumber daya dari semua produk, tetapi kecualikan produk dan sumber daya tertentu

       # Impor semua produk kecuali VPNGateway dan WAF, dan kecualikan sumber daya alicloud_cs_kubernetes
       aliterraformer import alicloud --products=ALL --excludes-products=VPNGateway,WAF --excludes=cs_kubernetes

   • Menyaring sumber daya

     Format untuk parameter ini adalah --filter=Type1.AttrKey=AttrValue1;AttrValue2,Type2.AttrKey=AttrValue1;AttrValue2. Jika Anda menghilangkan Type, kondisi filter berlaku untuk semua sumber daya.

     • Impor VPC dengan ID vpc-123

       # Untuk menentukan beberapa nilai, pisahkan dengan titik koma: --filter="vpc.id=vpc-123;vpc-456"
       aliterraformer import alicloud -r=vpc --filter="vpc.id=vpc-123"

     • Impor VPC dan vSwitch yang keduanya bernama tf-example

       aliterraformer import alicloud -r=vpc,vswitch --filter="vpc.vpc_name=tf-example,vswitch.vswitch_name=tf-example"

     • Impor VPC dan instance ECS yang keduanya termasuk dalam kelompok sumber daya rg-12345

       aliterraformer import alicloud -r=vpc,instance --filter="resource_group_id=rg-12345"

   • Ekstrak properti sebagai variabel menggunakan output-variables

     Format untuk parameter ini adalah r1:attr1,attr2;r2:attr1,attr2,attr3.

     • Ekstrak vpc_id dan vswitch_id dari instance ECS sebagai variabel

       aliterraformer import alicloud -r=instance --output-variables="instance:vpc_id,vswitch_id"

Contoh

Contoh berikut menunjukkan cara mengimpor VPC, vSwitch, dan instance ECS dengan ID VPC vpc-12345 di wilayah China (Hangzhou), dan mengekstrak zone_id dari vSwitch sebagai variabel:

1. Buat direktori untuk menyimpan template dan file status yang diimpor.

   mkdir example && cd example

2. Buat perintah impor.

   aliterraformer import alicloud \
       --regions=cn-hangzhou \
       -r=vpc,vswitch,instance \
       --filter="vpc.id=vpc-12345,vswitch.vpc_id=vpc-12345,instance.vpc_id=vpc-12345" \
       --output-variables="vswitch:zone_id" \
       --path-output=example               \
       --path-pattern={output}            \
       --compact

   • --path-output: Menentukan folder impor.

   • --path-pattern: Menentukan format struktur direktori untuk template sumber daya yang diimpor. Format default adalah {output}/{provider}/{service}/. Format lain yang tersedia termasuk {output}/{provider}/ dan {output}/. Sebagai contoh, jika Anda menentukan --path-pattern={output}, semua template ditempatkan dalam satu folder.

   • --compact: Jika parameter ini tidak ditentukan, sumber daya disimpan dalam file {service}.tf terpisah. Jika parameter ini ditentukan, semua sumber daya disimpan dalam file resources.tf.

3. Setelah impor, file berikut dihasilkan di direktori example:

   .
   ├── outputs.tf
   ├── provider.tf
   ├── resources.tf
   ├── terraform.tfstate
   └── variables.tf

   Jika Anda tidak menentukan --path-pattern={output}, struktur direktori adalah sebagai berikut:

   .
   └── alicloud
       ├── instance
       │   ├── provider.tf
       │   ├── terraform.tfstate
       │   └── variables.tf
       ├── vpc
       │   ├── outputs.tf
       │   ├── provider.tf
       │   ├── terraform.tfstate
       │   ├── variables.tf
       │   └── vpc.tf
       └── vswitch
           ├── outputs.tf
           ├── provider.tf
           ├── terraform.tfstate
           ├── variables.tf
           └── vswitch.tf

4. Jika versi Terraform lokal Anda adalah >=0.13.0, Anda harus menjalankan perintah berikut untuk memodifikasi file status agar kompatibel dengan versi Terraform baru.

   terraform state replace-provider -auto-approve "registry.terraform.io/-/alicloud" "aliyun/alicloud"