Some or all of the information on this page might not apply to Cloud de Confiance by S3NS. See Differences from Google Cloud for more details.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול תכונות באמצעות מטא-נתונים

בדף הזה מוסבר איך לשנות את צמדי מפתח/ערך של המטא-נתונים של מופע של Gemini Enterprise Agent Platform Workbench כדי לנהל חלק מהתכונות של המופע.

מפתחות מטא-נתונים

בטבלה הבאה מפורטות התכונות ומפתחות המטא-נתונים שלהן.

תכונה	תיאור	מפתח מטא-נתונים	ערכים קבילים וערכי ברירת מחדל
הפעלת Cloud Storage FUSE בקובץ אימג' של קונטיינר	הפקודה mount מעבירה את `/dev/fuse` לקונטיינר ומאפשרת להשתמש ב-`gcsfuse` בקונטיינר.	`container-allow-fuse`	‫`true`: הפעלת Cloud Storage FUSE. ‫`false` (ברירת מחדל): לא מפעיל את Cloud Storage FUSE.
nbconvert	אפשר לייצא ולהוריד מחברות כסוג קובץ אחר.	`notebook-disable-nbconvert`	‫`true`: משבית את nbconvert. ‫`false` (ברירת מחדל): מפעיל את nbconvert.
מחיקה והעברה לאשפה	משתמש בהתנהגות של האשפה במערכת ההפעלה כשמוחקים מ-JupyterLab.	`notebook-enable-delete-to-trash`	‫`true`: מאפשר מחיקה לאשפה. ‫`false` (ברירת מחדל): שימוש בהתנהגות ברירת המחדל של JupyterLab.
Managed Service for Apache Spark	מאפשרת גישה לליבות של Managed Service for Apache Spark. מידע נוסף מופיע במאמר יצירת מופע עם הפעלה של Managed Service for Apache Spark.	`disable-mixer`	‫`true`: השבתת הגישה לליבות של Managed Service for Apache Spark. ‫`false` (ברירת מחדל): מאפשר גישה לליבות של Managed Service for Apache Spark.
BigQuery	הפעלת הפלאגין BigQuery JupyterLab, שמספק כלי לחקירת מערכי נתונים, עורך לשאילתות SQL והיסטוריית שאילתות ב-JupyterLab.	`disable-bigquery`	‫`true`: משבית את הפלאגין BigQuery JupyterLab. ‫`false` (ברירת מחדל): מפעיל את הפלאגין BigQuery JupyterLab.
כיבוי במצב לא פעיל	הפעלה של כיבוי במצב לא פעיל. מידע נוסף מופיע במאמר בנושא השבתה במצב לא פעיל.	`idle-timeout-seconds`	מספר שלם שמייצג את הזמן ללא פעילות בשניות. ערך ברירת המחדל הוא `10800` שניות (180 דקות).
מאפייני אורחים	הפעלת מאפייני אורח. נדרש להפעלה של כיבוי במצב לא פעיל. מידע נוסף זמין במאמר בנושא דרישות להפעלת כיבוי במצב המתנה.	`enable-guest-attributes`	‫`true` (ברירת מחדל): הפעלת מאפייני אורחים. ‫`false`: משבית את מאפייני האורח.
תיקוני מערכת הפעלה מתוזמנים	מתזמן עדכונים אוטומטיים של מערכת ההפעלה של המופע. האפשרות הזו מפעילה את שירות השדרוג האוטומטי של Debian, והיא רלוונטית רק לתמונות שמבוססות על מכונות וירטואליות.	`install-unattended-upgrades`	‫`true`: הפעלת עדכונים אוטומטיים של מערכת ההפעלה. ‫`false` (ברירת מחדל): השבתה של עדכונים אוטומטיים של מערכת ההפעלה.
משתמש Jupyter מותאם אישית	ההגדרה הזאת מציינת את השם של משתמש Jupyter שמוגדר כברירת מחדל. ההגדרה הזו קובעת את שם התיקייה של הנוטבוקים. לדוגמה, במקום ספריית ברירת המחדל `/home/jupyter/`, אפשר לשנות את הספרייה ל-`/home/CUSTOM_NAME`. מפתח המטא-נתונים הזה לא משפיע על הגישה למופע.	`jupyter-user`	מחרוזת. ערך ברירת המחדל הוא `jupyter`.
הורדת קובץ	מאפשר להוריד קבצים מ-JupyterLab.	`notebook-disable-downloads`	‫`true`: משבית את הורדת הקבצים. ‫`false` (ברירת מחדל): מאפשר הורדת קבצים.
גישת רוט (Root)	הפעלה של גישת root.	`notebook-disable-root`	‫`true`: השבתה של גישת root. ‫`false` (ברירת מחדל): מאפשר גישת root.
גישה לטרמינל	הפעלה של גישה לטרמינל.	`notebook-disable-terminal`	‫`true`: משבית את הגישה לטרמינל. ‫`false` (ברירת מחדל): מאפשר גישה לטרמינל.
שדרוגים מתוזמנים	מתזמן שדרוגים אוטומטיים של המופע.	`notebook-upgrade-schedule`	לוח הזמנים השבועי או החודשי שהגדרתם בפורמט unix-cron. לדוגמה, `00 19 * * MON` פירושו שבועי ביום שני, בשעה 19:00 לפי שעון גריניץ' (GMT). התכונה הזו מושבתת כברירת מחדל. כדי להשבית את התכונה הזו או להשאיר אותה מושבתת, משמיטים את מפתח המטא-נתונים `notebook-upgrade-schedule` מההגדרה או מגדירים את הערך שלו למחרוזת ריקה (`""`).
סקריפט שמופעל אחרי ההפעלה	מריץ סקריפט מותאם אישית אחרי שסקריפטים אחרים לטעינה בזמן ההפעלה מסתיימים. פרטים על סדר הביצוע זמינים במאמר סדר הביצוע של סקריפטים לטעינה בזמן ההפעלה.	`post-startup-script`	ה-URI של סקריפט להפעלה אחרי ההפעלה ב-Cloud Storage, לדוגמה: `gs://bucket/hello.sh`. התכונה הזו מושבתת כברירת מחדל.
אופן הפעולה של סקריפט אחרי ההפעלה	המדיניות מגדירה מתי ואיך יפעל הסקריפט אחרי ההפעלה.	`post-startup-script-behavior`	‫`run_once` (ברירת מחדל): מריץ את הסקריפט אחרי הפעלה פעם אחת אחרי יצירת המופע או השדרוג שלו. ‫`run_every_start`: מריץ את הסקריפט אחרי ההפעלה אחרי כל הפעלה. ‫`download_and_run_every_start`: מוריד מחדש את הסקריפט להפעלה אחרי אתחול מהמקור שלו, ואז מריץ את הסקריפט אחרי כל הפעלה.
דיווח על תקינות האירועים	בודק את הבריאות כל 30 שניות למדדים של מכונה וירטואלית.	`report-event-health`	‫`true` (ברירת מחדל): הפעלת דיווח על תקינות האירועים. ‫`false`: משבית את הדיווח על תקינות האירועים.
הפעלה של JupyterLab 4 או מעבר ל-JupyterLab 3	מפעילים את JupyterLab 3. ‫JupyterLab 4 מופעל כברירת מחדל.	`enable-jupyterlab4`	‫`true` (ברירת מחדל): הפעלת JupyterLab 4. ‫`false`: הפעלת JupyterLab 3.

