
#, וכתובה מעל המשימה שאליה היא מתייחסת.הטקסט המלא של הדקות הראשונות בהרצאה «הערות בקובץ YML» בקורס הווידאו של PracticU – כתוביות בעברית עם זמן התחלה לכל פסקה. כך תוכלו לקרוא ולחפש את הנושאים לפני שמתחילים ללמוד.
עכשיו שכבר התחלתם לכתוב סקריפטים, יאמל אנסיבל, יאמל פיילס, עם פייל והקופי מוד'ולס, כבר ממש יש לכם איזשהו סקריפט שממש עושה משהו, יוצר תיקייה, מעתיק אליה קבצים וכן הלאה.
חשוב מאוד שמעכשיו תתחילו ליישם הוספה של נוטס, של הערות, בתוך הסקריפט שלכם. כמו שאתם יכולים לראות בתמונה, תראו איזה יופי זה נראה כשיש לי מידע מעל הטאסק, ממש מעל הטאסק, אני כותב מה בדיוק אני עומד לעשות בטאסק הזה, ואפילו למה. למה זה חשוב מאוד? יש כמה סיבות. סיבה מספר אחת,
אנחנו ברוב המקרים לא זוכרים למה הכנסנו טאסק כזה או אחר בסקריפט שלנו, במיוחד אם אתם חוזרים לסקריפט שלכם אחרי מספר שבועות או חודשים.
מי מכם שיצר כבר סקריפטים כמובן מקבל את מה שאני אומר, ואני בטוח שקרה גם לכם. מי מכם שעוד לא כתב סקריפטים, תאמינו לי, אחרי שבועיים שלוש שיצרתם סקריפט ארוך, אתם לא תמיד זוכרים את כל הסיבות לכל הפקודות שהכנסתם.
כמה שזה לא היה גאוני באותו יום, אחרי חודשיים אתם לא זוכרים למה עשיתם משהו מסוים. למרות שזה עובד נפלא. אז עבורכם אתם חייבים שיהיה לכם no-צערות בתוך הסקריפט, כדי שמאוחר יותר, כשתיגשו לסקריפט שלכם, אתם תבינו למה עשיתם מה שעשיתם, למה הפקודה הזו נמצאת פה וכן הלאה וכן הלאה. מאוד מאוד חשוב.
סיבה מספר אחרת, למה אתם רוצים שיהיו לכם הערות, ושימו לב את ההערה, אנחנו כותבים על ידי זה שבהתחלה אנחנו שמים סולמית. ממש כמו כל סקריפט אחר, דרך אגב, זה לא משהו מיוחד פה.
אז הסיבה השנייה זה שכשאנחנו כותבים אוטומיישן, זה לא תמיד רק בשבילנו. אנחנו יוצרים איזשהו סקריפט אוטומיישן בארגון שמבצע פעולה, למשל, מתקין פאצ'ים, פאצ'ס, על לינוקס סרוורס, על כל הווב סרוורס, כל יום שישי או שבת בלילה.
והסקריפט הזה עושה כל מיני פעולות, ומישהו אחר יכול מאוד להיות שהוא צריך להריץ את הסקריפט, או מישהו אחר משתמש בסקריפט הזה, וכשהוא יפתח את הסקריפט כדי להבין מה אומר הסקריפט, אנחנו רוצים לעזור לו להבין מה קורה שם, במיוחד כשרוצים לשנות ולהוסיף דברים לסקריפט הזה.
בקיצור יש חשיבות עליונה כמה שזה נשמע טריוויאלי אבל יש חשיבות עליונה להוסיף הערות שוליים בתוך הסקריפט שלכם. עכשיו אתם אולי שואלים למה אני צריך לרשום הערות אם יש לי פה את ה-Name של ה-Task למה אני צריך לרשום הערות חברים ה-Name הזה זה מה שיופיע על המסך כשה-Ansible יתחיל לרוץ אנחנו לא יכולים לרשום שם סיפור
ארוך כן חשוב להגיד מה זה ה-Task הזה