Untuk menggunakan Infrastructure Manager (Infra Manager), Anda harus terbiasa dengan Terraform. Untuk mempelajari Terraform lebih lanjut, mulai dengan Apa yang dimaksud dengan Terraform?.
Infra Manager men-deploy resource dan konfigurasi infrastruktur yang ditentukan dalam konfigurasi Terraform. Konfigurasi ini dapat terdiri dari beberapa file dan direktori, tetapi titik masuknya harus berupa modul root Terraform.
Infra Manager menggunakan istilah blueprint untuk merujuk pada konfigurasi Terraform.
Untuk mempelajari lebih lanjut Terraform dengan Google Cloud, lihat Terraform di Google Cloud.
Modul Terraform untuk Google Cloud
Untuk mengetahui serangkaian modul guna menyediakan Google Cloud resource, lihat Blueprint dan modul Terraform untuk Google Cloud.
Anda juga dapat membuat modul Terraform Anda sendiri untuk Google Cloud. Untuk mengetahui detail selengkapnya, lihat Membuat Modul.
Versi Terraform yang didukung
Infra Manager mendukung versi Terraform berikut:
| Versi Terraform | Tanggal tersedia | Tanggal penghentian | Akhir tanggal dukungan | Migrasi otomatis ke versi |
|---|---|---|---|---|
1.2.3 |
21/8/2023 | 8/1/2026 | 8/2/2026 | 1.5.7 |
1.3.10 |
14/3/2024 | Ditentukan Nanti | Ditentukan Nanti | Ditentukan Nanti |
1.4.7 |
14/3/2024 | Ditentukan Nanti | Ditentukan Nanti | Ditentukan Nanti |
1.5.7 |
14/3/2024 | Ditentukan Nanti | Ditentukan Nanti | Ditentukan Nanti |
Anda dapat menggunakan flag --tf-version-constraint untuk menentukan versi
Terraform yang digunakan Infra Manager untuk
membuat deployment.
Sebelum menggunakan Infrastructure Manager untuk men-deploy konfigurasi Terraform, pastikan konfigurasi memiliki batasan berikut:
Jika Anda tidak menentukan versi Terraform, versi terbaru yang didukung akan digunakan secara default.
Saat mengupdate deployment, Anda dapat mengupgrade ke versi Terraform yang lebih baru, tetapi Anda tidak dapat melakukan downgrade ke versi yang didukung sebelumnya. Untuk mengetahui informasi tentang penghentian penggunaan versi Terraform, lihat dokumentasi kebijakan pengelolaan versi Terraform.
Untuk melihat versi Terraform yang digunakan untuk membuat deployment atau revisi tertentu, lihat Melihat detail deployment dan Melihat detail revisi.
Batasan pada konfigurasi Terraform
Untuk menggunakan Infrastructure Manager guna men-deploy konfigurasi Terraform, konfigurasi memiliki batasan berikut:
- Jangan sertakan informasi identitas pribadi atau informasi sensitif dalam nilai konfigurasi Terraform. Untuk mengetahui informasi selengkapnya, lihat Nilai konfigurasi Terraform dan data sensitif.
- Modul root Terraform yang valid harus diberikan. Pembuatan template atau pembuatan Terraform tidak didukung.
- Konfigurasi harus dapat diaktifkan oleh Terraform versi yang didukung.
- Blokir backend tidak boleh ditentukan.
- Sebaiknya jangan gunakan penyedia. Jika memungkinkan, gunakan solusi lain. Untuk mengetahui informasi selengkapnya tentang rekomendasi ini, lihat Penyedia adalah Upaya Terakhir. Jika Anda menggunakan penyedia, perhatikan bahwa lingkungan runtime Infra Manager dapat berubah kapan saja.
Nilai konfigurasi Terraform dan data sensitif
Jangan sertakan informasi identitas pribadi atau sensitif dalam nilai konfigurasi Terraform.
Dokumentasi untuk penyedia Google Cloud menunjukkan nilai konfigurasi yang berpotensi menyertakan informasi sensitif.
Misalnya, resource google_storage_bucket_object memungkinkan
pembuatan objek Cloud Storage menggunakan argumen content. Argumen ini diberi label sensitif di halaman google_storage_bucket_object pada Google Cloud dokumentasi Penyedia.
Anda dapat menggunakan label ini untuk membantu memandu Anda saat membuat konfigurasi Terraform atau saat meninjau konfigurasi Terraform yang ada sebelum digunakan.
Lihat Google Cloud Pemberitahuan Privasi untuk mengetahui informasi tentang cara Google Cloud memproses informasi pribadi yang dikumpulkan atau dihasilkan selama penyediaan dan pengelolaan Layanan Cloud.
Menggunakan penyedia Terraform untuk Google Cloud
Secara opsional, Anda dapat menggunakan gcloud CLI untuk mengonfigurasi deployment dan pratinjau agar menggunakan penyedia Terraform yang dikelola Infra Manager untuk Google Cloud.
Infra Manager mendukung penyedia Terraform untuk Google Cloud:
googlegoogle-beta
Hapus kolom ini untuk menggunakan penyedia Terraform yang dikelola HashiCorp untuk Google Cloud.
Untuk mempelajari cara menentukan penggunaan penyedia Terraform yang dikelola Infra Manager, lihat Men-deploy infrastruktur menggunakan Infrastructure Manager, Memperbarui deployment, atau Melihat pratinjau deployment.
Memeriksa versi penyedia yang didukung
Untuk memeriksa versi penyedia Terraform yang didukung Infra Manager untuk Google Cloud , lihat manifest.json yang dipertahankan Infra Manager di bucket Cloud Storage yang terkait dengan region deployment Anda dalam format:
https://storage.googleapis.com/LOCATION-im-providers/hashicorp/PROVIDER_VERSION/manifest.json
Anda dapat menemukan daftar lengkap versi yang didukung dalam kolom versions di file manifest.json.
Misalnya, jika deployment Anda berada di region africa-south1 dan Anda menggunakan penyedia google-beta, buka https://storage.googleapis.com/africa-south1-im-providers/hashicorp/google-beta/manifest.json untuk melihat region yang tersedia.
Langkah berikutnya
- Pelajari lebih lanjut Infrastructure Manager.
- Buat deployment.
- Memperbarui deployment.
- Melihat status deployment.
- Menghapus deployment.