Komentar dan Pengutipan dalam Template

Chart memiliki dua cara untuk menambahkan catatan: komentar YAML biasa dan komentar templat khusus. Keduanya berperilaku sangat berbeda saat render.

Baris yang diawali tanda pagar adalah komentar YAML biasa. Baris tersebut diteruskan begitu saja dan tetap ada dalam hasil render agar dapat dibaca siapa pun.

Helm memiliki komentarnya sendiri yang menghilang sepenuhnya. Bungkus teks dengan {{/* */}} dan mesin akan menghapusnya sebelum keluaran.

Gunakan tanda pagar untuk mendokumentasikan YAML yang diterapkan. Gunakan komentar templat untuk catatan tentang logika templat yang tidak boleh dilihat pengguna. 📝

Komentar templat berguna untuk menonaktifkan kode. Bungkus sebuah aksi dengan {{/* */}} dan Helm akan melewatinya—tanpa perenderan dan tanpa kesalahan.

YAML sering menebak tipe data. Nilai 1.10 dapat berubah menjadi 1.1, dan yes dapat berubah menjadi true. Pemberian tanda kutip memaksanya tetap menjadi teks yang jelas.

Helm menyediakan fungsi quote yang membungkus nilai dengan tanda kutip ganda untuk Anda, sehingga bidang yang dirender pasti berupa teks.

Biasanya Anda akan melihat quote ditulis sebagai pipa di akhir sebuah aksi. Maknanya alami: ambil nilainya, lalu beri tanda kutip.

Tanpa tanda kutip, versi seperti 1.20 dapat diam-diam kehilangan angka nol di belakang dan menjadi 1.2, sehingga referensi image Anda rusak. Tanda kutip mencegahnya. ⚠️

Kubernetes terkadang menginginkan angka tetap disimpan sebagai teks, seperti porta dalam anotasi. Menyalurkannya melalui quote membuatnya tetap menjadi teks dengan aman.

Anda juga dapat menulis tanda kutip literal sendiri dalam YAML. Fungsi quote hanya melakukannya secara terprogram ketika nilainya berasal dari templat.

Sekarang Anda dapat menyembunyikan catatan dengan {{/* */}}, mempertahankan catatan yang terlihat dengan tanda pagar, dan memaksa nilai menjadi teks yang rapi menggunakan fungsi quote. 🎯