Komen dan Petikan dalam Templat

Sebuah carta mempunyai dua cara untuk meninggalkan nota: komen YAML biasa dan komen templat khas. Kedua-duanya berkelakuan sangat berbeza semasa penjanaan.

Baris yang bermula dengan tanda pagar ialah komen YAML biasa. Baris itu diteruskan tanpa perubahan dan kekal dalam hasil yang dijana untuk dibaca oleh sesiapa sahaja.

Helm mempunyai komennya sendiri yang hilang sepenuhnya. Balut teks dengan {{/* */}} dan enjin akan membuangnya sebelum keluaran dijana.

Gunakan tanda pagar untuk mendokumenkan YAML yang digunakan. Gunakan komen templat untuk nota tentang logik templat yang tidak sepatutnya dilihat oleh pengguna. 📝

Komen templat berguna untuk menyahaktifkan kod. Balut tindakan dengan {{/* */}} dan Helm akan melangkaunya tanpa pemaparan atau ralat.

YAML sering meneka jenis data. Nilai 1.10 mungkin menjadi 1.1, dan yes mungkin bertukar menjadi true. Meletakkan tanda petik memaksa nilai itu kekal sebagai rentetan yang jelas.

Helm menyediakan fungsi quote yang membalut nilai dengan tanda petik berganda untuk anda, supaya medan yang dipaparkan jelas merupakan rentetan.

Anda biasanya akan melihat quote ditulis sebagai paip pada hujung tindakan. Maksudnya mudah difahami: ambil nilainya, kemudian letakkan tanda petik padanya.

Tanpa tanda petik, versi seperti 1.20 boleh kehilangan sifar di hujungnya secara senyap dan menjadi 1.2, lalu merosakkan rujukan imej anda. Tanda petik menghalang perkara ini. ⚠️

Kubernetes kadangkala mahu nombor dikekalkan sebagai teks, seperti port dalam anotasi. Menyalurkannya melalui quote memastikan nilainya kekal sebagai rentetan dengan selamat.

Anda juga boleh menulis tanda petik literal sendiri dalam YAML. Fungsi quote hanya melakukannya secara terprogram apabila nilai itu datang daripada templat.

Anda kini boleh menyembunyikan nota dengan {{/* */}}, mengekalkan nota yang kelihatan dengan tanda pagar, dan memaksa rentetan yang bersih menggunakan fungsi quote. 🎯