התחברות לסביבת זמן ריצה

התחברות לסביבת זמן ריצה

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

כדי להריץ קוד במחברת, צריך להתחבר לסביבת זמן ריצה. סביבת זמן ריצה היא משאב מחשוב שמריץ את הקוד.

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

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

חיבור באמצעות שיטות שונות

בדף הזה מוסבר איך להתחבר לסביבת זמן ריצה באמצעות השיטות הבאות:

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

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

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

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

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

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

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

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

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

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

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

   לתיקיות שלי

2. בתפריט Region (אזור), בוחרים את האזור שבו נמצא ה-Notebook.

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

4. ב-Notebook, לוחצים על Connect (חיבור).
   

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

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

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

   1. בתיבת הדו-שיח כניסה, לוחצים על חשבון המשתמש.

   2. בוחרים באפשרות קריאה, עריכה, הגדרה ומחיקה של הנתונים שלך ב- Google Cloud ... כדי להעניק ל-Colab Enterprise גישה לפרטי הכניסה של המשתמש.

      

   3. לוחצים על Continue.

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

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

בקטע הזה מוסבר איך להתחבר לסביבת זמן ריצה קיימת באמצעות תיבת הדו-שיח Connect to Agent Platform runtime (התחברות לסביבת זמן ריצה של Agent Platform).

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

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

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

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

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

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

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

   לתיקיות שלי

2. בתפריט Region (אזור), בוחרים את האזור שבו נמצא ה-Notebook.

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

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

   תיפתח תיבת הדו-שיח Connect to Agent Platform runtime (חיבור לזמן הריצה של פלטפורמת הנציגים).

5. בקטע Select a runtime (בחירת זמן ריצה), בוחרים באפשרות Connect to an existing runtime (קישור לזמן ריצה קיים).

6. בקטע Select an existing runtime option (בחירת אפשרות קיימת של זמן ריצה), בוחרים את זמן הריצה שאליו רוצים להתחבר. אם אין זמני ריצה ברשימה, יוצרים זמן ריצה או מתחברים לזמן הריצה שמוגדר כברירת מחדל.

7. לוחצים על Connect.

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

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

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

   1. בתיבת הדו-שיח כניסה, לוחצים על חשבון המשתמש.

   2. בוחרים באפשרות קריאה, עריכה, הגדרה ומחיקה של הנתונים שלך ב- Google Cloud ... כדי להעניק ל-Colab Enterprise גישה לפרטי הכניסה של המשתמש.

      

   3. לוחצים על Continue.

מערכת Colab Enterprise מתחברת לסביבת זמן הריצה. אם סביבת זמן הריצה לא פועלת, Colab Enterprise מפעיל אותה ואז מתחבר אליה.

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

בקטע הזה מוסבר איך ליצור סביבת זמן ריצה ולהתחבר אליה באמצעות תיבת הדו-שיח Connect to Agent Platform runtime (חיבור לסביבת זמן ריצה של פלטפורמת הסוכנים). אפשר גם ליצור סביבת ריצה מהכרטיסייה Runtimes.

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

כדי לקבל את ההרשאות שנדרשות ליצירת סביבת ריצה ב-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 יכולים לראות רק נכסי קוד שהם יצרו או ששותפו איתם.

יצירת סביבת ריצה וחיבור אליה

כדי ליצור סביבת זמן ריצה ולהתחבר אליה באמצעות תיבת הדו-שיח Connect to Agent Platform runtime:

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

   לתיקיות שלי

2. בתפריט Region (אזור), בוחרים את האזור שבו נמצא ה-Notebook.

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

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

   תיפתח תיבת הדו-שיח Connect to Agent Platform runtime (חיבור לזמן הריצה של פלטפורמת הנציגים).

5. בקטע Select a runtime (בחירת זמן ריצה), בוחרים באפשרות Create new runtime (יצירת זמן ריצה חדש).

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

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

8. לוחצים על Connect.

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

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

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

   1. בתיבת הדו-שיח כניסה, לוחצים על חשבון המשתמש.

   2. בוחרים באפשרות קריאה, עריכה, הגדרה ומחיקה של הנתונים שלך ב- Google Cloud ... כדי להעניק ל-Colab Enterprise גישה לפרטי הכניסה של המשתמש.

      

   3. לוחצים על Continue.

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

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

אם האדמין הפעיל סביבות זמן ריצה שמוגדרות כברירת מחדל עם GPU, או אם לחשבון המשתמש שלכם יש הרשאה aiplatform.notebookRuntimeTemplates.create, אתם יכולים לעבור לסביבת זמן ריצה עם GPU אחרי שמתחברים לסביבת זמן הריצה שמוגדרת כברירת מחדל.

ב-notebook, לוחצים על Switch to GPU (מעבר ל-GPU).

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

ניהול זמן ריצה

כברירת מחדל, כשיוצרים סביבת ריצה, יש לכם באופן אוטומטי את ההרשאות הנדרשות למחיקה (aiplatform.googleapis.com/notebookRuntimes.delete) ולהפעלה (aiplatform.googleapis.com/notebookRuntimes.start) של סביבת הריצה הזו.

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

פתרון בעיות

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

לא ניתן להתחבר לסביבת זמן ריצה

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

הדפדפן חוסם קובצי Cookie של צד שלישי

הדפדפן שבו אתם משתמשים חוסם קובץ Cookie של צד שלישי ש-Colab Enterprise משתמש בו כדי ליצור חיבור HTTPS עם זמן הריצה.

כדי לפתור את הבעיה, צריך להגדיר את הגדרות הדפדפן כך שיאפשרו את קובץ ה-Cookie של צד שלישי מהדומיין *.aiplatform-notebook.googleusercontent.com.DATALAB_TUNNEL_TOKEN

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

כללי חומת האש של הרשת חוסמים תעבורת נתונים יוצאת אל *.aiplatform-notebook.cloud.google.com או אל *aiplatform.googleapis.com.

כדי לפתור את הבעיה, צריך להגדיר את הכללים של חומת האש ברשת כך שיאפשרו תעבורת נתונים יוצאת אל *.aiplatform-notebook.cloud.google.com ואל *aiplatform.googleapis.com.

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

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

Failed to connect to runtime

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

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

החיבור של Notebook לסביבת זמן ריצה איטי

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

כדי לפתור את הבעיה, צריך להמתין כמה דקות. ‫Colab Enterprise עדיין מתחבר לסביבת זמן ריצה. ההתחברות לסביבת ריצה שלא פועלת כבר יכולה להימשך כמה דקות, כי Agent Platform מקצה מופע חדש של מכונה וירטואלית (VM).

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

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

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

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

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.

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

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