דוגמה לשגיאת הזחה של YAML: רווח מנותק-באחד

דף זה פותח את ה-YAML validator שנטען מראש עם תצורת שרת קצרה המכילה טעות אמיתית ונפוצה: לאחר שני מפתחות מקוננים בעומק של ארבעה רווחים, מפתח הבא יורד בחזרה לשלושה רווחים במקום לחזור לרמת שני הרווחים של הבלוק המקיף. ל-YAML אין סובלנות טאבים מול רווחים ואין רוחב כניסות קבוע, כך שרווח תועה בודד כזה אינו ממוצע - הוא פשוט לא תואם לאף בלוק פתוח, והקובץ לא חוקי. הבדיקה הכושלת למטה פועלת בזמן שהדף נטען.

זוהי אחת הדרכים הנפוצות ביותר שבהן ניתוק YAML אמיתי בפועל: עריכה ידנית של קובץ בעורך שאינו אוכף גודל כניסה עקבי, או הדבקת קטע ממקום כלשהו עם מרווח שונה מהגוש שמסביב. שלא כמו מפתח משוכפל או לשונית תועה, קל לפספס קטע הזחה של אחד על ידי עין, במיוחד במניפסט מקונן עמוק של Kubernetes או קובץ CI pipeline - וזו בדיוק הסיבה שבדיקה אוטומטית תופסת אותו מהר יותר מאשר סוקר אנושי סורק הבדל.

החלף את הטקסט לדוגמה בקובץ משלך כדי לראות את אותו דיווח שורה ועמודה שהוחל על התצורה שלך. לאחר שתבינו את דפוס הכשל כאן, השווה אותו מול הקביעה המוגדרת מראש של yaml-config-example כדי לראות את אותו מבנה עם הזחה עקבית עובר בצורה נקייה.