Mengklik di sekitar konsol cloud baik-baik saja untuk satu server. Ini rusak ketika Anda memerlukan pengaturan yang sama dalam pementasan dan produksi, atau ketika seseorang bertanya siapa yang mengubah aturan firewall pada bulan Maret lalu. Tutorial Terraform untuk pemula ini menunjukkan cara yang lebih baik: jelaskan infrastruktur Anda dalam kode, dan biarkan alat mewujudkannya.

Sebagian besar tutorial dimulai dengan akun cloud, yang menambah risiko penagihan sebelum Anda mempelajari apa pun. Kami mulai dengan penyedia Terraform local, yang hanya membuat file di komputer Anda, jadi kesalahan tidak memerlukan biaya apa pun. Contoh-contoh ini dan contoh keluarannya adalah ilustrasi standar yang tidak kami jalankan untuk artikel ini, dan susunan kata yang tepat bervariasi menurut versi.

Apa itu Terraform?

Terraform adalah alat infrastruktur sebagai kode (IaC) dari HashiCorp. Anda menulis file konfigurasi dalam HCL, Bahasa Konfigurasi HashiCorp, yang menjelaskan hasil akhir yang Anda inginkan. Terraform kemudian menentukan apa yang harus dibuat, diubah, atau dihapus untuk mencapainya.

Ia berkomunikasi dengan platform melalui plugin yang disebut penyedia. Ada penyedia untuk AWS, Azure, Google Cloud, Kubernetes, GitHub, Cloudflare, dan banyak lainnya, sehingga Anda dapat menggunakan satu alur kerja di semuanya.

Satu hal yang perlu diketahui: pada tahun 2023, HashiCorp memindahkan Terraform ke Lisensi Sumber Bisnis. Komunitas kemudian membuat OpenTofu, sebuah fork sumber terbuka yang menggunakan perintah dan konfigurasi yang sangat mirip. Apa yang Anda pelajari di sini sebagian besar berlaku untuk keduanya.

Mengapa infrastruktur sebagai kode?

Terraform juga deklaratif. Anda menyatakan “harus ada tiga server”, bukan “buat server, tiga kali”. Jika sudah ada dua, ia menambahkan satu. Sebuah skrip yang hanya mengulangi langkah-langkahnya bisa menghasilkan tiga langkah lagi.

Instal Terraform

Instal menggunakan instruksi resmi HashiCorp untuk sistem operasi Anda, lalu konfirmasikan bahwa itu berfungsi:

terraform -version

Buat folder kosong untuk proyek tersebut. Terraform membaca setiap file .tf di folder saat ini, jadi satu folder sama dengan satu konfigurasi.

Konfigurasi pertama Anda

Buat file bernama main.tf:

terraform {
  required_providers {
    local = {
      source  = "hashicorp/local"
      version = "~> 2.5"
    }
  }
}

resource "local_file" "greeting" {
  filename = "${path.module}/hello.txt"
  content  = "Hello from Terraform\n"
}

Lihatlah blok resource, karena hampir semua yang Anda tulis mengikuti bentuk ini. local_file adalah jenis sumber daya, dan greeting adalah nama Anda sendiri untuk sumber daya tersebut di dalam konfigurasi. Bersama-sama, mereka membentuk alamatnya: local_file.greeting. Argumen di dalamnya menggambarkan apa yang Anda inginkan.

Alur kerja: init, plan, apply

terraform init

Ini menyiapkan folder dan mengunduh penyedia yang Anda minta. Jalankan sekali di awal, dan jalankan lagi setiap kali Anda menambahkan penyedia atau modul. Itu juga membuat file .terraform.lock.hcl, yang mencatat versi penyedia yang tepat. Komit file itu ke Git.

terraform init

rencana terraform

Ini membandingkan kode Anda dengan apa yang ada dan menunjukkan perubahan yang direncanakan, tanpa menyentuh apa pun:

terraform plan

# local_file.greeting will be created
+ resource "local_file" "greeting" {
    + content  = "Hello from Terraform\n"
    + filename = "./hello.txt"
  }

Plan: 1 to add, 0 to change, 0 to destroy.

Pelajari simbol-simbolnya, karena Anda akan membaca banyak rencana:

terraform berlaku

Ini menunjukkan rencananya lagi, meminta konfirmasi dan membuat perubahan:

terraform apply

Ketik yes, dan hello.txt muncul. Sekarang jalankan terraform plan lagi. Seharusnya melaporkan tidak ada perubahan, karena kenyataan sudah sesuai dengan kode Anda. Properti ini, jika dijalankan berulang kali tidak menyebabkan perubahan lebih lanjut, disebut idempotensi.

Mengubah dan menghancurkan

Edit baris content dan jalankan terraform plan. Terraform menemukan perbedaannya dan mengusulkan perubahan. Untuk sumber daya ini, ia menggantikan file. Perhatikan penggantian infrastruktur nyata, karena membuat ulang database dapat berarti kehilangan data.

Selanjutnya, hapus hello.txt dengan tangan dan rencanakan lagi. Terraform menyadari bahwa itu hilang dan menawarkan untuk membuatnya kembali. Perbedaan antara kode Anda dan kenyataan disebut drift, dan mendeteksinya adalah salah satu manfaat utama alat ini.

Untuk menghapus semua yang dikelola konfigurasi ini, jalankan:

terraform destroy

Variabel dan keluaran

Nilai-nilai hard-code menghentikan Anda menggunakan kembali kode. Variabel masukan membuat konfigurasi menjadi fleksibel, dan keluaran melaporkan kembali nilai-nilai yang berguna:

