עשרים קובצי VPN בתיקייה אינם עשרים חיבורים
ייבוא של תיקייה יוצר פרופילים שמורים, לא הגדרה עובדת. ייבאו קובץ אחד, בדקו אותו, החזיקו מניפסט והפעילו רק את מה שהתכוונתם.
עשרים פרופילים בתיקייה נראים כמו התקדמות, וייבוא שלהם דורש פקודה אחת. מה שמקבלים אחר כך הוא עשרים חיבורים שמורים עם שמות דומים, בלי תיעוד איזה קובץ יצר איזה, ובלי הוכחה שאחד מהם עובד. הייבוא מעולם לא היה החלק הקשה. החלק הקשה הוא המלאי.
תיקייה היא קלט, לא תצורה
הקבצים בתיקייה הזו יכולים להיות יציאות חלופיות, סביבות לקוח נפרדות או שלוש גרסאות של פרופיל אחד ששום דבר בשם הקובץ לא מבדיל ביניהן. הם יצאו ממערכת אספקה, מה שהופך אותם לקלט של תהליך ולא לתהליך עצמו. ייבוא של כולם יוצר אובייקטים שמורים, ושמירת אובייקט אינה זהה להסכמה להשתמש בו. התייחסו לתיקייה כאל חומר גלם: מקור מאומת, תת-קבוצה נבחרת, תוצאה מתועדת. הפלט שאתם רוצים הוא מלאי קצר שנבדק, לא תפריט חיבורים ארוך יותר.
תנו שם לבעל תיקיית המקור לפני שאתם מייבאים משהו. תיקייה שאין לה בעלים היא תיקייה שאיש אינו יכול לאשר.
ייבאו קובץ אחד ובדקו אותו
ייבאו קובץ מאושר אחד, ואז קראו מה הוא יצר. בדקו את ה-UUID, את נקודת הקצה, את שיטת האימות, את הפניות הקבצים ואת כל הגדרות המסלול או ה-DNS, ועשו זאת בלי להדביק סודות בדוח משותף. פרופיל שמפנה לקבצי תעודה חיצוניים ממשיך להפנות לנתיבים, ולכן חומר התמיכה חייב להישאר במקום שבו הפרופיל מצפה לו. ייבוא אינו גם בדיקת תחביר לקריאה בלבד; הוא כותב חיבור מתמשך כברירת מחדל, ורק דגל זמני מפורש משנה זאת.
לאחר מכן הפעילו את החיבור הזה דרך זרימת האישורים הרגילה וראו אם השער מקבל אותו. ייבוא מוצלח מוכיח שהמנתח הבין את הקובץ, וזו טענה קטנה בהרבה ממנהרה עובדת.
החזיקו מניפסט, לא זיכרון
רשמו את קובץ המקור, את מטרתו, את ה-UUID שנוצר ואם הסקירה עברה. ארבעה שדות בכל שורה, שמתעדכנים תוך כדי עבודה ולא נבנים מחדש אחר כך. בלי הטבלה הזו, שבעה ייבואים מוצלחים וכשל אחד הופכים לצהריים של ניחושים.
הרחיקו נתיבי מקור מהמסמך המשותף אם הם חושפים מבנה פנימי. תווית מספיקה למניפסט.
הרצות חוזרות וכפילויות
אצווה חלקית היא המקרה הרגיל, כי קובץ אחד מעשרים ייכשל. התאימו את ה-UUIDים שכבר יש לכם לפני ניסיון חוזר כלשהו, ולעולם אל תנסו שוב את כל התיקייה כהתחלה חדשה.
ייבוא שני של אותו קובץ אינו עדכון; הוא יוצר אובייקט שמור נוסף, לעתים קרובות עם שם שנראה זהה ברשימה. השוו את המלאי לפני ואחרי אצווה, וסקרו רק את התוספות המיועדות. הסירו כפילות דרך המנהל שמחזיק בה, לאחר שאימתתם איזה UUID נמצא בשימוש. השאירו פרופילי Wi-Fi ו-Ethernet לא קשורים בשקט בזמן שאתם עושים זאת, כי ניקוי גורפי הוא הדרך שבה חיבורים עובדים נעלמים.
הפעלה היא החלטה נפרדת
לולאת ייבוא לא צריכה להסתיים בחיבור ללא תנאי. עשרים פרופילים שמורים הם ספרייה; עשרים מנהרות בו-זמנית הן תקרית ניתוב עם בעיות DNS מצורפות. החליטו אילו מהם רשאים להיות פעילים, ובאילו תנאים, לפני שהאצווה רצה.
שימו לב למדיניות ההפעלה האוטומטית במכונה, כי היא יכולה להפעיל פרופילים חדשים בלי שאיש יבקש. פרסמו רשימה קצרה של האפשרויות הנתמכות וציינו מי הבעלים של החלפות עתידיות, מכיוון שהייצוא מהמקור, הפרופיל השמור והאישור המרוחק כולם פגים בלוחות זמנים שונים. כשמיפוי זה מתוחזק, חידוש הוא חיפוש ולא חקירה.