תזמון הרצה של Notebook

תזמון הרצה של Notebook

במאמר הזה נסביר איך להשתמש ב-Gemini Enterprise Agent Platform Workbench executor כדי להריץ קובץ מחברת Python לפי לוח זמנים שעתי.

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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Gemini Enterprise Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Gemini Enterprise Agent Platform APIs, if any are not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the APIs

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות ליצירת מופע של Agent Platform Workbench ולפתיחת JupyterLab, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

• אדמין ב-Notebooks (roles/notebooks.admin)
• משתמש בחשבון שירות (roles/iam.serviceAccountUser)

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

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

יצירת מופע וקובץ notebook לדוגמה

1. יצירת מופע.

   הערה: אם בוחרים ב-JupyterLab 4 כגרסת JupyterLab עבור המכונה, המכונה משתמשת במתזמן של Gemini Enterprise Agent Platform כדי לתזמן את ההרצות של מחברת ה-notebook.

2. לוחצים על Open JupyterLab.

3. פותחים קובץ חדש של Notebook.

4. בתא הראשון של קובץ המחברת, מזינים את הטקסט הבא:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

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

מתן הרשאות לחשבון השירות של המופע

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

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

• בעל הרשאת הרצה של מסמכי notebook (roles/notebooks.runner)
• אדמין באחסון (roles/storage.admin)

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

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

מגבלות

חשוב לשים לב להגבלה הבאה כשמתזמנים הפעלה של מחברת במכונת JupyterLab 4:

• כשמתזמנים הפעלה של notebook ב-JupyterLab 4, ‏ Agent Platform Workbench מאחסן עותק של ה-notebook במצבו הנוכחי ב-Cloud Storage, ואז מפעיל את העותק הזה של ה-notebook בהתאם ללוח הזמנים. אם עורכים את המחברת המקורית, צריך ליצור תזמון חדש כדי להריץ את הגרסה המעודכנת של המחברת.

תזמון הרצה

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

   כניסה לדף Instances

2. לצד שם המכונה, לוחצים על Open JupyterLab.

   מופע של Agent Platform Workbench ייפתח ב-JupyterLab.

3. ב סייר הקבצים, לוחצים לחיצה כפולה על קובץ ה-notebook לדוגמה כדי לפתוח אותו.

4. לוחצים על הלחצן  Execute.

5. בתיבת הדו-שיח Submit notebooks to Executor (שליחת מחברות ל-Executor), בשדה Type (סוג), בוחרים באפשרות Schedule-based recurring executions (הפעלות חוזרות על בסיס תזמון).

   כברירת מחדל, קובץ המחברת מופעל על ידי המפעיל כל שעה בדקה 00 של השעה.

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

7. לוחצים על שליחה.

   קובץ ה-notebook יופעל באופן אוטומטי לפי לוח הזמנים שהגדרתם.

הערה: אם המופע מושבת, קובץ ה-Notebook עדיין יפעל לפי לוח הזמנים.

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

הצגה, שיתוף וייבוא של קובץ notebook שהופעל

באמצעות ממשק JupyterLab של המופע, אתם יכולים לראות את הפלט של הנוטבוק, לשתף את התוצאות עם אחרים ולייבא את קובץ הנוטבוק שהופעל אל JupyterLab.

הערה: כדי להשתמש במסוף Google Cloud כדי לראות ולשתף תוצאות של הפעלה, בדף Executions לוחצים על View result.

צפייה בתוצאות ההרצה

1. בתפריט הניווט של JupyterLab, לוחצים על הלחצן  Notebook Executor.

2. לוחצים על הכרטיסייה הפעלות.

3. בקטע של ההרצה שרוצים לראות, לוחצים על הצגת התוצאה.

   התוצאה תיפתח בכרטיסייה חדשה בדפדפן.

שיתוף תוצאות ההרצה

1. בממשק המשתמש של JupyterLab של המופע, בתפריט הניווט, לוחצים על הלחצן  Notebook Executor.

2. לוחצים על הכרטיסייה הפעלות.

3. לצד ההרצה שרוצים לשתף, לוחצים על  תפריט האפשרויות, ובוחרים באפשרות שיתוף תוצאת ההרצה.

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

ייבוא ה-notebook שהופעל אל JupyterLab

1. בממשק המשתמש של JupyterLab של המופע, בתפריט הניווט, לוחצים על הלחצן  Notebook Executor.

2. לוחצים על הכרטיסייה הפעלות.

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

4. אם מופיעה תיבת הדו-שיח Select Kernel, בוחרים את הגרעין שרוצים לפתוח את המחברת.

   הקובץ של ה-notebook שבוצעה בו הפעלה ייפתח ב-JupyterLab, ויישמר בדפדפן הקבצים של JupyterLab בתיקייה בשם imported_notebook_jobs.

הצגה או מחיקה של לוח זמנים

אפשר לראות ולמחוק לוחות זמנים באמצעות מסוף Google Cloud או ממשק המשתמש של JupyterLab במופע.

הצגת לוח זמנים

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

המסוף

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

   מעבר ללוחות זמנים

2. לוחצים על השם של הפעולה המתוזמנת שרוצים להציג.

   בדף פרטי התזמון אפשר לראות את חמש ההרצות האחרונות של התזמון.

3. לצד שם ההרצה, לוחצים על הצגת התוצאה כדי לפתוח את קובץ ה-Notebook שהופעל.

   התוצאה תיפתח בכרטיסייה חדשה בדפדפן.

JupyterLab

1. בממשק המשתמש של JupyterLab של המופע, בתפריט הניווט, לוחצים על הלחצן  Notebook Executor.

2. לוחצים על הכרטיסייה לוחות זמנים.

3. בקטע 'הפעלה' שרוצים להציג, לוחצים על הצגת התוצאה האחרונה של ההפעלה.

   התוצאה תיפתח בכרטיסייה חדשה בדפדפן.

מחיקת לוח זמנים

מחיקת לוח זמנים לא תגרום למחיקת ההרצות שנוצרו ממנו.

המסוף

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

   מעבר ללוחות זמנים

2. בוחרים את לוח הזמנים שרוצים למחוק.

3. לוחצים על  מחיקה.

JupyterLab

1. בממשק המשתמש של JupyterLab של המופע, בתפריט הניווט, לוחצים על הלחצן  Notebook Executor.

2. לוחצים על הכרטיסייה לוחות זמנים.

3. לוחצים על שם התזמון. ייפתח הדף Schedule details של התזמון במסוף Google Cloud .

4. לוחצים על  מחיקה.

הסרת המשאבים

כדי לא לצבור חיובים לחשבון Google Cloud על המשאבים שבהם השתמשתם בדף הזה, פועלים לפי השלבים הבאים:

מחיקת המכונה

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

   כניסה לדף Instances

2. בוחרים את המופע שרוצים למחוק.

3. לוחצים על  מחיקה.

מחיקת הפרויקט

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

זהירות: כשמוחקים פרויקט:

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

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

1. במסוף Google Cloud , נכנסים לדף Manage resources.

   כניסה לדף Manage resources

2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

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

כדי לראות דוגמה לתזמון של הרצת notebook כחלק מתהליך עבודה מקיף יותר, מריצים את ה-notebook Train a multi-class classification model for ads-targeting (אימון מודל סיווג מרובה מחלקות לטירגוט מודעות) באחת מהסביבות הבאות:

פתיחה ב-Colab | פתיחה ב-Colab Enterprise | פתיחה ב-Agent Platform Workbench | הצגה ב-GitHub