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

מה קורא חייב לענות לפני שהוא נוגע בעמית

כיווץ גורם לכתובות להיראות מסודרות, וסדר אינו מבנה. מבנה הוא לדעת איזה טווח הספק האציל, איזה בחרת, איזה הוא מאגר לקוחות ואיזה יושב מאחורי אתר.

כתוב עבור העמית שיצטרף ברבעון הבא ויצטרך להוסיף אתר שני. שום דבר בעמוד לא אומר לו מאין הגיעה קידומת אלא אם הרשומה עושה זאת. דלג על זה והשינוי הראשון יהפוך לארכיאולוגיה.

מה כל שורה בתוכנית חייבת לשאת

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

שמור תפקידים בשורות נפרדות גם כששניים מהם חולקים קידומת היום. מיזוגם הופך פיצול מאוחר למשהו שנקרא כמו הקצאה חדשה ולא כמו תיקון.

EntryFields to recordWhy a reviewer needs it
Endpoint addressesPrefix, owning side, session initiatorFirewall rules and peer config both read it
Tunnel interfacesPrefix and length, next hop, interface nameShows the path a packet actually takes
Client allocationsPool range, size, distributing componentShows room left before a redesign
Downstream networksPrefix, site label, return routeExplains a reply that never arrives

היכן טקסט קנוני ותחביר תצורה נפרדים

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

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

שני סימונים בסדר כל עוד כל אחד מסומן. ערבוב לא מסומן הוא מה שמזמין את הטעות.

היכן טווחים חופפים ונתיבי חזרה חסרים צצים

חפיפה שורדת טעויות אחרות כי שום דבר לא נראה שגוי עד ששני אתרים עונים על אותו טווח. סמן את האתר וייצר קידומות ייחודיות-מקומיות לפי הנוהל המתועד במקום להעתיק דוגמה.

רשימת לקוחות אף פעם לא מסבירה לאיזה כיוון התשובה נוסעת. רשום את נתיב החזרה של שער ה-LAN לצד טווח העמיתים שהמנהרה נושאת, והרשומה מסבירה תת-רשת מרוחקת שמקבלת בקשות ונשארת שקטה. הרץ את הבדיקות שלמטה על המכונה והשווה אותן לרשומה. תוכנית שסותרת את ip -6 route היא תוכנית שאנשים מפסיקים לקרוא.

ip -6 route show default
ip -6 route get 2001:db8:2::10
ip -6 addr show dev wg0

נגישות אינה הרשאה, וקידומת אף פעם לא מרמזת על מדיניות. כתוב את הגישה המיועדת לצד הנתיב שהיא חלה עליו. אחרת הקורא הבא מתייחס לכתובת בתוכנית כאל רשות להגיע לכל שירות מאחוריה.

איך התוכנית שורדת את האתר השלישי

סמן כל קידומת כמואצלת, מוקצית מקומית או מנותבת בדרך אחרת. לכל דבר שיכול לזוז, שם את התהליך שמזיז אותו. לאחר מכן רשום את רשומות ה-DNS ואת כללי חומת האש שחייבים להשתנות באותו חלון, כי עדכון קידומת שנעצר בנתב הוא חצי עבודה.

אחרי שינוי, הגע למשאב מאחורי כל גבול שהשינוי נגע בו לפני שאתה עורך את המסמך. תוכנית שמתארת את הרשת של החודש שעבר גרועה מכלום, כי אנשים סומכים עליה. השאר הקצאות שנמשכו רשומות עם התאריך שבו נעלמו כדי שאיש לא יוציא אותן שוב בטעות. סודות נשארים מחוץ לקובץ; תוכנית מסבירה את הרשת, היא לא פותחת אותה.

אחסן את התוכנית במקום שבו שינויים נבדקים, לצד התצורה שהיא מתארת. מסמך שאיש לא קורא שוב נרקב מהר יותר מהרשת שהוא ממפה.

מאמרים קשורים