יצירת סביבת זמן ריצה ב-Colab Enterprise

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

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

במאמר Runtimes ותבניות של Runtimes תוכלו לקרוא מידע נוסף על Runtimes.

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

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

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 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

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

כדי לקבל את ההרשאות שנדרשות ליצירת סביבת ריצה ב-Colab Enterprise, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM 'אדמין של Colab Enterprise' (roles/aiplatform.colabEnterpriseAdmin) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

יצירת סביבת ריצה

כדי ליצור סביבת ריצה, אפשר להשתמש במסוף Google Cloud או ב-Google Cloud CLI.

המסוף

כדי ליצור סביבת ריצה:

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

   עוברים אל Runtimes

2. בתפריט אזור, בוחרים את האזור שבו רוצים להריץ את זמן הריצה. היא צריכה להיות באותו אזור שבו נמצא מחברת ה-Notebook שמשתמשת בה.

3. לוחצים על  יצירה.

   מופיעה תיבת הדו-שיח Create Agent Platform runtime.

4. בתפריט Runtime template, בוחרים תבנית זמן ריצה. אם לא מופיעות תבניות של זמן ריצה, יוצרים תבנית של זמן ריצה.

5. בשדה Runtime name, מזינים שם לזמן הריצה.

6. לוחצים על יצירה.

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

gcloud

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

• ‫DISPLAY_NAME: השם המוצג של זמן הריצה.
• ‫RUNTIME_TEMPLATE_ID: המזהה של תבנית זמן הריצה. התבנית של זמן הריצה מציינת את הגדרות החישוב של זמן הריצה.
• PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור שבו רוצים להפעיל את זמן הריצה.

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" \
    --runtime-template=RUNTIME_TEMPLATE_ID \
    --project=PROJECT_ID \
    --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" `
    --runtime-template=RUNTIME_TEMPLATE_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes create --display-name="DISPLAY_NAME" ^
    --runtime-template=RUNTIME_TEMPLATE_ID ^
    --project=PROJECT_ID ^
    --region=REGION

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

למידע נוסף על הפקודה ליצירת תבנית של סביבת זמן ריצה משורת הפקודה, אפשר לעיין במסמכי התיעוד של ה-CLI של gcloud.

הפעלת סביבת זמן ריצה

כדי להפעיל סביבת ריצה, אפשר להשתמש במסוף Google Cloud או ב-CLI של gcloud.

המסוף

כדי להפעיל סביבת זמן ריצה:

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

   עוברים אל Runtimes

2. בתפריט Region (אזור), בוחרים את האזור שמכיל את זמן הריצה.

3. בוחרים את זמן הריצה שרוצים להפעיל.

4. לוחצים על התחלה.

gcloud

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

• ‫RUNTIME_ID: המזהה של זמן הריצה.
• PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור שבו נמצא זמן הריצה.

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

למידע נוסף על הפקודה ליצירת תבנית של סביבת זמן ריצה משורת הפקודה, אפשר לעיין במסמכי התיעוד של ה-CLI של gcloud.

מחיקת סביבת זמן ריצה

כדי למחוק סביבת ריצה, אפשר להשתמש במסוף Google Cloud או ב-CLI של gcloud.

המסוף

כדי למחוק סביבת ריצה:

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

   עוברים אל Runtimes

2. בתפריט Region (אזור), בוחרים את האזור שמכיל את זמן הריצה.

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

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

5. לוחצים על אישור.

gcloud

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

• ‫RUNTIME_ID: המזהה של זמן הריצה.
• PROJECT_ID: מזהה הפרויקט.
• ‫REGION: האזור שבו נמצא זמן הריצה.

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

‫Linux,‏ macOS או Cloud Shell

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

‏Windows (PowerShell)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows‏ (cmd.exe)

הערה: חשוב לוודא שהפעלתם את Google Cloud CLI עם אימות ופרויקט באמצעות אחת מהפקודות הבאות: gcloud init; או gcloud auth login ו- gcloud config set project.

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

למידע נוסף על הפקודה ליצירת תבנית של סביבת זמן ריצה משורת הפקודה, אפשר לעיין במסמכי התיעוד של ה-CLI של gcloud.

פתרון בעיות

בקטע הזה מוסבר איך לפתור בעיות שקשורות ליצירת סביבות זמן ריצה ב-Colab Enterprise.

אי אפשר ליצור סביבת ריצה

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

חריגה ממכסת הבקשות

אם אתם לא מצליחים ליצור סביבת ריצה, יכול להיות שחרגתם ממכסת סביבות הריצה של Compute Engine.

‫Colab Enterprise משתמש במכסה של Compute Engine לזמני ריצה. למידע נוסף, ראו סקירה כללית על מכסות ומגבלות של Compute Engine.

כדי לפתור את הבעיה, צריך לבקש שינוי במכסה.

משאבים לא זמינים

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

No available zone found for runtime RUNTIME_ID
for machine type MACHINE_TYPE
with accelerator type: ACCELERATOR. Please try again later.

השגיאה הזו מתרחשת אם אין משאבים זמינים להגדרת סוג המכונה באזור של מחברת ה-Notebook.

כדי לפתור את הבעיה, אפשר לנסות את הפתרונות הבאים:

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

זמן הריצה שמוגדר כברירת מחדל כבר קיים

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

Failed to create runtime

One click runtime already exists.

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

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

אי אפשר ליצור זמן ריצה שמוגדר כברירת מחדל

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

כדי לפתור את הבעיה, צריך לבקש מהאדמין להקצות לכם תפקיד שכולל את ההרשאה aiplatform.notebookRuntimeTemplates.create.

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

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