הרצת בדיקות לפני ההטמעה

במסמך הזה מוסבר על בדיקות מקדימות שמופעלות כשיוצרים או משדרגים אשכול ב-Google Distributed Cloud (תוכנה בלבד) ל-VMware.

בדיקת הכללים של חומת האש

בגרסה 1.29 ואילך, בדיקות מקדימות בצד השרת מופעלות כברירת מחדל כשיוצרים, מעדכנים ומשדרגים אשכולות. בדיקות קדם-הפעלה בצד השרת דורשות כללי חומת אש נוספים. בקטע Firewall rules for admin clusters (כללי חומת אש לאשכולות אדמין), מחפשים את האפשרות Preflight checks (בדיקות לפני המראה) ומוודאים שכל כללי חומת האש הנדרשים מוגדרים.

הפעלה של gkectl check-config

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

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

לפני שיוצרים אשכולות באמצעות gkectl, מריצים את הפקודה gkectl check-config כדי לאמת את קובץ התצורה באמצעות כמה בדיקות קדם הפעלה. אם הפקודה מחזירה הודעות FAILURE, צריך לתקן את הבעיות ולאמת שוב את הקובץ. אם אימות של תכונה מסוימת מחזיר הודעות אזהרה, צריך לפתור את הבעיות הבסיסיות לפני שתוכלו להשתמש בתכונה הזו.

מצבי בדיקה לפני הפעלה ודילוג על אימותים

ל-gkectl check-config יש מצב ברירת מחדל ומצב מהיר:

• במצב ברירת המחדל, הפקודה מאמתת באופן מקיף כל שדה. בנוסף, במצב ברירת המחדל נוצרות מכונות וירטואליות (VM) זמניות של vSphere כחלק מהאימותים, ולכן התהליך עשוי להימשך זמן רב יותר.

• במצב מהיר, הפקודה מדלגת על בדיקות שיוצרות מכונות VM לבדיקה ומריצה רק את הבדיקות המהירות. כדי להפעיל את המצב המהיר, מעבירים את הדגל --fast.

אפשר לדלג על אימותים ספציפיים באמצעות העברת דגלים אחרים, שמתוארים במאמר gkectl check-config --help.

התנועה בין תחנת העבודה של האדמין לבין המכונות הווירטואליות של הבדיקה

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

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

בדיקת ה-preflight, שמופעלת בתחנת העבודה של האדמין, שולחת בקשות HTTP למכונות הווירטואליות לבדיקה באמצעות כתובות ה-IP השונות שהוקצו למכונות הווירטואליות. הבקשות נשלחות ליציאה 443 וליציאות הצמתים שציינתם בקובץ ההגדרות.

מתי כדאי להפעיל בדיקות קדם-הפעלה?

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

אם אתם משתמשים בגרסה 1.2.0-gke.6, מריצים את הפקודה gkectl check-config פעמיים:

1. מריצים את gkectl check-config --fast.

2. מריצים את gkectl prepare.

3. מריצים שוב את הפקודה gkectl check-config, בלי הסימון --fast.

הסיבה להרצה פעמיים היא ש-gkectl prepare מעלה את תבנית המכונה הווירטואלית של קובץ האימג' של מערכת ההפעלה של צומת האשכול לסביבת vSphere. צריך לוודא שתבנית המכונה הווירטואלית קיימת לפני שמריצים את כל מערך האימותים.

בגרסה 1.2.1 ואילך, הפקודה check-config מעלה את תבנית מכונת ה-VM, כך שאפשר להריץ את כל מערך האימותים לפני שמריצים את הפקודה gkectl prepare:

1. מריצים את הפקודה gkectl check-config בלי הסימון --fast.

2. מריצים את gkectl prepare.

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

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

שמירה של מכונת ה-VM לצורך ניפוי באגים

החל מגרסה 1.2.1, לפקודה gkectl check-config יש דגל --cleanup.

כש-gkectl check-config מבצע סדרה מלאה של בדיקות אימות, הוא יוצר מכונה וירטואלית לבדיקה ומפתח SSH שמשויך אליה. אם רוצים לשמור את המכונה הווירטואלית של הבדיקה ואת מפתח ה-SSH למטרות ניפוי באגים, צריך להגדיר את --cleanup כ-false.

ערך ברירת המחדל של --cleanup הוא True.

רשימת בדיקות לפני הפעלה

במהלך הבדיקות המקדימות, המערכת מאמתת כל שדה בקובץ ההגדרות. אלה הבדיקות הנוכחיות:

תוצאות של בדיקות קדם הפעלה

בדיקות קדם-הפעלה יכולות להחזיר את התוצאות הבאות:

בוצע בהצלחה

השדה והערך שלו עברו את הבדיקה.

שגיאה

השדה ו/או הערך שלו לא עברו את הבדיקה. אם הבדיקה מחזירה את ההודעה FAILURE, צריך לתקן את הבעיות ולאמת שוב את הקובץ.

לא בוצעה בדיקה

הבדיקה דולגה, כנראה כי היא לא רלוונטית להגדרה שלכם. לדוגמה, אם משתמשים בשרת DHCP, המערכת מדלגת על בדיקות של DNS ושל כתובות IP של צמתים – הבדיקות האלה רלוונטיות רק להגדרת כתובת IP סטטית.

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

