בדף הזה מוסבר איך לנהל חלק מהתכונות של מכונות Workbench ב-Gemini Enterprise Agent Platform, באמצעות שינוי של צמדי המפתח/ערך של המטא-נתונים של המכונה.
מפתחות מטא-נתונים
בטבלה הבאה מפורט מידע על התכונות ומפתחות המטא-נתונים שלהן.
| תכונה | תיאור | מפתח המטא-נתונים | ערכים קבילים וערכי ברירת מחדל |
|---|---|---|---|
| הפעלת Cloud Storage FUSE בקובץ אימג' של קונטיינר |
הפקודה הזו טוענת את |
container-allow-fuse |
|
| nbconvert |
מאפשרת לייצא ולהוריד תיקיות Notebook כסוג קובץ אחר. |
notebook-disable-nbconvert |
|
| מחיקה לאשפה |
שימוש בהתנהגות האשפה של מערכת ההפעלה כשמוחקים מ-JupyterLab. |
notebook-enable-delete-to-trash |
|
| Managed Service for Apache Spark |
מאפשרת גישה לקרנלים של Managed Service for Apache Spark. מידע נוסף מופיע במאמר יצירת מכונה שמופעל בה Managed Service for Apache Spark. |
disable-mixer |
|
| BigQuery |
הפעלת הפלאגין BigQuery JupyterLab, שמספק סייר של מערכי נתונים, עורך שאילתות SQL והיסטוריית שאילתות ב-JupyterLab. |
disable-bigquery |
|
| כיבוי במצב של חוסר פעילות |
הפעלה של כיבוי במצב חוסר פעילות. מידע נוסף מופיע במאמר כיבוי במצב חוסר פעילות. |
idle-timeout-seconds |
מספר שלם שמייצג את משך הזמן ללא פעילות בשניות. ערך ברירת המחדל הוא 10800 שניות (180 דקות).
|
| מאפייני אורחים |
הפעלת מאפייני אורחים. נדרשת כדי להפעיל כיבוי במצב חוסר פעילות. מידע נוסף זמין במאמר הדרישות להפעלת כיבוי במצב של חוסר פעילות. |
enable-guest-attributes |
true (ברירת מחדל): הפעלת מאפייני אורח.false: השבתת מאפייני האורחים. |
| תיקונים מתוזמנים למערכת ההפעלה |
תזמון עדכונים אוטומטיים של מערכת ההפעלה של המכונה. הפעולה הזו מפעילה את שירות השדרוג האוטומטי של Debian, והיא רלוונטית רק לתמונות שמבוססות על VM. |
install-unattended-upgrades |
|
| משתמש Jupyter בהתאמה אישית |
מציינת את השם של משתמש ברירת המחדל של Jupyter. ההגדרה הזו קובעת את שם התיקייה של תיקיות ה-Notebook. לדוגמה, במקום ספריית ברירת המחדל |
jupyter-user |
מחרוזת. ערך ברירת המחדל הוא jupyter. |
| הקובץ בהורדה |
מאפשרת להוריד קבצים מ-JupyterLab. |
notebook-disable-downloads |
|
| גישת רוט (Root) |
הפעלת גישת רוט (Root). |
notebook-disable-root |
|
| גישה לטרמינל |
מאפשרת גישה לטרמינל. |
notebook-disable-terminal |
|
| שדרוגים מתוזמנים |
תזמון שדרוגים אוטומטיים של המכונה. |
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 |
|
| דיווח על תקינות האירוע |
בדיקת תקינות כל 30 שניות למדדי VM. |
report-event-health |
|
| הפעלה של JupyterLab 4 או מעבר ל-JupyterLab 3 |
מפעילים את JupyterLab 3. JupyterLab 4 מופעל כברירת מחדל. |
enable-jupyterlab4 |
|
| Antigravity CLI |
הפעלה של Antigravity CLI, עם משבצת מרכז האפליקציות, מיומנויות Notebook, פלאגין ו- |
enable-antigravity |
|
סדר ההרצה של סקריפטים לטעינה בזמן ההפעלה
אם אתם משתמשים בכמה סקריפטים לטעינה בזמן ההפעלה במכונה של 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-secondsagent-health-check-pathcos-update-strategycustom-container-imagecustom-container-payloaddata-disk-uridataproc-allow-custom-clustersdataproc-cluster-namedataproc-configsdataproc-default-subnetdataproc-locations-listdataproc-machine-types-listdataproc-notebooks-urldataproc-regiondataproc-service-accountdisable-check-xsrfeuc-enabledframeworkgenerate-diagnostics-bucketgenerate-diagnostics-filegenerate-diagnostics-optionsgoogle-logging-enabledimage-urlinstall-monitoring-agentinstall-nvidia-driverinstalled-extensionslast_updated_diagnosticlast_updated_diagnosticsnotebooks-apinotebooks-api-versionnotebooks-examples-locationnotebooks-locationproxy-backend-idproxy-byoid-urlproxy-modeproxy-statusproxy-urlproxy-user-mailreport-container-healthreport-event-urlreport-notebook-metricsreport-system-healthreport-system-statusresource-urlrestrictionserial-port-logging-enableservice-account-modeshutdown-scripttitleuse-collaborativeuser-dataversion
יצירת מכונה עם מטא-נתונים ספציפיים
אתם יכולים ליצור מכונה של Agent Platform Workbench עם מטא-נתונים ספציפיים באמצעות מסוף 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.
Notebooks API
כדי לנהל את התכונות המתאימות, משתמשים ב-method instances.create עם ערכי מטא-נתונים.
עדכון המטא-נתונים של מכונה
אפשר לעדכן את המטא-נתונים של מכונה של Agent Platform Workbench באמצעות מסוף Google Cloud , Google Cloud CLI, Terraform או Notebooks API.
המסוף
כדי לעדכן את המטא-נתונים של מכונה של Agent Platform Workbench:
נכנסים לדף Instances במסוף Google Cloud .
ברשימת המכונות, לוחצים על השם של המכונה שרוצים לעדכן.
בדף Instance details, לוחצים על Software and security.
בקטע Metadata, מעדכנים את צמדי המפתח/ערך של המטא-נתונים שרוצים לשנות.
לוחצים על שליחה.
gcloud
כדי לעדכן את המטא-נתונים במכונה של Agent Platform Workbench, משתמשים בפקודה הבאה:
gcloud workbench instances update INSTANCE_NAME --metadata=KEY=VALUE
Terraform
אתם יכולים לשנות את צמדי המפתח/ערך של המטא-נתונים כדי לנהל את התכונות התואמות במכונות של Agent Platform Workbench.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
Notebooks API
כדי לנהל את התכונות המתאימות, משתמשים ב-method instances.patch עם ערכי מטא-נתונים ו-gce_setup.metadata ב-updateMask.
הסרת מטא-נתונים ממכונה
אפשר להסיר מטא-נתונים ממכונה של Agent Platform Workbench באמצעות מסוף Google Cloud , Google Cloud CLI, Terraform או Notebooks API.
המסוף
כדי להסיר מטא-נתונים ממכונה של Agent Platform Workbench:
נכנסים לדף Instances במסוף Google Cloud .
ברשימת המכונות, לוחצים על שם המכונה שרוצים לשנות.
בדף Instance details, לוחצים על Software and security.
בקטע Metadata, מימין לצמד המפתח/ערך שרוצים למחוק, לוחצים על Delete.
לוחצים על שליחה.
gcloud
כדי להסיר מטא-נתונים ממכונה של Agent Platform Workbench, משתמשים בפקודה הבאה:
gcloud workbench instances update INSTANCE_NAME --metadata=KEY
Terraform
אתם יכולים להסיר צמדים של מפתח/ערך במטא-נתונים כדי לנהל את התכונות התואמות של מכונה ב-Agent Platform Workbench.
כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.
Notebooks API
כדי להסיר את התכונה המתאימה, משתמשים ב-updateMask ב-gce_setup.metadata וב-instances.patch עם ערך מטא-נתונים שמוגדר כמחרוזת ריקה.