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

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

  • עריכה של תבנית בזמן ריצה.
  • מחיקה של תבנית זמן ריצה.

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

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

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

עריכת תבנית של זמן ריצה

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

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

המסוף

כדי לערוך תבנית של זמן ריצה:

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

    מעבר אל Runtime templates

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

  3. בעמודה ID, לוחצים על מספר המזהה של תבנית זמן הריצה שרוצים לערוך.

  4. לוחצים על  עריכה.

  5. בפאנל Edit runtime template (עריכת תבנית בזמן ריצה), מבצעים שינויים בתבנית בזמן הריצה.

  6. לוחצים על עדכון.

REST

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

  • ‫REGION: האזור שבו נמצאת תבנית זמן הריצה.
  • PROJECT_ID: מזהה הפרויקט.
  • ‫NOTEBOOK_RUNTIME_TEMPLATE_ID: המזהה של תבנית זמן הריצה.
  • ‫RELEASE_NAME: שם הגרסה של התמונה שרוצים להשתמש בה. לדוגמה, py311 הוא שם הגרסה של תמונת Python 3.11. כדי להגדיר את התמונה ל-Latest, משאירים את RELEASE_NAME ריק.

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

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

גוף בקשת JSON: 

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

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

curl

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

curl -X PATCH \
     -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/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה: 

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

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Operation.

מידע על פרמטרים של שאילתה זמינים מופיע במסמכי התיעוד של notebookRuntimeTemplates.patch API בארכיטקטורת REST.

מחיקה של תבנית זמן ריצה

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

המסוף

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

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

    מעבר אל Runtime templates

  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.

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

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