בדף הזה מוסבר איך ליצור תבנית של סביבת זמן ריצה ב-Colab Enterprise.
כדי להריץ קוד ב-notebook, משתמשים במשאב מחשוב שנקרא סביבת זמן ריצה. אתם יכולים להשתמש בסביבת זמן הריצה שמוגדרת כברירת מחדל או בסביבת זמן ריצה שנוצרה מתבנית. כשיוצרים תבנית של סביבת זמן ריצה, אפשר להגדיר את התבנית כך שתשפר את הביצועים, העלות ומאפיינים אחרים של סביבת זמן הריצה בהתאם לצרכים שלכם.
מידע נוסף על סביבות זמן ריצה ותבניות של סביבות זמן ריצה
לפני שמתחילים
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
Enable the Agent Platform, Dataform, and Compute Engine APIs, if any are not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות ליצירת תבנית של סביבת זמן ריצה ב-Colab Enterprise, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין ב-Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) ב-IAM בפרויקט.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
יצירת תבנית זמן הריצה
כדי ליצור תבנית של סביבת זמן ריצה, אתם יכולים להשתמש במסוף Google Cloud , ב-Google Cloud CLI, ב-API בארכיטקטורת REST או ב-Terraform.
המסוף
כדי ליצור תבנית של זמן ריצה:
-
במסוף Google Cloud , נכנסים לדף Runtime templates ב-Colab Enterprise.
-
לוחצים על New template.
מופיעה תיבת הדו-שיח Create new runtime template.
מידע בסיסי על סביבת זמן הריצה
-
בקטע Runtime basics, מזינים השם המוצג.
-
בתפריט Region, בוחרים את האזור שבו רוצים ליצור את תבנית זמן הריצה.
-
אופציונלי: מוסיפים תיאור לתבנית של זמן הריצה.
-
אופציונלי: כדי להוסיף תווית, לוחצים על Add label ומזינים צמד של Key ו-Value. כדי להוסיף עוד תוויות, חוזרים על השלב הזה.
-
לוחצים על Continue.
הגדרת המחשוב
-
בקטע Configure compute, בתפריט Machine type, בוחרים סוג מכונה. למידע על סוגי מכונות, קראו את המדריך להשוואה בין משפחות מכונות ומקורות מידע.
אם בוחרים סוג מכונה עם GPUs, בוחרים את Accelerator type ואת Accelerator count. אם אתם לא מצליחים לבחור את מספר ה-GPU שאתם רוצים, יכול להיות שתצטרכו להגדיל את המכסה. איך שולחים בקשה לשינוי המכסות
-
בתפריט Data disk type, בוחרים סוג דיסק.
-
בשדה Data disk size, מזינים גודל ב-GB.
-
בקטע כיבוי במצב חוסר פעילות:
-
כדי להשבית את הכיבוי במצב חוסר פעילות, מבטלים את הסימון של Enable idle shutdown.
-
כדי לשנות את משך הזמן ללא פעילות, בשדה Time of inactivity before shutdown (Minutes), משנים את המספר למספר הדקות הרצוי ללא פעילות. במסוף Google Cloud , אפשר להגדיר את ההגדרה הזו לכל ערך של מספר שלם בין 10 ל-1,440.
-
-
לוחצים על Continue.
סביבה
-
בקטע Environment, בוחרים באפשרות Environment. ברירת המחדל היא Latest (כרגע Python 3.13).
-
אופציונלי: בשדה Post-startup script, מזינים את ה-URI של סקריפט לטעינה אחרי ההפעלה. מידע נוסף על שימוש בסקריפט לאחר סקריפט לטעינה בזמן ההפעלה זמין במאמר שימוש בסקריפט לאחר סקריפט לטעינה בזמן ההפעלה.
-
אופציונלי: בקטע Post-startup script URL, בוחרים את ההתנהגות של הסקריפט לטעינה בזמן ההפעלה. פעולת ברירת המחדל היא Run once. מידע נוסף זמין במאמר התנהגות הסקריפט לטעינה בזמן ההפעלה לאחר ההפעלה.
-
אופציונלי: כדי להוסיף משתנה סביבה, לוחצים על Add env variable ומזינים צמד של Key ו-Value. כדי להוסיף עוד משתני סביבה, חוזרים על השלב הזה.
-
לוחצים על Continue.
רשתות ואבטחה
-
בקטע Networking and security, בתפריט Network, בוחרים רשת. אם לא בוחרים רשת, המערכת בוחרת את רשת ברירת המחדל.
-
בתפריט Subnetwork, בוחרים רשת משנה.
-
כדי להשבית את הגישה לאינטרנט הציבורי, מבטלים את הבחירה באפשרות הפעלת גישה לאינטרנט הציבורי.
-
כדי להשבית את הגישה לפרטי הכניסה של משתמשי הקצה, מבטלים את הסימון של הפעלת פרטי הכניסה של משתמשי הקצה.
סיום היצירה של תבנית זמן הריצה
לוחצים על Create כדי לסיים את יצירת התבנית של סביבת זמן הריצה.
תבנית זמן הריצה מופיעה ברשימה בכרטיסייה Runtime templates.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
DISPLAY_NAME: השם המוצג של תבנית זמן הריצה. PROJECT_ID: מזהה הפרויקט.-
REGION: האזור שבו רוצים ליצור את תבנית סביבת זמן הריצה. -
MACHINE_TYPE: סוג המכונה שבה משתמשים בסביבת זמן הריצה. -
ACCELERATOR_TYPE: סוג מאיץ החומרה שבו רוצים להשתמש בסביבת זמן הריצה. -
ACCELERATOR_COUNT: מספר המאיצים שבהם משתמשים בסביבת זמן הריצה.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud colab runtime-templates create --display-name="DISPLAY_NAME" \ --project=PROJECT_ID \ --region=REGION \ --machine-type=MACHINE_TYPE \ --accelerator-type=ACCELERATOR_TYPE \ --accelerator-count=ACCELERATOR_COUNT
Windows (PowerShell)
gcloud colab runtime-templates create --display-name="DISPLAY_NAME" ` --project=PROJECT_ID ` --region=REGION ` --machine-type=MACHINE_TYPE ` --accelerator-type=ACCELERATOR_TYPE ` --accelerator-count=ACCELERATOR_COUNT
Windows (cmd.exe)
gcloud colab runtime-templates create --display-name="DISPLAY_NAME" ^ --project=PROJECT_ID ^ --region=REGION ^ --machine-type=MACHINE_TYPE ^ --accelerator-type=ACCELERATOR_TYPE ^ --accelerator-count=ACCELERATOR_COUNT
מידע נוסף על הפקודה ליצירת תבנית זמן ריצה משורת הפקודה זמין במסמכי התיעוד של ה-CLI של gcloud.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
REGION: האזור שבו רוצים ליצור את תבנית סביבת זמן הריצה. PROJECT_ID: מזהה הפרויקט.-
DISPLAY_NAME: השם המוצג של תבנית זמן הריצה. -
MACHINE_TYPE: סוג המכונה שבה משתמשים בסביבת זמן הריצה. -
ACCELERATOR_TYPE: סוג מאיץ החומרה שבו רוצים להשתמש בסביבת זמן הריצה. -
ACCELERATOR_COUNT: מספר המאיצים שבהם משתמשים בסביבת זמן הריצה.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates
גוף בקשת JSON:
{
"displayName": "DISPLAY_NAME",
"machineSpec": {
{
"machineType": MACHINE_TYPE
"acceleratorType": ACCELERATOR_TYPE,
"acceleratorCount": ACCELERATOR_COUNT,
}
},
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates" | Select-Object -Expand Content
מידע נוסף זמין במאמרי העזרה של API בארכיטקטורת REST של notebookRuntimeTemplates.create.
מתן גישה לתבנית של זמן הריצה
אחרי שיוצרים תבנית של סביבת זמן ריצה, צריך לתת לחשבון הראשי גישה אליה כדי שהוא יוכל להשתמש בה. חשבון משתמש יכול ליצור סביבת זמן ריצה מתבנית של סביבת זמן ריצה רק אם יש לו את ההרשאות הבאות:
- גישה לתבנית של סביבת זמן הריצה.
- ההרשאות שנדרשות כדי ליצור סביבות זמן ריצה.
המאמרים הבאים
- מידע נוסף על סביבות זמן ריצה ותבניות של סביבות זמן ריצה
- איך יוצרים סביבת זמן ריצה על סמך תבנית של סביבת זמן ריצה.