ניהול גרסאות של תמונות

בדף הזה מוסבר איך לנהל גרסאות של תמונות עבור מופעים של Gemini Enterprise Agent Platform Workbench, כולל איך לבצע את הפעולות הבאות:

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

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

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

תמונות VM

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

רשימת תמונות VM זמינות

תמונות של מכונות וירטואליות מאוחסנות במאגר פרטי. כדי להציג רשימה של תמונות VM זמינות וההגדרות הנתמכות שלהן, משתמשים ב-gcloud workbench instances get-config או ב-API ‏GetConfig.

gcloud workbench instances get-config --location=LOCATION

curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://notebooks.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/instances:getConfig"

יצירת מופע עם תמונת VM ספציפית

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

# Using an image family
gcloud workbench instances create INSTANCE_NAME \
  --vm-image-project=cloud-notebooks-managed \
  --vm-image-family=IMAGE_FAMILY \
  --location=LOCATION

# Using a specific image name
gcloud workbench instances create INSTANCE_NAME \
  --vm-image-project=cloud-notebooks-managed \
  --vm-image-name=IMAGE_NAME \
  --location=LOCATION

resource "google_workbench_instance" "vm_instance" {
  # ... other configurations
  gce_setup {
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "IMAGE_FAMILY" # Or specify image name to get an exact version
    }
  }
  # ...
}

שדרוג תמונת VM

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

gcloud workbench instances upgrade INSTANCE_NAME --location=LOCATION

resource "google_workbench_instance" "vm_instance" {
  # ... other configurations
  gce_setup {
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances-2603" # Or use name = "workbench-instances-2603-20240315-1800-rc0"
    }
  }
  # ...
}

שדרוג בין משפחות של תמונות

כדי לשנות את המופע לשם התמונה העדכני ביותר במשפחת תמונות אחרת (לדוגמה, מ-workbench-instances ל-workbench-instances-2603 החדש יותר), צריך לציין את משפחת התמונות של היעד במהלך השדרוג. זו הדרך הנתמכת למעבר בין גרסאות ראשיות בלי ליצור מחדש את המופע.

gcloud workbench instances upgrade INSTANCE_NAME \
  --location=LOCATION \
  --image-family=projects/IMAGE_PROJECT/global/images/family/IMAGE_FAMILY

gcloud workbench instances upgrade example-instance \
  --location=us-central1 \
  --image-family=projects/cloud-notebooks-managed/global/images/family/workbench-instances-2603

קובץ אימג' מותאם אישית של קונטיינר

קונטיינרים בהתאמה אישית במופעים של Agent Platform Workbench פועלים לפי מודל הפצה רציף וקפדני, ללא הסתעפות של תמונות או תחזוקה מקבילה. נעשה שימוש בתג לניהול גרסאות לפי תאריך, שמשותף לכל התמונות שמשמשות לניהול מאגרי תגים בהתאמה אישית במופעים של Agent Platform Workbench לכל מהדורה נתונה. תג ניהול הגרסאות בנוי בפורמט YYYYMMDD-HHMM-rcX.

במאמר יצירת אירוע מותאם אישית שמבוסס על קונטיינר מוסבר איך ליצור קונטיינרים מותאמים אישית ולהשתמש בהם במופעים של Agent Platform Workbench.

תמונה של המארח

משפחת תמונות: workbench-container-host

המארח של הקונטיינר משתמש במערכת ההפעלה Container Optimized OS ‏ (COS) של Google. אי אפשר לציין את הגרסה כשיוצרים מופע חדש של מאגר תגים מותאם אישית ב-Agent Platform Workbench. במקום זאת, מופעים חדשים משתמשים בתמונת ה-COS העדכנית כמארח של הקונטיינר. התמונה הבסיסית מבוססת על הגרסה היציבה העדכנית ביותר של מערכת הפעלה שמותאמת לקונטיינרים מ-COS. אפשר לעיין בהערות המוצר של מערכת הפעלה שמותאמת לקונטיינרים.

מופעים של מאגרי תגים בהתאמה אישית

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

יצירת מכונה עם מאגר מותאם אישית

כדי ליצור מופע של Agent Platform Workbench באמצעות קונטיינר בהתאמה אישית, משתמשים ב-ה-CLI של gcloud או ב-Terraform.

gcloud workbench instances create INSTANCE_NAME \
  --project=PROJECT_ID \
  --location=ZONE \
  --container-repository=REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME \
  --container-tag=TAG

resource "google_workbench_instance" "container_instance" {
  # ... other configurations
  gce_setup {
    container_image {
      repository = "REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY_NAME/IMAGE_NAME"
      tag        = "TAG"
    }
  }
  # ...
}

שדרוג קונטיינר בהתאמה אישית

מופע קונטיינר בהתאמה אישית פועל על שני קובצי אימג' שמשודרגים בצורה שונה:

• תמונה של מארח קונטיינר: מנוהלת על ידי Google. הוא פועל לפי נתיב השדרוג של מכונות ה-VM.
• קובץ אימג' בסיסי של קונטיינר: קובץ האימג' שאתם יוצרים ובוחרים. כדי לשדרג אותו, צריך להפנות לתג שניתן לשינוי כמו :latest (המופע קולט את השינויים בתג הזה בהפעלה מחדש) או לעדכן את המופע לתג אחר.

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

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