github/gitignore · Terraform.gitignore
Penjelasan template .gitignore Terraform
Menjelaskan mengapa Terraform.gitignore mengabaikan folder .terraform, tfstate, tfvars, file override, dan pengaturan CLI, serta mengapa .terraform.lock.hcl harus di-commit.
Terraform.gitignore berfokus agar state dan rahasia tidak bocor di repositori yang menangani kode infrastruktur. File state Terraform menyimpan atribut sumber daya dalam teks biasa dan bisa berisi kata sandi basis data atau kunci.
.terraform.lock.hcl tidak diabaikan oleh template ini. HashiCorp menyarankan agar file kunci dependensi ini dimasukkan ke kontrol versi.
Penjelasan per aturan
| Pola | Apa yang diabaikan dan mengapa |
|---|---|
.terraform/ | Direktori kerja lokalBerisi biner provider dan modul yang diunduh terraform init, serta pengaturan backend. Binernya khusus sistem operasi sehingga tidak bisa dibagikan, dan ukurannya besar. |
*.tfstate*.tfstate.*.terraform.tfstate.lock.info | File stateFile yang mencatat hubungan antara infrastruktur nyata dan kode. Informasi sensitif masuk dalam teks biasa, dan jika beberapa orang memegang salinan masing-masing, state menjadi tidak sinkron. Simpan di backend jarak jauh seperti S3 atau Terraform Cloud dan aktifkan penguncian. |
*.tfvars*.tfvars.json | File nilai variabelFile berisi nilai per lingkungan dan rahasia. Komentar template juga menjelaskan bahwa kemungkinan besar berisi kata sandi dan kunci privat. |
override.tfoverride.tf.json*_override.tf*_override.tf.json | File overrideFile untuk menimpa sementara pengaturan sumber daya secara lokal. Untuk meng-commit, hidupkan kembali dalam bentuk !example_override.tf seperti pada komentar template. |
crash.logcrash.*.log | Log crashLog yang ditinggalkan Terraform saat berhenti tidak normal, dan bisa berisi isi konfigurasi. |
.terraformrcterraform.rc | Pengaturan CLIFile pengaturan CLI yang bisa berisi token autentikasi Terraform Cloud. |
Hal yang perlu diperhatikan dalam praktik
- Commit
.terraform.lock.hcl. Dengan begitu semua orang melakukan inisialisasi dengan versi dan hash provider yang sama. - Variabel default yang perlu dibagikan taruh di
defaultpadavariables.tfatau di file contoh (terraform.tfvars.example), bukan di*.auto.tfvars. Aturan*.tfvarstidak mengabaikan file yang berakhiran.example. - File rencana yang dibuat dengan
terraform plan -out=tfplanjuga berisi informasi sensitif, jadi lebih aman menambahkan aturan*tfplan*seperti pada komentar template. - Jika file state sudah terlanjur di-commit, selain menghapusnya dari repositori, ganti juga semua rahasia yang ada di dalamnya.
Template asli
Terraform.gitignore
# Local .terraform directories.terraform/# .tfstate files*.tfstate*.tfstate.*# Crash log filescrash.logcrash.*.log# Exclude all .tfvars files, which are likely to contain sensitive data, such as# password, private keys, and other secrets. These should not be part of version# control as they are data points which are potentially sensitive and subject# to change depending on the environment.*.tfvars*.tfvars.json# Ignore override files as they are usually used to override resources locally and so# are not checked inoverride.tfoverride.tf.json*_override.tf*_override.tf.json# Ignore transient lock info files created by terraform apply.terraform.tfstate.lock.info# Include override files you do wish to add to version control using negated pattern# !example_override.tf# Include tfplan files to ignore the plan output of command: terraform plan -out=tfplan# example: *tfplan*# Ignore CLI configuration files.terraformrcterraform.rc# Optional: ignore graph output files generated by `terraform graph`# *.dot# Optional: ignore plan files saved before destroying Terraform configuration# Uncomment the line below if you want to ignore planout files.# planout
Sumber template: github/gitignore/Terraform.gitignore @356fd7b (2026-09-11) · CC0-1.0