Terraform:Output

Pada topik sebelumnya, kami memperkenalkan sumber daya, dependensi, dan variabel. Dalam topik ini, kita akan menjelajahi keluaran Terraform.

Apa itu keluaran

Keluaran mirip dengan nilai kembali dalam bahasa pemrograman umum. Anda dapat menggunakan keluaran untuk menampilkan informasi tentang sumber daya infrastruktur yang dibuat melalui output baris perintah.

Keluaran memiliki beberapa tujuan. Skenario yang paling umum adalah mencetak properti sumber daya modul utama di log setelah menjalankan perintah apply. Sebagai contoh, sebagian besar detail Instance ECS dihitung saat menjalankan perintah apply dan hanya tersedia setelah instance dibuat.

Selain itu, keluaran digunakan untuk mengirimkan informasi dari satu sumber daya ke sumber daya lain. Misalnya, Anda dapat mengekstrak nilai properti tertentu dari Instance ECS, seperti alamat IP-nya, untuk sumber daya lain yang memerlukan informasi ini, seperti aturan grup keamanan.

Sintaks untuk keluaran

Keluaran dideklarasikan dalam blok keluaran. Anda dapat mendeklarasikan keluaran di mana saja dalam file konfigurasi Terraform. Namun, praktik terbaik adalah mendeklarasikannya dalam file terpisah bernama outputs.tf.

Label setelah kata kunci output adalah nama keluaran. Mirip dengan nama variabel, nama keluaran harus unik dalam modul saat ini. Blok keluaran dapat berisi parameter berikut:

1. value

   Parameter wajib ini menentukan nilai yang akan dikembalikan kepada pengguna modul.

2. description

   Parameter opsional ini memberikan deskripsi tentang tujuan dan nilai yang diharapkan dari keluaran. Parameter ini sering digunakan untuk dokumentasi.

3. sensitive

   Parameter opsional ini digunakan untuk menyamarkan keluaran. Parameter ini berguna ketika Anda perlu menyembunyikan informasi rahasia, seperti kata sandi atau Rahasia AccessKey.

Dalam contoh berikut, kami mendeklarasikan keluaran bernama vpc_id untuk sumber daya bernama my-vpc:

# Buat VPC
resource "alicloud_vpc" "my-vpc" {
  vpc_name   = "tf-vpc"
  cidr_block = "10.0.0.0/16"
}

output "vpc_id" {
  value = alicloud_vpc.my-vpc.id
}

Setelah menjalankan perintah terraform apply, ID my-vpc ditampilkan di keluaran:

Selain itu, untuk sumber daya yang telah dibuat, Anda dapat menjalankan perintah terraform output kapan saja untuk menanyakan semua keluaran dalam Proyek.

Praktik terbaik untuk keluaran

Kami merekomendasikan praktik terbaik berikut untuk mendeklarasikan keluaran:

1. Tampilkan hanya informasi yang relevan

   Keluarkan hanya informasi yang berguna, seperti informasi yang dihitung. Hindari mengeluarkan nilai yang merupakan pengulangan nilai variabel atau informasi lain yang sudah diketahui. Sebagai contoh, untuk sumber daya jaringan, properti yang dihitung berikut ini berguna:

   1. id, yang merupakan pengenal sumber daya

   2. router_id, yang merupakan pengenal router yang secara otomatis dibuat setelah VPC dibuat

   3. route_table_id, yang merupakan pengenal tabel rute yang secara otomatis dibuat setelah VPC dibuat

2. Berikan Nama dan Deskripsi yang Bermakna, Mirip dengan Variabel

3. Organisasikan Kode Anda dengan Menempatkan Semua Nilai Keluaran dalam File Bernama outputs.tf

4. Tandai Keluaran Sensitif

   Jangan mencoba untuk secara manual mengenkripsi nilai sensitif. Sebaliknya, andalkan fitur manajemen status sensitif bawaan untuk dukungan. Saat mendeklarasikan keluaran untuk nilai sensitif, pastikan bahwa keluaran tersebut ditandai sebagai sensitif. Ketika sebuah keluaran ditandai sebagai sensitif, nilainya disamarkan dalam keluaran perintah terraform plan atau terraform apply.