‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

בדף הזה מוסבר איך לתזמן הפעלה של מחברת ב-Colab Enterprise.

סקירה כללית

אתם יכולים לתזמן מחברת כך שתופעל מיד פעם אחת, או לפי לו"ז חוזר.

כשמתזמנים את ההרצה של המחברת, בוחרים תבנית של זמן ריצה. ‫Colab Enterprise משתמש בתבנית זמן הריצה הזו כדי ליצור את זמן הריצה שבו מופעל ה-notebook.

לסביבת זמן הריצה נדרשות הרשאות ספציפיות כדי להריץ את הקוד של המחברת ולגשת לשירותים ולממשקי API. Google Cloud

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

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

אחרי ש-Colab Enterprise מסיים את ההרצה של קובץ ה-notebook, התוצאות מאוחסנות בקטגוריה של Cloud Storage שאפשר לשתף.

מגבלות

זמני הריצה של Colab Enterprise משתמשים במכסה של Compute Engine. מהן מכסות ההקצאה של Compute Engine?

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

נכנסים לחשבון 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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Agent Platform, Dataform, and Compute Engine APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

התפקידים שנדרשים כדי לתזמן את ההרצה של ה-notebook

כדי לקבל את ההרשאות שדרושות לתזמון הרצה של מחברת ב-Colab Enterprise, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

משתמש Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
אדמין באחסון (roles/storage.admin)

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

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

תפקיד אחד או יותר מהתפקידים הנדרשים כולל את ההרשאה dataform.repositories.list. משתמשים שקיבלו את ההרשאה dataform.repositories.list או את התפקיד Code Creator (roles/dataform.codeCreator) בפרויקט יכולים לראות את רשימת השמות של נכסי הקוד בפרויקט הזה באמצעות Dataform API או Dataform command-line interface (CLI). משתמשים שאינם אדמינים ב-BigQuery Studio יכולים לראות רק נכסי קוד שהם יצרו או ששותפו איתם.

התפקידים שנדרשים להפעלת ה-notebook

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

כדי לקבל את ההרשאות שדרושות להרצת מחברת ב-Colab Enterprise, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

Code Viewer (roles/dataform.codeViewer) במחברת
כתיבה ביומן (roles/logging.logWriter) בפרויקט
כותב מדדי מעקב (roles/monitoring.metricWriter) בפרויקט
‫Storage Legacy Bucket Writer (roles/storage.legacyBucketWriter) ב-notebook
קריאת אובייקטים באחסון מדור קודם (roles/storage.legacyObjectReader) בקטגוריית הפלט

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

התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות להרצת מחברת ב-Colab Enterprise. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי להריץ מחברת ב-Colab Enterprise, צריך את ההרשאות הבאות:

dataform.locations.list ב-Notebook
dataform.repositories.computeAccessTokenStatus ב-Notebook
dataform.repositories.fetchHistory ב-Notebook
dataform.repositories.fetchRemoteBranches ב-Notebook
dataform.repositories.get ב-Notebook
dataform.repositories.getIamPolicy ב-Notebook
dataform.repositories.list ב-Notebook
dataform.repositories.queryDirectoryContents ב-Notebook
dataform.repositories.readFile ב-Notebook
‫logging.logEntries.create בפרויקט
‫logging.logEntries.route בפרויקט
‫monitoring.metricDescriptors.create בפרויקט
‫monitoring.metricDescriptors.get בפרויקט
‫monitoring.metricDescriptors.list בפרויקט
‫monitoring.monitoredResourceDescriptors.get בפרויקט
‫monitoring.monitoredResourceDescriptors.list בפרויקט
‫monitoring.timeSeries.create בפרויקט
‫resourcemanager.projects.get בפרויקט
‫resourcemanager.projects.list בפרויקט
storage.buckets.get ב-Notebook
storage.managedFolders.create ב-Notebook
storage.managedFolders.delete ב-Notebook
storage.managedFolders.get ב-Notebook
storage.managedFolders.list ב-Notebook
storage.multipartUploads.abort ב-Notebook
storage.multipartUploads.create ב-Notebook
storage.multipartUploads.list ב-Notebook
storage.multipartUploads.listParts ב-Notebook
storage.objects.create ב-Notebook
storage.objects.delete ב-Notebook
storage.objects.get ב-Notebook
storage.objects.list ב-Notebook
storage.objects.restore ב-Notebook
storage.objects.setRetention ב-Notebook

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

