ביצוע תחזוקה בשירות עצמי

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

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

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

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

בדיקת גרסאות התחזוקה הזמינות

במכונות של Managed Lustre, גרסאות התחזוקה מנוהלות באמצעות השדות הבאים:

  • ‫effectiveVersion: פלט בלבד. גרסת התוכנה שפועלת במכונה. לדוגמה, Lustre_20260516.00_p00.
  • ‫availableVersion: פלט בלבד. גרסת תוכנה חדשה יותר שעומדת בדרישות, שאפשר לשדרג אליה את המכונה. אם השדה הזה ריק, המכונה כבר מריצה את הגרסה העדכנית ביותר.
  • ‫targetVersion: קלט בלבד. הפרמטר שצוין בבקשת עדכון כדי להתחיל שדרוג לגרסה מועמדת או ל-latest.

כדי לאמת את הגרסה הנוכחית של המכונה ולבדוק אם יש שדרוג זמין:

מסוף Google Cloud

  1. במסוף Google Cloud , נכנסים לדף Managed Lustre:

    כניסה ל-Managed Lustre

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

  3. לוחצים על שם המכונה כדי לפתוח את הדף Instance details ולראות את מחרוזת הגרסה הזמינה.

‫CLI של gcloud

מריצים את הפקודה gcloud lustre instances describe עם מסנן פורמט:

gcloud lustre instances describe INSTANCE_ID \
  --location=LOCATION \
  --format="yaml(effectiveVersion, availableVersion, state)"

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

  • ‫INSTANCE_ID: המזהה של המכונה ב-Managed Lustre.
  • ‫LOCATION: האזור שבו נמצאת המכונה.

אם יש גרסה חדשה יותר, הפלט נראה כך:

availableVersion: Lustre_20260716.01_p00
effectiveVersion: Lustre_20260516.00_p00
state: ACTIVE

אם availableVersion ריק, במכונה כבר פועלת הגרסה העדכנית ביותר.

REST

כדי לבדוק את פרטי הגרסה של מכונה, שולחים בקשת GET לנקודת הקצה של המכונה:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID
Authorization: Bearer ACCESS_TOKEN

כאשר:

  • ‫PROJECT_ID הוא מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION הוא האזור שבו נמצא המכונה.
  • ‫INSTANCE_ID הוא המזהה של המכונה ב-Managed Lustre.

אם יש גרסה חדשה יותר, התשובה מכילה את effectiveVersion ואת availableVersion:

{
  "name": "projects/my-project/locations/us-central1-a/instances/my-instance",
  "state": "ACTIVE",
  "effectiveVersion": "Lustre_20260516.00_p00",
  "availableVersion": "Lustre_20260716.01_p00"
}

אם availableVersion מושמט או ריק, המכונה כבר מריצה את הגרסה האחרונה שזמינה.

לפרטים נוספים, עיינו במאמרי העזרה של ה-API של instances.get.

ביצוע שדרוג בשירות עצמי

כדי לשדרג את המכונה לגרסת תוכנה זמינה:

‫CLI של gcloud

מריצים את הפקודה gcloud lustre instances update עם הדגל --target-version:

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=latest

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

  • ‫INSTANCE_ID: המזהה של המכונה ב-Managed Lustre.
  • ‫LOCATION: האזור שבו נמצאת המכונה.

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

gcloud lustre instances update INSTANCE_ID \
  --location=LOCATION \
  --target-version=TARGET_VERSION

מחליפים את TARGET_VERSION במחרוזת הגרסה מ-availableVersion. לדוגמה, Lustre_20260716.01_p00.

REST

כדי לשדרג מכונה באמצעות ה-API בארכיטקטורת REST, שולחים בקשת PATCH לנקודת הקצה של המכונה, ומציינים את targetVersion בפרמטר השאילתה updateMask:

PATCH https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID?updateMask=targetVersion
Authorization: Bearer ACCESS_TOKEN

{
  "targetVersion": "latest"
}

כאשר:

  • ‫PROJECT_ID הוא מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION הוא האזור שבו נמצא המכונה.
  • ‫INSTANCE_ID הוא המזהה של המכונה ב-Managed Lustre.

כדי לשדרג לגרסת הפצה ספציפית שעומדת בדרישות במקום ל-latest, צריך לציין את מחרוזת הגרסה בגוף הבקשה, למשל "targetVersion": "Lustre_20260716.01_p00".

לפרטים נוספים, עיינו במאמרי העזרה של ה-API של instances.patch.

מעקב אחרי התקדמות התחזוקה

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

כדי לעקוב אחרי ההתקדמות בזמן אמת:

‫CLI של gcloud

מבצעים סקר של סטטוס הפעולה באמצעות הפקודה gcloud lustre operations describe:

gcloud lustre operations describe OPERATION_ID \
  --location=LOCATION

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

  • ‫OPERATION_ID: מזהה הפעולה שמוחזר על ידי פקודת העדכון.
  • ‫LOCATION: האזור שבו נמצאת המכונה.

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

REST

שולחים בקשת GET לנקודת הקצה (endpoint) של operations.get:

GET https://lustre.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID
Authorization: Bearer ACCESS_TOKEN

כאשר:

  • ‫PROJECT_ID הוא מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION הוא האזור שבו נמצא המכונה.
  • ‫OPERATION_ID הוא מזהה הפעולה שהתקבל מבקשת העדכון.

לפרטים נוספים, עיינו במאמרי העזרה של ה-API של operations.get.

אם השדרוג הושלם:

  1. המכונה חוזרת למצב ACTIVE.
  2. ‫effectiveVersion משקף את מחרוזת הגרסה החדשה שהוחלה.
  3. השדה availableVersion נמחק ומושמט מהתגובות מה-API.

אינטראקציה עם פעולת תחזוקה שנקבעה מראש

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

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

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

הודעות שגיאה

אלה כמה מהשגיאות האפשריות בתחזוקה בשירות עצמי:

  • ‫Instance is already running version "<CURRENT>": השגיאה הזו מתרחשת אם מנסים לשדרג לגרסת התוכנה שכבר פועלת במכונה.
  • ‫Downgrading to a lower version is not supported.: קורה כשמנסים לשדרג לאחור לגרסת תוכנה קודמת.
  • ‫Version "<TARGET>" is not a valid update version.: השגיאה הזו מתרחשת אם הגרסה שצוינה לא תואמת למחרוזת availableVersion או ל-latest של המכונה.
  • ‫Instance must be in ACTIVE state to update version: מתרחשת אם מתחילים שדרוג כשהמכונה לא במצב ACTIVE.
  • ‫Cannot trigger self-service update within 1 hour of a scheduled maintenance window: קורה אם שדרוג בשירות עצמי מתחיל פחות משעה לפני חלון זמן מתוכנן לתחזוקה.