שדרוג הסביבה של מופע Agent Platform Workbench

מקרים לדוגמה של Gemini Enterprise Agent Platform Workbench הם מקרים לדוגמה של Deep Learning VM Images עם סביבות מחברת JupyterLab שמופעלות ומוכנות לשימוש. בדף הזה מוסבר איך לשדרג את הסביבה של מופע Agent Platform Workbench.

סיבות לשדרוג

יכול להיות שתרצו לשדרג את הסביבה של מופע Agent Platform Workbench מהסיבות הבאות:

  • כדי להשתמש ביכולות חדשות שזמינות רק בגרסה חדשה יותר של הסביבה.

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

שיטות שדרוג

יש שתי דרכים לשדרג מופע של Agent Platform Workbench:

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

  • שדרוג ידני: אם מופע קיים של Agent Platform Workbench עומד בדרישות לשדרוג, אפשר לשדרג את המופע באופן ידני.

דרישות ומגבלות

אין ערובה לתאימות לדורות קודמים עם Agent Platform Workbench. יוצרים עותק של הנתונים לפני שמשדרגים את המופע של Agent Platform Workbench.

כדי לבדוק אם אפשר לשדרג מופע ספציפי של Agent Platform Workbench, צריך לעיין בדרישות ובמגבלות הבאות:

  • צריך להפעיל את Notebooks API בפרויקטGoogle Cloud של המופע. מידע נוסף זמין במאמרים רשימת השירותים המופעלים והפעלת API.

  • אם מופע Agent Platform Workbench מבוסס על קונטיינר, מערכת Agent Platform Workbench משדרגת את מערכת ההפעלה. גרסת התמונה תלויה בתמונה הספציפית שנמשכת על ידי קובץ ה-Dockerfile.

    כדי לוודא שהשדרוג משתמש בגרסה העדכנית ביותר של התמונה, כדאי להשתמש בתג latest בקובץ Dockerfile.

אם שדרוג המופע לא מתאים לכם, כדאי להעביר את הנתונים למופע חדש של Agent Platform Workbench.

איך השדרוג פועל

מקרים של Agent Platform Workbench שאפשר לשדרג הם בעלי שני דיסקים, דיסק אתחול אחד ודיסק נתונים אחד. במהלך השדרוג, דיסק האתחול משודרג לאימג' חדש, והנתונים בדיסק הנתונים נשמרים.

אילו רכיבים משודרגים או נשמרים?

בטבלה הבאה אפשר לראות אילו רכיבים של מופע Agent Platform Workbench ישודרגו ואילו יישמרו.

רכיב שדרוג התוצאה
מסגרות ללמידת מכונה שודרג
נתונים של למידת מכונה משומר
יחסי תלות שהותקנו מראש שודרג
ספריות שהמשתמשים התקינו כברירת מחדל, צריך להתקין מחדש (ראו ספריות שהמשתמש התקין)
קבצים מקומיים בספרייה /home/jupyter משומר
קבצים מקומיים בכל ספרייה אחרת של /home/ לא נשמר
חבילות של מערכת הפעלה שהותקנו מראש שודרג
חבילות של מערכת הפעלה שהמשתמשים התקינו לא נשמר
מנהלי התקנים של GPU שודרג
קובצי Notebook משומר
הגדרות משתמש משומר

ספריות שהמשתמשים התקינו

כברירת מחדל, מופעים של Agent Platform Workbench מאחסנים ספריות של pip ו-Conda בדיסק האתחול, שמוחלף במהלך שדרוג. כשמתקינים ספריות של pip, אפשר לכלול את הדגל --user כדי להתקין אותן בספרייה /home/jupyter/, שבה הן נשמרות במהלך שדרוג.

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

גרסאות של סביבות

למופע של Agent Platform Workbench יש מספר גרסה של הסביבה שאפשר לאמת:

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. ברשימת המופעים, מוצאים את מספר הגרסה של סביבת המופע בעמודה Version (גרסה).

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

מידע על אופן השימוש בגרסה ספציפית כדי ליצור מופע של Agent Platform Workbench זמין במאמר יצירת גרסה ספציפית של מופע Agent Platform Workbench.