שימוש בהרצות מתוזמנות של מחברות ברשת VPC משותפת

כדי להשתמש בהפעלות מתוזמנות של מחברות ברשת VPC משותפת, צריך להעניק הרשאות נוספות. איך משתמשים ב-Colab Enterprise ברשת VPC משותפת

הפעלה של מחברת פעם אחת

כדי להריץ מחברת פעם אחת, אפשר להשתמש במסוף Google Cloud , ב-Google Cloud CLI, בספריית הלקוח של Python של Agent Platform או ב-Terraform.

המסוף

נכנסים לדף My notebooks של Colab Enterprise במסוף Google Cloud .

לתיקיות שלי
בתפריט Region (אזור), בוחרים את האזור שבו נמצא ה-Notebook.
לצד מחברת, לוחצים על התפריט פעולות במחברת ובוחרים באפשרות תזמון.
בשדה שם לוח הזמנים, מזינים שם ללוח הזמנים.
לוחצים על הרשימה Runtime template (תבנית זמן ריצה) ובוחרים תבנית זמן ריצה. תבנית זמן הריצה קובעת את המפרטים של זמן הריצה שמפעיל את המחברת.
בקטע Run schedule (תזמון הרצה), בוחרים באפשרות One-off (חד-פעמי) כדי להריץ את ה-notebook מיד אחרי ששולחים את ההרצה.
לצד השדה Cloud Storage output location (מיקום הפלט ב-Cloud Storage), לוחצים על Browse (עיון) כדי לפתוח את תיבת הדו-שיח Select folder (בחירת תיקייה).
בוחרים קטגוריה של Cloud Storage. אפשר גם ללחוץ על Create new bucket (יצירת מאגר חדש) ולהשלים את תיבת הדו-שיח כדי ליצור מאגר.
אם בחרתם בתבנית של זמן ריצה בלי להפעיל את פרטי הכניסה של משתמש הקצה, בתיבת הדו-שיח יופיע השדה חשבון שירות. בשדה Service account, מזינים את כתובת האימייל של חשבון השירות.
לוחצים על שליחה.

הפעלת ה-notebook מתחילה באופן מיידי.

gcloud

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

‫DISPLAY_NAME: השם המוצג של הפעלת המחברת.
‫NOTEBOOK_RUNTIME_TEMPLATE: תבנית זמן הריצה של המחברת שמציינת את הגדרות המחשוב של זמן הריצה.
‫NOTEBOOK_URI: ה-URI של Cloud Storage של המחברת להפעלה.
‫OUTPUT_URI: המיקום ב-Cloud Storage שבו רוצים לאחסן את התוצאות.
‫USER_EMAIL: כתובת האימייל בחשבון המשתמש שמציינת את הגישה של הפעלת המחברת למשאבי Google Cloud .
PROJECT_ID: מזהה הפרויקט.
‫REGION: האזור שבו המחברת תפעל.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud colab executions create --display-name="DISPLAY_NAME" \
    --notebook-runtime-template=NOTEBOOK_RUNTIME_TEMPLATE \
    --gcs-notebook-uri=NOTEBOOK_URI \
    --gcs-output-uri=OUTPUT_URI \
    --user-email=USER_EMAIL \
    --project=PROJECT_ID \
    --region=REGION

‏Windows (PowerShell)

gcloud colab executions create --display-name="DISPLAY_NAME" `
    --notebook-runtime-template=NOTEBOOK_RUNTIME_TEMPLATE `
    --gcs-notebook-uri=NOTEBOOK_URI `
    --gcs-output-uri=OUTPUT_URI `
    --user-email=USER_EMAIL `
    --project=PROJECT_ID `
    --region=REGION

Windows‏ (cmd.exe)

gcloud colab executions create --display-name="DISPLAY_NAME" ^
    --notebook-runtime-template=NOTEBOOK_RUNTIME_TEMPLATE ^
    --gcs-notebook-uri=NOTEBOOK_URI ^
    --gcs-output-uri=