Work with backends
/ 100
Lab ini dikembangkan dengan partner kami, Hashicorp. Jika Anda memilih untuk menerima info terbaru terkait produk, pengumuman, dan penawaran di Profil Akun Anda, informasi pribadi Anda mungkin akan dibagikan kepada Hashicorp, yang merupakan sponsor dari lab ini.
Terraform harus menyimpan status infrastruktur terkelola dan konfigurasi Anda. Status ini digunakan oleh Terraform untuk memetakan resource dunia nyata ke konfigurasi Anda, melacak metadata, dan meningkatkan performa untuk infrastruktur besar.
Status ini disimpan secara default dalam file lokal bernama terraform.tfstate, tapi juga dapat disimpan secara jarak jauh, yang berfungsi lebih baik dalam lingkungan tim.
Terraform menggunakan status lokal ini untuk membuat rencana dan melakukan perubahan pada infrastruktur Anda. Sebelum operasi apa pun, Terraform melakukan refresh untuk memperbarui status dengan infrastruktur sungguhan.
Tujuan utama status Terraform adalah menyimpan binding di antara objek dalam sistem jarak jauh dan instance resource yang dideklarasikan dalam konfigurasi Anda. Saat membuat objek jarak jauh sebagai respons terhadap perubahan konfigurasi, Terraform akan mencatat identitas objek jarak jauh tersebut untuk diperiksa terhadap instance resource tertentu, lalu memperbarui atau menghapus objek tersebut sebagai respons terhadap perubahan konfigurasi di masa mendatang.
Di lab ini, Anda akan mempelajari cara melakukan tugas berikut:
Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.
Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.
Untuk menyelesaikan lab ini, Anda memerlukan:
Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran. Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:
Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).
Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.
Tips: Atur tab di jendela terpisah secara berdampingan.
Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.
Anda juga dapat menemukan Username di panel Lab Details.
Klik Next.
Salin Password di bawah dan tempel ke dialog Welcome.
Anda juga dapat menemukan Password di panel Lab Details.
Klik Next.
Klik halaman berikutnya:
Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.
Cloud Shell adalah mesin virtual yang dilengkapi dengan berbagai alat pengembangan. Mesin virtual ini menawarkan direktori beranda persisten berkapasitas 5 GB dan berjalan di Google Cloud. Cloud Shell menyediakan akses command-line untuk resource Google Cloud Anda.
Klik Activate Cloud Shell 
Klik jendela berikut:
Setelah terhubung, Anda sudah diautentikasi, dan project ditetapkan ke Project_ID,
gcloud adalah alat command line untuk Google Cloud. Alat ini sudah terinstal di Cloud Shell dan mendukung pelengkapan command line.
Output:
Output:
gcloud yang lengkap di Google Cloud, baca panduan ringkasan gcloud CLI.
Status adalah persyaratan yang diperlukan oleh Terraform untuk dapat berfungsi. Orang-orang terkadang bertanya apakah Terraform dapat bekerja tanpa status atau tidak menggunakan status dan hanya memeriksa resource cloud di setiap operasi. Dalam skenario di mana Terraform mungkin dapat bekerja tanpa status, hal itu akan memerlukan pemindahan kompleksitas dalam jumlah yang sangat besar dari satu tempat (status) ke tempat lain (konsep pengganti). Bagian ini menjelaskan alasan status Terraform diperlukan.
Terraform memerlukan semacam database untuk memetakan konfigurasi Terraform ke dunia nyata. Jika konfigurasi Anda berisi resource resource "google_compute_instance" "foo", Terraform menggunakan peta ini untuk mengetahui bahwa instance i-abcd1234 diwakili oleh resource tersebut.
Terraform memperkirakan bahwa setiap objek jarak jauh terikat pada hanya satu instance resource, yang biasanya terjamin karena Terraform bertanggung jawab untuk membuat objek dan mencatat identitasnya dalam status. Jika Anda mengimpor objek yang dibuat di luar Terraform, Anda harus memastikan bahwa setiap objek yang berbeda diimpor ke hanya satu instance resource.
Jika satu objek jarak jauh terikat pada dua instance resource atau lebih, Terraform mungkin akan melakukan tindakan yang tidak terduga terhadap objek tersebut karena pemetaan dari konfigurasi ke status objek jarak jauh telah menjadi ambigu.
Selain melacak pemetaan antara resource dan objek jarak jauh, Terraform juga harus melacak metadata seperti dependensi resource.
Terraform biasanya menggunakan konfigurasi untuk menentukan urutan dependensi. Akan tetapi, saat Anda menghapus resource dari konfigurasi Terraform, Terraform harus mengetahui cara menghapus resource tersebut. Terraform dapat melihat bahwa sudah ada pemetaan untuk resource yang tidak berada dalam file konfigurasi Anda dan membuat rencana untuk menghancurkannya. Akan tetapi, karena tidak ada lagi resource, urutan tidak dapat ditentukan dari konfigurasi itu sendiri.
Untuk memastikan operasi yang tepat, Terraform menyimpan salinan dari serangkaian dependensi terbaru dalam status. Terraform tetap dapat menentukan urutan yang benar untuk penghancuran dari status saat Anda menghapus satu atau beberapa item dari konfigurasi.
Ini dapat dihindari jika Terraform mengetahui urutan yang diperlukan di antara jenis-jenis resource. Misalnya, Terraform dapat mengetahui bahwa server harus dihapus sebelum subnet yang menaunginya. Akan tetapi, kompleksitas untuk pendekatan ini dapat dengan cepat menjadi tidak dapat dikelola; selain memahami semantik urutan setiap resource untuk setiap cloud, Terraform juga harus memahami urutan di berbagai penyedia.
Terraform juga menyimpan metadata lain untuk alasan yang serupa, seperti pointer ke konfigurasi penyedia yang paling terakhir digunakan dengan resource dalam situasi di mana terdapat beberapa penyedia dengan alias.
Selain pemetaan dasar, Terraform menyimpan cache nilai atribut untuk semua resource dalam status. Ini adalah fitur opsional status Terraform dan hanya digunakan sebagai peningkatan performa.
Saat menjalankan terraform plan, Terraform harus mengetahui status resource saat ini untuk menentukan secara efektif perubahan yang dibutuhkan untuk mencapai konfigurasi yang Anda inginkan.
Untuk infrastruktur kecil, Terraform dapat mengkueri penyedia Anda dan menyinkronkan atribut terbaru dari semua resource Anda. Ini adalah perilaku default Terraform: untuk setiap plan dan apply, Terraform akan menyinkronkan semua resource dalam status Anda.
Untuk infrastruktur yang lebih besar, pembuatan kueri untuk setiap resource berjalan sangat lambat. Banyak penyedia cloud tidak menyediakan API untuk mengkueri beberapa resource pada saat yang bersamaan, dan waktu round trip untuk setiap resource adalah ratusan milidetik. Selain itu, penyedia cloud hampir selalu memiliki pembatasan kapasitas API, jadi Terraform hanya dapat meminta resource dalam jumlah yang terbatas dalam satu waktu. Banyak pengguna Terraform sering menggunakan flag -refresh=false dan flag -target untuk mengatasi hal ini. Dalam skenario-skenario ini, status yang di-cache diperlakukan sebagai catatan kebenaran.
Dalam konfigurasi default, Terraform menyimpan status dalam file pada direktori kerja saat ini di tempat Terraform dijalankan. Ini akan berfungsi saat Anda baru akan memulai. Namun, jika Terraform digunakan dalam sebuah tim, penting bagi semua orang untuk bekerja dalam status yang sama sehingga operasi akan diterapkan ke objek jarak jauh yang sama.
Status jarak jauh adalah solusi yang direkomendasikan untuk masalah ini. Dengan backend status berfitur lengkap, Terraform dapat menggunakan penguncian jarak jauh sebagai langkah untuk mencegah beberapa pengguna menjalankan Terraform secara tidak sengaja pada saat yang bersamaan; hal ini memastikan bahwa setiap operasi Terraform dimulai dengan status diperbarui yang paling terkini.
Jika didukung oleh backend Anda, Terraform akan mengunci status Anda untuk semua operasi yang dapat menulis status. Dengan ini, orang lain tidak akan bisa mendapatkan kunci dan merusak status Anda.
Penguncian status terjadi otomatis pada semua operasi yang dapat menulis status. Anda tidak akan melihat pesan apa pun bahwa itu sedang terjadi. Jika penguncian status gagal, Terraform tidak akan dilanjutkan. Anda dapat menonaktifkan penguncian status untuk sebagian besar perintah dengan flag -lock, tapi ini tidak direkomendasikan.
Jika dibutuhkan waktu yang lebih lama dari yang diperkirakan untuk mendapatkan kunci, Terraform akan mengeluarkan pesan status. Jika Terraform tidak mengeluarkan pesan, berarti penguncian status masih berlangsung.
Tidak semua backend mendukung penguncian. Lihat daftar jenis backend untuk mengetahui detail apakah backend mendukung penguncian atau tidak.
Setiap konfigurasi Terraform memiliki backend terkait yang menentukan cara eksekusi operasi dan lokasi penyimpanan data persisten seperti status Terraform.
Data persisten yang disimpan di backend merupakan bagian dari ruang kerja. Pada awalnya, backend hanya memiliki satu ruang kerja, bernama default, dan oleh karena itu hanya ada satu status Terraform yang terkait dengan konfigurasi tersebut.
Backend tertentu mendukung beberapa ruang kerja bernama, yang memungkinkan beberapa status dikaitkan dengan satu konfigurasi. Konfigurasi tetap hanya memiliki satu backend, tapi beberapa instance unik dari konfigurasi tersebut dapat di-deploy tanpa perlu mengonfigurasi backend baru atau mengubah kredensial autentikasi.
Backend di Terraform menentukan cara memuat status dan cara mengeksekusi operasi seperti apply. Abstraksi ini memungkinkan penyimpanan status file nonlokal, eksekusi jarak jauh, dll.
Secara default, Terraform menggunakan backend "lokal", yang merupakan perilaku normal yang biasa Anda lihat pada Terraform. Ini adalah backend yang dipanggil di lab-lab sebelumnya.
Berikut adalah beberapa manfaat backend:
terraform apply dapat membutuhkan waktu yang lama. Beberapa backend mendukung operasi jarak jauh, yang memungkinkan operasi dieksekusi secara jarak jauh. Anda kemudian dapat mematikan komputer, dan operasi Anda akan tetap selesai. Jika digabungkan dengan penyimpanan status jarak jauh dan penguncian (dijelaskan di atas), ini juga akan membantu dalam lingkungan tim.Backend sepenuhnya opsional: Anda dapat menggunakan Terraform dengan baik tanpa perlu mempelajari atau menggunakan backend. Namun, backend dapat menyelesaikan poin yang dialami oleh tim di skala tertentu. Jika Anda bekerja sebagai individu, Anda mungkin bisa berhasil tanpa perlu menggunakan backend.
Meskipun Anda hanya berniat menggunakan backend "lokal", Ada baiknya Anda mempelajari backend agar dapat mengubah perilaku backend lokal.
Anda dapat menggunakan Gemini Code Assist di lingkungan pengembangan terintegrasi (IDE) seperti Cloud Shell untuk menerima panduan tentang kode atau menyelesaikan masalah dengan kode Anda. Sebelum mulai menggunakan Gemini Code Assist, Anda perlu mengaktifkannya.
Di panel kiri, klik ikon Settings, lalu di tampilan Settings, cari Gemini Code Assist.
Temukan dan pastikan kotak centang dipilih untuk Geminicodeassist: Enable, lalu tutup Settings.
Klik Cloud Code - No Project di status bar di bagian bawah layar.
Berikan otorisasi pada plugin seperti yang ditunjukkan. Jika project tidak dipilih secara otomatis, klik Select a Google Cloud Project, lalu pilih
Pastikan project Google Cloud Anda (
Di bagian ini, Anda akan mempelajari cara mengonfigurasi backend lokal.
Saat mengonfigurasi backend untuk pertama kali (dari tidak ada backend yang ditentukan hingga mengonfigurasi backend secara eksplisit), Terraform akan memberi opsi untuk memigrasikan status Anda ke backend baru. Ini memungkinkan Anda menggunakan backend tanpa kehilangan status apa pun yang sudah ada.
Agar lebih berhati-hati, sebaiknya cadangkan juga status Anda secara manual. Anda dapat melakukan ini cukup dengan menyalin file terraform.tfstate ke lokasi lain. Proses inisialisasi juga akan membuat cadangan, tetapi tidak ada salahnya berjaga-jaga.
Mengonfigurasi backend untuk pertama kali tidak ada bedanya dengan mengubah konfigurasi di masa mendatang: buat konfigurasi baru dan jalankan terraform init. Terraform akan memandu Anda di sepanjang proses.
main.tf:Di toolbar Cloud Shell, klik Open Editor.
Salin kode resource bucket Cloud Storage berikut ke file konfigurasi main.tf Anda.
Anda dapat mempelajari lebih lanjut resource Cloud Storage dari dokumentasi Terraform.
Dengan file main.tf terbuka dan Gemini Code Assist diaktifkan di IDE, lihat ikon 
Klik ikon Gemini Code Assist: Smart Actions
Anda dapat menggunakan fitur Gemini Code Assist yang didukung AI untuk membuat perubahan pada kode Anda langsung di editor kode. Dalam contoh ini, Anda memutuskan untuk meminta bantuan Gemini Code Assist dalam mengedit konten file konfigurasi main.tf.
main.tf, tempel perintah berikut ke kolom teks inline Gemini Code Assist yang terbuka dari toolbar.Untuk meminta Gemini Code Assist memodifikasi kode yang sesuai, tekan ENTER.
Saat diminta di tampilan Gemini Diff, klik Accept.
Konten file konfigurasi main.tf sekarang akan terlihat seperti berikut.
main.tf Anda:Ini akan mereferensikan file terraform.tfstate di direktori terraform/state. Untuk menentukan jalur file yang berbeda, ubah variabel path.
Backend lokal menyimpan status pada sistem file lokal, mengunci status tersebut menggunakan API sistem, dan melakukan operasi secara lokal.
Terraform harus melakukan inisialisasi backend yang dikonfigurasi sebelum digunakan. Untuk melakukannya, Anda harus menjalankan terraform init. Perintah terraform init harus dijalankan oleh setiap anggota tim Anda pada setiap konfigurasi Terraform sebagai langkah pertama. Anda dapat mengeksekusi beberapa kali dan melakukan semua tindakan penyiapan yang diperlukan untuk lingkungan Terraform, termasuk melakukan inisialisasi backend.
Perintah init harus dipanggil:
Anda tidak perlu mengingat kasus-kasus ini secara persis. Terraform akan mendeteksi saat inisialisasi diperlukan dan menampilkan pesan error dalam situasi tersebut. Terraform tidak melakukan inisialisasi otomatis karena mungkin akan memerlukan informasi tambahan dari pengguna atau melakukan migrasi status, dll.
Sekarang, Editor Cloud Shell seharusnya akan menampilkan file status bernama terraform.tfstate di direktori terraform/state.
Resource google_storage_bucket.test-bucket-for-state Anda seharusnya akan ditampilkan.
Backend Cloud Storage menyimpan status sebagai objek dalam imbuhan yang dapat dikonfigurasi pada bucket tertentu di Cloud Storage. Backend ini juga mendukung penguncian status. Ini akan mengunci status Anda untuk semua operasi yang dapat menulis status. Dengan ini, orang lain tidak akan bisa mendapatkan kunci dan merusak status Anda.
Penguncian status terjadi otomatis pada semua operasi yang dapat menulis status. Anda tidak akan melihat pesan apa pun bahwa itu sedang terjadi. Jika penguncian status gagal, Terraform tidak akan dilanjutkan. Anda dapat menonaktifkan penguncian status untuk sebagian besar perintah dengan flag -lock, tapi ini tidak direkomendasikan.
Kembali ke file main.tf Anda di Editor. Anda sekarang akan mengganti backend lokal saat ini dengan backend gcs.
Untuk mengganti konfigurasi backend lokal yang sudah ada, salin konfigurasi berikut ke file Anda, dengan mengganti backend local:
bucket. Jika Anda tidak mengubah konfigurasi, ini akan menjadi name dari resource google_storage_bucket. Bucket ini digunakan untuk menghosting file status.
Masukkan yes pada prompt untuk mengonfirmasi.
Di Konsol Cloud, pada Navigation menu, klik Cloud Storage > Buckets.
Klik bucket Anda dan cari file terraform/state/default.tfstate. File status Anda sekarang berada di bucket Cloud Storage.
Perintah terraform refresh digunakan untuk merekonsiliasi status yang diketahui Terraform (melalui file statusnya) dengan infrastruktur dunia nyata. Ini dapat digunakan untuk mendeteksi setiap penyimpangan dari status yang terakhir diketahui dan memperbarui file status.
Perintah ini tidak memodifikasi infrastruktur, melainkan memodifikasi file status. Jika status diubah, ini dapat menyebabkan perubahan terjadi selama plan atau apply berikutnya.
Kembali ke bucket Cloud Storage di Konsol Cloud. Pilih kotak centang di samping nama bucket.
Klik tab Labels.
Klik Add Label. Tetapkan Key 2 = key dan Value 2 = value.
Klik Save.
Kembali ke Cloud Shell dan jalankan perintah berikut untuk memperbarui file status:
Pasangan nilai kunci "key" = "value" seharusnya ditampilkan di atribut label konfigurasi.
Klik Periksa progres saya untuk memverifikasi tujuan.
Sebelum melanjutkan ke tugas berikutnya, Anda perlu menghancurkan infrastruktur yang disediakan.
local, sehingga Anda dapat menghapus bucket penyimpanan. Salin dan ganti konfigurasi gcs dengan yang berikut:local:Masukkan yes pada prompt untuk mengonfirmasi.
main.tf terbuka, lihat ikon yang ada di sudut kanan atas editor.Selanjutnya, Anda memutuskan menggunakan Gemini Code Assist untuk membantu memodifikasi konfigurasi Terraform, dengan menambahkan argumen ke kode yang digunakan untuk menghancurkan resource bucket Cloud Storage.
Klik ikon Gemini Code Assist: Smart Actions
Agar Gemini Code Assist dapat membantu Anda memodifikasi file konfigurasi main.tf, tempel perintah berikut ke kolom teks inline Gemini Code Assist yang terbuka dari toolbar.
Saat Anda menghapus bucket, opsi boolean ini digunakan untuk menghapus semua objek dalam container. Jika Anda mencoba menghapus bucket yang berisi objek, Terraform akan menggagalkan operasi tersebut.
Untuk meminta Gemini Code Assist memodifikasi kode yang sesuai, tekan ENTER.
Saat diminta di tampilan Gemini Diff, klik Accept.
Konten file konfigurasi main.tf sekarang akan terlihat seperti berikut.
Masukkan yes pada prompt untuk mengonfirmasi.
Masukkan yes pada prompt untuk mengonfirmasi.
Di bagian ini, Anda akan mengimpor container dan image Docker yang sudah ada ke ruang kerja Terraform yang kosong. Dengan melakukannya, Anda akan mempelajari strategi dan pertimbangan untuk mengimpor infrastruktur dunia nyata ke Terraform.
Alur kerja Terraform default meliputi pembuatan dan pengelolaan infrastruktur secara keseluruhan dengan Terraform.
Tulis konfigurasi Terraform yang menetapkan infrastruktur yang ingin Anda buat.
Tinjau rencana Terraform untuk memastikan bahwa konfigurasi akan menghasilkan status dan infrastruktur yang diharapkan.
Terapkan konfigurasi untuk membuat status dan infrastruktur Terraform Anda.
Setelah membuat infrastruktur dengan Terraform, Anda dapat memperbarui konfigurasi dan rencana, serta menerapkan perubahan tersebut. Pada akhirnya, Anda akan menggunakan Terraform untuk menghancurkan infrastruktur saat tidak lagi dibutuhkan. Alur kerja ini mengasumsikan bahwa Terraform akan membuat infrastruktur yang sepenuhnya baru.
Akan tetapi, Anda mungkin perlu mengelola infrastruktur yang tidak dibuat oleh Terraform. Impor Terraform mengatasi masalah ini dengan memuat resource yang didukung ke status ruang kerja Terraform Anda.
Namun demikian, perintah impor tidak otomatis membuat konfigurasi untuk mengelola infrastruktur. Karena itu, proses pengimporan infrastruktur yang sudah ada ke Terraform terdiri dari beberapa langkah.
Menghadirkan infrastruktur yang sudah ada ke dalam kontrol Terraform mencakup lima langkah utama:
Di bagian ini, Anda akan terlebih dahulu membuat container Docker dengan Docker CLI. Selanjutnya, Anda akan mengimpornya ke ruang kerja Terraform yang baru. Anda kemudian akan memperbarui konfigurasi container menggunakan Terraform sebelum akhirnya menghancurkannya setelah selesai.
terraform.tfstate dan direktori .terraform sebelum menggunakan impor Terraform pada proyek Terraform sungguhan, dan simpan secara aman.
hashicorp-learn menggunakan image NGINX terbaru dari Docker Hub, dan lihat pratinjau container pada virtual machine Cloud Shell melalui port 80 (HTTP):Cloud Shell membuka URL pratinjau pada layanan proxy-nya di jendela browser baru dan menampilkan halaman indeks default NGINX. Sekarang Anda memiliki image dan container Docker yang dapat diimpor ke ruang kerja Anda dan dikelola dengan Terraform.
Direktori ini berisi dua file konfigurasi Terraform yang membentuk konfigurasi yang akan Anda gunakan nanti dalam panduan ini:
main.tf mengonfigurasi penyedia Docker.docker.tf berisi konfigurasi yang diperlukan untuk mengelola container Docker yang telah Anda buat pada langkah sebelumnya.terraform init -upgrade
Di Editor Cloud Shell, buka learn-terraform-import/main.tf.
Temukan resource provider: docker dan jadikan sebagai komentar atau hapus argumen host:
Selanjutnya, buka learn-terraform-import/docker.tf.
Di bawah kode yang telah dijadikan sebagai komentar, tetapkan resource docker_container kosong di file docker.tf, yang mewakili container Docker dengan ID resource Terraform docker_container.web:
terraform import berikut untuk menghubungkan container Docker yang sudah ada ke resource docker_container.web yang baru saja Anda buat. Impor Terraform memerlukan ID resource Terraform ini dan ID container Docker lengkap. Perintah docker inspect -f {{.ID}} hashicorp-learn akan menampilkan ID container SHA256 lengkap:terraform import bervariasi berdasarkan jenis resource dan didokumentasikan dalam dokumentasi penyedia untuk setiap resource yang dapat diimpor ke Terraform. Untuk mempelajari contoh ini, baca dokumentasi penyedia Docker
Status ini berisi segala sesuatu yang diketahui oleh Terraform mengenai container Docker yang baru saja Anda impor. Namun demikian, impor Terraform tidak membuat konfigurasi untuk resource.
Anda perlu membuat konfigurasi Terraform sebelum dapat menggunakan Terraform untuk mengelola container ini.
image dan name yang diperlukan. Terraform tidak dapat membuat rencana untuk resource yang tidak memiliki argumen yang diperlukan.
Ada dua pendekatan untuk memperbarui konfigurasi di docker.tf agar sesuai dengan status yang Anda impor. Anda dapat menerima keseluruhan status resource saat ini ke dalam konfigurasi Anda sebagaimana adanya, atau memilih atribut yang diperlukan ke dalam konfigurasi Anda satu per satu. Masing-masing dari pendekatan ini dapat berguna pada keadaan yang berbeda.
Menggunakan status saat ini sering kali lebih cepat, tapi dapat menghasilkan konfigurasi yang terlalu panjang karena setiap atribut disertakan dalam status, tanpa memandang apakah atribut tersebut perlu disertakan dalam konfigurasi atau tidak.
Memilih atribut yang diperlukan satu per satu dapat menghasilkan konfigurasi yang lebih dapat dikelola, tetapi Anda harus memahami atribut mana yang perlu disetel dalam konfigurasi.
Untuk tujuan lab ini, Anda akan menggunakan status saat ini sebagai resource.
docker.tf:> akan mengganti seluruh isi docker.tf dengan output perintah terraform show. Meskipun sesuai untuk contoh ini, mengimpor resource ke konfigurasi yang sudah mengelola resource akan mengharuskan Anda mengedit output terraform show untuk menghapus resource yang sudah ada yang konfigurasinya tidak ingin Anda ganti secara keseluruhan dan menggabungkan resource baru ke dalam konfigurasi yang sudah ada.
Periksa file docker.tf untuk melihat bahwa isinya telah diganti dengan output perintah terraform show yang baru saja Anda jalankan.
Jalankan kode berikut:
Terraform akan menampilkan peringatan dan error tentang argumen yang tidak digunakan lagi ('link'), dan beberapa argumen hanya baca (ip_address, network_data, gateway, ip_prefix_length, id).
Argumen hanya baca ini adalah nilai yang disimpan Terraform dalam statusnya untuk container Docker, tetapi tidak dapat disetel melalui konfigurasi karena dikelola secara internal oleh Docker. Terraform dapat menyetel argumen link dengan konfigurasi, tapi akan tetap menampilkan peringatan karena tidak digunakan lagi dan mungkin tidak didukung oleh versi penyedia Docker di masa mendatang.
Karena pendekatan yang ditunjukkan di sini memuat semua atribut yang diwakili dalam status Terraform, konfigurasi Anda akan mencakup atribut opsional yang nilainya sama seperti nilai defaultnya. Atribut mana yang opsional, dan nilai-nilai defaultnya, akan bervariasi dari satu penyedia ke penyedia lain, dan tercantum dalam dokumentasi penyedia.
image, name, dan ports. Setelah menghapus atribut opsional ini, konfigurasi Anda seharusnya sesuai dengan contoh berikut:Output:
Saat mengimpor infrastruktur sungguhan, baca dokumentasi penyedia untuk mempelajari fungsi setiap argumen. Ini akan membantu Anda menentukan cara menangani setiap error atau peringatan dari langkah plan. Misalnya, dokumentasi untuk argumen links berada di dokumentasi penyedia Docker.
Rencana ini seharusnya sekarang akan berhasil dieksekusi. Perhatikan bahwa rencana mengindikasikan Terraform akan memperbarui container untuk menambahkan atribut attach, logs, must_run, dan start.
Terraform menggunakan atribut ini untuk membuat container Docker, tapi Docker tidak menyimpannya. Sebagai akibatnya, terraform import tidak memuat nilai-nilainya ke status. Saat Anda merencanakan dan menerapkan konfigurasi, penyedia Docker akan menetapkan nilai default untuk atribut ini dan menyimpannya dalam status, tetapi nilai tersebut tidak akan memengaruhi container yang sedang berjalan.
Sekarang file konfigurasi, status Terraform, dan container telah sinkron, dan Anda dapat menggunakan Terraform untuk mengelola container Terraform seperti biasa.
Dalam beberapa kasus, Anda dapat menghadirkan resource ke dalam kontrol Terraform tanpa menggunakan perintah terraform import. Ini sering kali merupakan kasus untuk resource yang ditentukan oleh satu tag atau ID unik, seperti image Docker.
Di file docker.tf, resource docker_container.web menentukan ID hash SHA256 dari image yang digunakan untuk membuat container. Ini adalah cara Docker menyimpan ID image secara internal, dan oleh karena itu terraform import memuat ID image secara langsung ke status Anda. Namun demikian, ID image mungkin tidak dapat dibaca manusia semudah tag atau nama image, dan mungkin tidak sesuai dengan intent Anda. Misalnya, Anda mungkin ingin menggunakan versi terbaru image "nginx".
<IMAGE-ID> dengan ID image dari docker.tf:docker.tf untuk menampilkan image ini sebagai resource:docker_container.web pada saat ini, atau Terraform akan menghancurkan dan membuat ulang container Anda. Karena Terraform belum memuat resource docker_image.nginx ke status, tidak ada ID image yang dapat dibandingkan oleh Terraform dengan ID image yang di-hardcode, yang akan menyebabkan Terraform berasumsi bahwa container harus diganti. Sebagai solusi sementara atas situasi ini, buat image terlebih dahulu, lalu perbarui container untuk menggunakannya, seperti yang ditunjukkan di lab ini.
Karena sekarang Terraform telah membuat resource untuk image, Anda dapat merujuknya dalam konfigurasi container. Anda memutuskan untuk meminta bantuan Gemini Code Assist untuk melakukannya.
Dengan file docker.tf terbuka, lihat ikon
Klik ikon Gemini Code Assist: Smart Actions
Untuk mengubah nilai image untuk docker_container.web agar merujuk resource image baru di file docker.tf, tempel perintah berikut ke kolom teks inline Gemini Code Assist yang terbuka dari toolbar.
Untuk meminta Gemini Code Assist memodifikasi kode yang sesuai, tekan ENTER.
Saat diminta di tampilan Gemini Diff, klik Accept.
Konten file konfigurasi docker.tf sekarang akan terlihat seperti berikut.
Karena docker_image.nginx.latest cocok dengan ID image hardcoded yang Anda ganti, menjalankan terraform apply pada saat ini tidak akan menunjukkan perubahan apa pun.
Karena sekarang Terraform mengelola container Docker, Anda dapat menggunakan Terraform untuk mengubah konfigurasi.
docker.tf Anda, ubah port eksternal container dari 8080 menjadi 8081:Masukkan yes pada prompt untuk mengonfirmasi.
Hal ini menyebabkan Terraform menghancurkan dan membuat ulang container dengan konfigurasi port yang baru.
Perhatikan bahwa ID container telah berubah. Karena perubahan konfigurasi port mengharuskannya dihancurkan dan dibuat ulang, ini adalah container yang benar-benar baru.
Anda telah mengimpor container Docker dan image yang digunakan untuk membuatnya ke Terraform.
Masukkan yes pada prompt untuk mengonfirmasi.
Ada beberapa hal penting yang harus dipertimbangkan saat mengimpor resource ke Terraform.
Impor Terraform hanya dapat mengetahui status infrastruktur saat ini seperti yang dilaporkan oleh penyedia Terraform. Impor Terraform tidak mengetahui:
Impor mencakup langkah-langkah manual yang mungkin rentan terhadap error, khususnya jika orang yang mengimpor resource tidak mengetahui konteks bagaimana dan mengapa resource tersebut pada awalnya dibuat.
Impor akan memanipulasi file status Terraform; sebaiknya Anda membuat cadangan sebelum mengimpor infrastruktur baru.
Impor Terraform tidak mendeteksi atau membuat hubungan antara infrastruktur.
Terraform tidak mendeteksi atribut default yang tidak perlu disetel di konfigurasi Anda.
Tidak semua penyedia dan resource mendukung impor Terraform.
Mengimpor infrastruktur ke Terraform tidak berarti bahwa infrastruktur tersebut dapat dihancurkan dan dibuat ulang oleh Terraform. Misalnya, infrastruktur yang diimpor dapat mengandalkan infrastruktur atau konfigurasi lain yang tidak dikelola.
Mengikuti praktik terbaik infrastruktur sebagai kode (IaC) seperti infrastruktur yang tidak dapat diubah dapat membantu mencegah banyak masalah ini. Namun, infrastruktur yang dibuat secara manual kemungkinan besar tidak mengikuti praktik terbaik IaC.
Alat seperti Terraformer dapat mengotomatiskan beberapa langkah manual yang terkait dengan pengimporan infrastruktur. Namun demikian, alat-alat ini bukan bagian dari Terraform itu sendiri dan tidak dipromosikan atau didukung oleh HashiCorp.
Di lab ini, Anda telah mempelajari cara mengelola backend dan status dengan Terraform dan bantuan Gemini Code Assist. Anda telah membuat backend lokal dan backend Cloud Storage untuk mengelola file status, me-refresh status, dan mengimpor konfigurasi ke Terraform. Anda juga telah memperbarui konfigurasi dan mengeditnya secara manual untuk mengelola container Docker sepenuhnya dengan Terraform.
Pastikan Anda membaca referensi berikut untuk menerima lebih banyak praktik langsung dengan Terraform:
...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.
Manual Terakhir Diperbarui pada 25 Agustus 2025
Lab Terakhir Diuji pada 25 Agustus 2025
Hak cipta 2025 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.
Konten ini tidak tersedia untuk saat ini
Kami akan memberi tahu Anda melalui email saat konten tersedia
Bagus!
Kami akan menghubungi Anda melalui email saat konten tersedia
Satu lab dalam satu waktu
Konfirmasi untuk mengakhiri semua lab yang ada dan memulai lab ini