לפני שמתחילים

לפני שמשדרגים, צריך לבצע את השלבים הבאים.

  1. בהערות המוצר מוסבר על עדכונים לגרסאות חדשות יותר.

  2. יצירת עותק של הנתונים לצורך גיבוי.

שדרוג אוטומטי

ב-Agent Platform Workbench אפשר לשדרג באופן אוטומטי מופעים שפועלים. אם המופע שלכם מושבת, הוא לא ישודרג אוטומטית, גם אם הפעלתם שדרוג אוטומטי כשנוצר.

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

תקופת הזמן שאתם מציינים נשמרת כnotebook-upgrade-scheduleרשומה של מטא נתונים, בפורמט unix-cron, שעון גריניץ' (GMT).

כדי לבדוק אם אפשר לשדרג את המופע, Agent Platform Workbench משתמש בשיטת ה-API‏ checkUpgradability. בשיטה הזו מתבצעת בדיקה אם יש גרסה חדשה יותר של התמונה בדיסק האתחול של המופע.

אם אפשר לשדרג את המופע, Agent Platform Workbench משתמש בשיטת שדרוג פנימית כדי לשדרג את המופע.

יצירת מופע של Agent Platform Workbench עם שדרוג אוטומטי מופעל

כדי ליצור מופע של Agent Platform Workbench עם שדרוג אוטומטי מופעל, מסמנים את תיבת הסימון Enable environment auto-upgrade ומגדירים תזמון כשיוצרים את המופע.

אפשר לציין שדרוג אוטומטי באמצעות מסוף Google Cloud .

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. לוחצים על  יצירת פריט חדש.

  3. בתיבת הדו-שיח New instance, לוחצים על Advanced options.

  4. בתיבת הדו-שיח Create instance, בקטע Details, מציינים את הפרטים הבאים של המכונה החדשה:

  5. בקטע System health, בוחרים באפשרות Environment auto-upgrade.

  6. בוחרים אם לשדרג את הפנקס שבועי או חודשי.

  7. בשדה Weekday (יום חול), בוחרים את האפשרות הרצויה.

  8. בשדה שעה, בוחרים שעה ביום.

  9. משלימים את שאר השדות בתיבת הדו-שיח ליצירת מכונה, ואז לוחצים על יצירה.

עריכת לוח הזמנים לשדרוג אוטומטי

כדי לערוך את לוח הזמנים של השדרוג האוטומטי אחרי שיוצרים את המופע של Agent Platform Workbench, פועלים לפי השלבים הבאים:

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. לוחצים על שם המכונה שרוצים לשנות את התזמון שלה.

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

  4. לוחצים על שליחה כדי לשמור את השינויים.

שדרוג ידני

אתם יכולים לשדרג באופן ידני מופעים של Agent Platform Workbench שעומדים בדרישות.

בדיקה אם יש גרסה חדשה יותר של סביבת המופע

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

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

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

  3. בדף Instance details (פרטי המופע), ליד VM details (פרטי מכונת ה-VM), לוחצים על View in Compute Engine (הצגה ב-Compute Engine).

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

שדרוג הסביבה של המופע לגרסה חדשה יותר

אפשר לשדרג ידנית מופע של Agent Platform Workbench ב Google Cloud קונסולה.

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

  2. אם המכונה שלכם לא פועלת, מפעילים אותה. אפשר לשדרג מופעים ב-Agent Platform Workbench רק כשהם פועלים.

  3. לוחצים על שם המכונה שרוצים לשדרג.

  4. בדף פרטי המכונה, לוחצים על  שדרוג.

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

  6. אחרי גיבוי הנתונים, לוחצים על שדרוג. הפלטפורמה Agent Platform Workbench משדרגת את המופע ומפעילה אותו.

חזרה לגרסה קודמת אחרי שדרוג

כדי לבטל שדרוג, מבצעים את השלבים הבאים:

  1. נכנסים לדף Instances במסוף Google Cloud .

    כניסה לדף Instances

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

  3. בדף Instance details (פרטי המכונה), בקטע Upgrade history (היסטוריית השדרוגים), לוחצים על Rollback (חזרה לגרסה הקודמת).

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