סדר ההרצה של סקריפטים לטעינה בזמן ההפעלה

אם אתם משתמשים בכמה סקריפטים להפעלה במופע של Agent Platform Workbench, הם יפעלו בסדר הבא:

‫startup-script: מורץ ראשון במהלך כל אתחול אחרי האתחול הראשוני.
‫startup-script-url: מורץ שני במהלך כל הפעלה אחרי ההפעלה הראשונית.
‫workbench-startup-scripts: מורץ אחרי שסקריפטים לאתחול של Compute Engine (startup-script ו-startup-script-url) מסתיימים.
‫post-startup-script: מופעל אחרי ש-workbench-startup-scripts מסתיים.

שימו לב: בשביל מפתח המטא-נתונים post-startup-script, צריך לספק את הסקריפט כ-URI של Cloud Storage. אי אפשר לספק את תוכן הסקריפט ישירות כערך.

מטא-נתונים שמנוהלים על ידי Compute Engine

חלק ממפתחות המטא-נתונים מוגדרים מראש על ידי Compute Engine. מידע נוסף מופיע במאמר בנושא מפתחות מטא-נתונים מוגדרים מראש.

מפתחות מטא-נתונים מוגנים

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

מפתחות מטא-נתונים שמורים כוללים, בין היתר:

agent-health-check-interval-seconds
agent-health-check-path
cos-update-strategy
custom-container-image
custom-container-payload
data-disk-uri
dataproc-allow-custom-clusters
dataproc-cluster-name
dataproc-configs
dataproc-default-subnet
dataproc-locations-list
dataproc-machine-types-list
dataproc-notebooks-url
dataproc-region
dataproc-service-account
disable-check-xsrf
euc-enabled
framework
generate-diagnostics-bucket
generate-diagnostics-file
generate-diagnostics-options
google-logging-enabled
image-url
install-monitoring-agent
install-nvidia-driver
installed-extensions
last_updated_diagnostic
last_updated_diagnostics
notebooks-api
notebooks-api-version
notebooks-examples-location
notebooks-location
proxy-backend-id
proxy-byoid-url
proxy-mode
proxy-status
proxy-url
proxy-user-mail
report-container-health
report-event-url
report-notebook-metrics
report-system-health
report-system-status
resource-url
restriction
serial-port-logging-enable
service-account-mode
shutdown-script
title
use-collaborative
user-data
version

