ไวยากรณ์ YAML ที่จำเป็นสำหรับ Ansible

เพลย์บุ๊ก Ansible ทุกไฟล์เขียนด้วย YAML ซึ่งเป็นรูปแบบข้อความธรรมดาที่ออกแบบมาให้มนุษย์อ่านและเขียนได้ง่าย

ไฟล์ YAML มักเริ่มต้นด้วยขีดสามตัว เครื่องหมาย --- นี้ระบุจุดเริ่มต้นของเอกสาร และ Ansible คาดว่าจะพบเครื่องหมายนี้

YAML ใช้การเยื้องเพื่อแสดงโครงสร้าง ช่องว่างหมายถึงการซ้อนระดับ ดังนั้นสิ่งที่เยื้องอยู่ใต้บรรทัดหนึ่งจะเป็นส่วนหนึ่งของบรรทัดนั้น

ให้เยื้องด้วยช่องว่างใน YAML เสมอ อักขระแท็บจริงไม่ถูกต้อง และ Ansible จะปฏิเสธการแยกวิเคราะห์ไฟล์

หัวใจของ YAML คือการจับคู่: คีย์ เครื่องหมายโคลอน ช่องว่าง แล้วจึงเป็นค่า นี่คือวิธีตั้งค่าตัวเลือกทุกตัว

ช่องว่างเพียงหนึ่งช่องหลังเครื่องหมายโคลอนเป็นสิ่งจำเป็น การเขียน name:value โดยไม่มีช่องว่างจะทำให้ตัวแยกวิเคราะห์สับสน ดังนั้นอย่าลืมเว้นช่องว่าง

รายการคือชุดของรายการย่อย โดยแต่ละรายการอยู่คนละบรรทัดและเริ่มต้นด้วยขีดตามด้วยช่องว่าง เพลย์บุ๊กเป็นเพียงรายการของเพลย์

งานของ Ansible รวมแนวคิดทั้งสองเข้าด้วยกันเป็นรายการของการจับคู่ ขีดแต่ละตัวเริ่มต้นงานหนึ่งงาน และคีย์ที่เยื้องเข้ามาจะอธิบายงานนั้น

ค่าข้อความธรรมดามักไม่ต้องใส่เครื่องหมายคำพูด ให้เพิ่มเครื่องหมายคำพูดเฉพาะเมื่อค่ามีเครื่องหมายโคลอน วงเล็บปีกกา หรือเริ่มต้นด้วยอักขระพิเศษ

YAML อ่าน true, false และตัวเลขที่ไม่มีเครื่องหมายคำพูดเป็นค่าบูลีนและตัวเลข ไม่ใช่ข้อความ ดังนั้น yes และ 22 จึงเป็นค่าที่มีประเภท ไม่ใช่สตริง

ทุกอย่างหลัง # ในบรรทัดหนึ่งคือความคิดเห็น Ansible จะไม่สนใจส่วนนี้ คุณจึงใช้ความคิดเห็นเพื่ออธิบายว่างานแต่ละงานกำลังทำอะไร

คุณต้องเยื้องบรรทัดที่ซ้อนอยู่ในเพลย์บุ๊ก คุณควรใช้สิ่งใด

เครื่องมือทั้งหมดมีเพียงเท่านี้: การจับคู่ รายการ และการเยื้องด้วยช่องว่าง ทำความเข้าใจกฎไม่กี่ข้อนี้ แล้วเพลย์บุ๊กทุกไฟล์จะอ่านได้อย่างชัดเจน 🎉