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

בדף הזה מוסבר איך לנהל סביבת זמן ריצה ב-Colab Enterprise, כולל הפעולות הבאות:

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

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

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

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

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

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

המסוף

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

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

    מעבר אל Runtimes

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

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

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

gcloud

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

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

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

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

REST

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

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

ה-method של ה-HTTP וכתובת ה-URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

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

curl

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

מידע נוסף זמין במסמכי התיעוד של notebookRuntimes.start REST API.

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

כדי להפסיק סביבת זמן ריצה, אפשר להשתמש ב-CLI של gcloud או ב-API בארכיטקטורת REST.

gcloud

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

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

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

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

REST

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

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

ה-method של ה-HTTP וכתובת ה-URL: 

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

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

curl

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

מידע נוסף זמין במסמכי התיעוד של notebookRuntimes.stop REST API.

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

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

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

    לתיקיות שלי

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

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

  4. בסרגל הכלים של הכותרת, לוחצים על Runtime > Manage sessions (ניהול סשנים). אם סרגל הכלים של הכותרת לא מופיע, לוחצים על  הצגה או הסתרה של הכותרת.

  5. בחלונית סשנים פעילים, לוחצים על הלחצן  סיום הסשן.

  6. לוחצים על סיום.

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

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

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

    לתיקיות שלי

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

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

  4. בפינה השמאלית העליונה של המחברת, לוחצים על Reconnect (חיבור מחדש).

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

שינוי סביבת זמן הריצה

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

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

    לתיקיות שלי

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

  3. פותחים נוטבוק שמחובר לסביבת זמן ריצה.

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

  5. משלימים את תיבת הדו-שיח כדי להתחבר לסביבת זמן ריצה.

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

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

המסוף

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

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

    מעבר אל Runtimes

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

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

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

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

gcloud

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

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

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

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

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

REST

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

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

ה-method של ה-HTTP וכתובת ה-URL: 

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

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

curl

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

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

מידע נוסף זמין במסמכי התיעוד של notebookRuntimes.delete REST API.

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