יצירת מכונה עם מטא-נתונים ספציפיים

אפשר ליצור מכונה של Agent Platform Workbench עם מטא-נתונים ספציפיים באמצעות Cloud de Confiance מסוף Google Cloud,‏ Google Cloud CLI,‏ Terraform או Notebooks API.

המסוף

כשיוצרים מופע של Agent Platform Workbench, אפשר להוסיף מטא-נתונים בקטע Environment (סביבה) של Advanced options (אפשרויות מתקדמות).

הלחצן 'הוספת מטא-נתונים' בקטע 'סביבה'

gcloud

כשיוצרים מופע של Agent Platform Workbench, אפשר להוסיף מטא-נתונים באמצעות הפקודה הבאה:

gcloud workbench instances create INSTANCE_NAME --metadata=KEY=VALUE

Terraform

כדי להוסיף מטא-נתונים, יוצרים את המשאב עם צמדי מפתח/ערך של מטא-נתונים.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
      key = "value"
    }
  }
}

Notebooks API

משתמשים בשיטה instances.create עם ערכי מטא-נתונים כדי לנהל את התכונות המתאימות.

עדכון המטא-נתונים של מופע

אפשר לעדכן את המטא-נתונים של מופע Agent Platform Workbench באמצעות Cloud de Confiance המסוף, Google Cloud CLI,‏ Terraform או Notebooks API.

המסוף

כדי לעדכן את המטא-נתונים של מופע של Agent Platform Workbench:

נכנסים לדף Instances במסוף Cloud de Confiance .

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

gcloud

כדי לעדכן את המטא-נתונים במופע של Agent Platform Workbench, משתמשים בפקודה הבאה:

gcloud workbench instances update INSTANCE_NAME --metadata=KEY=VALUE

Terraform

אתם יכולים לשנות את צמדי מפתח/ערך של המטא-נתונים כדי לנהל את התכונות התואמות במופעים של Agent Platform Workbench.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
      key = "updated_value"
    }
  }
}

Notebooks API

אפשר להשתמש בשיטה instances.patch עם ערכי מטא-נתונים ו-gce_setup.metadata ב-updateMask כדי לנהל את התכונות המתאימות.

הסרת מטא-נתונים ממופע

אפשר להסיר מטא-נתונים ממופע של Agent Platform Workbench באמצעות מסוף Cloud de Confiance , Google Cloud CLI,‏ Terraform או Notebooks API.

המסוף

כדי להסיר מטא-נתונים ממופע של Agent Platform Workbench:

נכנסים לדף Instances במסוף Cloud de Confiance .

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

gcloud

כדי להסיר מטא-נתונים ממופע של Agent Platform Workbench, משתמשים בפקודה הבאה:

gcloud workbench instances update INSTANCE_NAME --metadata=KEY

Terraform

אתם יכולים להסיר צמדים של מפתח/ערך של מטא-נתונים כדי לנהל את התכונות התואמות של מופע Agent Platform Workbench.

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

resource "google_workbench_instance" "default" {
  name     = "workbench-instance-example"
  location = "us-central1-a"

  gce_setup {
    machine_type = "n1-standard-1"
    vm_image {
      project = "cloud-notebooks-managed"
      family  = "workbench-instances"
    }
    metadata = {
    }
  }
}

Notebooks API

כדי להסיר את התכונה המתאימה, משתמשים בשיטה instances.patch עם ערך המטא-נתונים שמוגדר כמחרוזת ריקה ועם gce_setup.metadata ב-updateMask.