לא ידוע

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

בקרוב

בגרסה עתידית נוסיף את הבדיקות המקדימות הבאות:

• שרת NTP

הרצת בדיקות לפני ההטמעה

כדי להריץ בדיקות לפני ההמראה, מריצים את הפקודה הבאה:

gkectl check-config --config [CONFIG]

‫[CONFIG] הוא הנתיב לקובץ התצורה

הפעלה במצב מהיר

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

gkectl check-config --config [CONFIG] --fast

דילוג על אימותים ספציפיים

אתם יכולים להעביר פריטי feature flag כדי לדלג באופן ספציפי על אימותים מסוימים, כמו DNS,‏ proxy ורשת. לכל דגל דילוג מתווספת הקידומת --skip-[VALIDATION].

כדי לקבל מידע על דגלי הדילוג הזמינים, מריצים את הפקודה הבאה:

gkectl check-config --help

לדוגמה, כדי לדלג על האימותים של מאזן העומסים:

gkectl check-config --config my-config.yaml --skip-validation-load-balancer 

ביטול בדיקות קדם-הפעלה

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

הסרת מכונת VM לצורך בדיקה

אם מכונה וירטואלית לבדיקה נשארת אחרי השלמת הבדיקות המקדימות, אפשר למחוק את המכונה הווירטואלית מ-vCenter. למכונה וירטואלית לבדיקה יש שם כזה:

check-config-[dhcp|static]-[random number]

כדי למחוק את המכונה הווירטואלית:

1. לוחצים לחיצה ימנית על המכונה הווירטואלית ואז על הפעלה > כיבוי.

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

דוגמה

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

- Validation Category: Config Check
    - [SUCCESS] Config

- Validation Category: Internet Access
    - [SUCCESS] Internet access to required domains

- Validation Category: GCP
    - [SUCCESS] GCP Service
    - [SUCCESS] GCP Service Account

- Validation Category: Docker Registry
    - [SUCCESS] gcr.io/gke-on-prem-release access

- Validation Category: vCenter
    - [SUCCESS] Credentials
    - [SUCCESS] Version
    - [SUCCESS] Datacenter
    - [SUCCESS] Datastore
    - [SUCCESS] Data Disk
    - [SUCCESS] Resource Pool
    - [SUCCESS] Network
    - [SUCCESS] VSphere CSI Driver

- Validation Category: F5 BIG-IP
    - [SUCCESS] Admin Cluster F5 (credentials, partition and user role)
    - [SUCCESS] User Cluster F5 (credentials, partition and user role)

- Validation Category: Network Configuration
    - [SUCCESS] CIDR, VIP and static IP (availability and overlapping)

- Validation Category: DNS
    - [SUCCESS] DNS (availability)

- Validation Category: VIPs
    - [SUCCESS] ping (availability)

- Validation Category: Node IPs
    - [SUCCESS] ping (availability)

Now running slow validation checks. ...

Reusing VM template "gke-on-prem-osimage-xxx" that already exists in vSphere.
Creating test VMs with admin cluster configuration...  DONE
Waiting to get IP addresses from test VMs...  DONE
Waiting for test VMs to become ready...  DONE

Reusing VM template "gke-on-prem-osimage-xxx" that already exists in vSphere.
Creating test VMs with user cluster configuration...  DONE
Waiting to get IP addresses from test VMs...  DONE
Waiting for test VMs to become ready...  DONE

- Validation Category: F5 BIG-IP
    - [SUCCESS] Admin Cluster VIP and NodeIP
    - [SUCCESS] Admin Cluster F5 Access
    - [SUCCESS] User Cluster VIP and NodeIP
    - [SUCCESS] User Cluster F5 Access

- Validation Category: Internet Access
    - [SUCCESS] Internet access to required domains

- Validation Category: vCenter on test VMs
    - [SUCCESS] Test VM: VCenter Access and Permission

- Validation Category: DNS on test VMs
    - [SUCCESS] Test VM: DNS Availability

- Validation Category: TOD on test VMs
    - [SUCCESS] Test VM: TOD Availability

- Validation Category: Docker Registry
    - [SUCCESS] gcr.io/gke-on-prem-release access

Deleting test VMs with admin cluster configuration...  DONE
Deleting test VMs with user cluster configuration...  DONE

בעיות מוכרות

• לגרסה 1.3.0-gke.16:

  אם שני התנאים הבאים מתקיימים, אתם צריכים להריץ בדיקות אימות מהירות, gkectl check-config --fast, לבדיקות המקדימות שלכם:

  1. הגדרתם את Google Distributed Cloud לשימוש ב-Proxy.

  2. התקנתם אחת מהחבילות הבאות:

     • ה/var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgz חבילה מדף ההורדות.
     • /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16.tgz החבילה מתחנת העבודה של האדמין.

  אפשר להריץ את כל תהליך האימות רק אם התקנתם את החבילה המלאה. לדוגמה: /var/lib/gke/bundles/gke-onprem-vsphere-1.3.0-gke.16-full.tgz

• בגרסה 1.2.0-gke.6:

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

  gkectl check-config --config [CONFIG] --fast

המאמרים הבאים

• יצירת אשכול אדמין
• יצירת אשכול משתמשים