# variables.tf
variable "environment" {
  type        = string
  description = "Deployment environment"
  default     = "dev"

  validation {
    condition     = contains(["dev", "staging", "prod"], var.environment)
    error_message = "Use dev, staging or prod."
  }
}

# main.tf
resource "local_file" "config" {
  filename = "${path.module}/${var.environment}.txt"
  content  = "environment=${var.environment}\n"
}

# outputs.tf
output "config_path" {
  value = local_file.config.filename
}

Tetapkan nilai pada baris perintah, atau simpan dalam file bernama terraform.tfvars, yang dimuat secara otomatis:

terraform apply -var="environment=staging"

Menggunakan local_file.config.filename dalam output juga merupakan cara sumber daya merujuk satu sama lain. Terraform membaca referensi tersebut untuk menentukan urutan yang benar dalam menciptakan sesuatu.

Keadaan terraform

Setelah mendaftar, Anda akan menemukan file bernama terraform.tfstate. Ini adalah catatan Terraform tentang apa yang dikelolanya, memetakan kode Anda ke objek nyata. Tanpanya, Terraform tidak akan mengetahui bahwa local_file.greeting adalah file spesifik tersebut.

Tiga aturan penting di sini:

1. Jangan pernah memasukkan status ke Git. Ini dapat berisi kata sandi dan rahasia lainnya dalam teks biasa.
2. Jangan mengeditnya dengan tangan. Gunakan perintah seperti terraform state list dan terraform state mv.
3. Gunakan backend jarak jauh untuk proyek tim. Backend bersama menyimpan status secara terpusat dan menguncinya, sehingga dua orang tidak dapat mengajukan permohonan sekaligus.

Berikut adalah backend umum yang menggunakan Amazon S3, dengan bucket yang Anda buat sebelumnya:

terraform {
  backend "s3" {
    bucket       = "my-company-terraform-state"
    key          = "shop/prod/terraform.tfstate"
    region       = "ap-south-1"
    encrypt      = true
    use_lockfile = true
  }
}

Sumber daya cloud yang nyata

Alur kerja tidak berubah saat Anda berpindah ke cloud. Ini adalah bucket S3 di AWS. Periksa harga terlebih dahulu, dan hancurkan apa pun yang Anda buat saat berlatih:

provider "aws" {
  region = "ap-south-1"
}

resource "aws_s3_bucket" "reports" {
  bucket = "my-unique-reports-bucket-2026"

  tags = {
    Environment = var.environment
    ManagedBy   = "terraform"
  }
}

Terraform mendapatkan kredensial dari pengaturan AWS CLI atau variabel lingkungan Anda. Jangan pernah menulis kunci akses ke file .tf.

Modul

Modul hanyalah folder file Terraform yang dapat Anda panggil dengan input berbeda. Ini berfungsi seperti sebuah fungsi, memungkinkan Anda mendefinisikan suatu pola satu kali dan menggunakannya kembali:

project/
  main.tf
  modules/
    reports_bucket/
      main.tf
      variables.tf
      outputs.tf

module "staging_reports" {
  source      = "./modules/reports_bucket"
  environment = "staging"
}

module "prod_reports" {
  source      = "./modules/reports_bucket"
  environment = "prod"
}

Terraform Registry publik juga memiliki modul siap pakai, tetapi bacalah modul tersebut sebelum Anda mengandalkannya, dan sematkan versinya. Jangan membuat modul terlalu dini. Tunggu sampai Anda mengulangi suatu pola setidaknya dua kali.

Alur kerja tim yang aman

1. Buat cabang dan ubah file .tf. Lihat Tutorial Git untuk pemula kami jika Anda memerlukan penyegaran.
2. Jalankan terraform fmt dan terraform validate.
3. Buka permintaan tarik, dengan keluaran terraform plan terlampir untuk ditinjau.
4. Setelah disetujui, terapkan rencana tersimpan tersebut dari satu tempat terkendali, idealnya di saluran pipa.

Menyimpan paket memastikan Anda menerapkan apa yang telah ditinjau:

terraform plan -out=tfplan
terraform apply tfplan

Hal ini secara alami cocok dengan CI/CD dan Tindakan GitHub. Terraform biasanya menyediakan cluster, dan alat seperti Kubernetes kemudian menjalankan aplikasi di atasnya.

Kesalahan umum

• Melamar tanpa membaca rencana. Satu -/+ di database bisa menjadi kejutan yang sangat mahal.
• Menyimpan status di satu laptop. Jika laptop tersebut hilang, Terraform akan kehilangan jejak infrastruktur Anda.
• Membuat perubahan konsol manual. Perubahan tersebut menyebabkan penyimpangan, dan penerapan selanjutnya dapat membatalkan perubahan tersebut.
• Menggunakan versi yang tidak dipasangi pin. Pasang pin pada penyedia dan versi modul sehingga peningkatan dilakukan dengan sengaja.
• Menggunakan satu konfigurasi besar. Pemisahan berdasarkan lingkungan atau sistem membatasi kerusakan akibat kesalahan apa pun.

Penutup

Anda sekarang telah melihat ide di balik hampir semua pekerjaan Terraform: mendeklarasikan sumber daya, meninjau rencana, menerapkannya, dan melindungi negara. Berlatihlah dengan penyedia local hingga alur kerja terasa alami, lalu kelola satu sumber daya nyata kecil di akun tingkat gratis. Memasukkan status dan modul jarak jauh ketika lebih dari satu orang, atau lebih dari satu lingkungan, terlibat.

Pertanyaan yang sering diajukan

Teruslah belajar