דלגו לתוכן
גיליון 001·חי·20:20 IL
→ יומן/2026-10-26·8 דק׳

Agent Sandbox ב-GKE: מה התיעוד דורש, מה הוא חוסם, ואיפה העמודים לא מסכימים

Agent Sandbox ב-GKE הוא תוסף מנוהל להרצת קוד סוכנים לא-מהימן ב-gVisor. מה התיעוד של גוגל אומר על warm pools, הגדרות pod חובה, ברירות מחדל של רשת ועלות, ועוד שני מקומות שבהם העמודים לא תואמים.

מאת Harel Asaf·בונה בינה מלאכותית·תל אביב

Agent Sandbox ב-GKE הוא תוסף מנוהל להרצת קוד לא-מהימן שנוצר על ידי LLM ב-pods מבודדים, stateful, בעלי רפליקה אחת. התיעוד של גוגל אומר שהוא בנוי על בקר Agent Sandbox בקוד פתוח, מריץ עומסי עבודה ב-gVisor כברירת מחדל, ולא עולה שום דבר נוסף מעבר למשאבי ה-GKE שאתם יוצרים. החלק ששווה לקרוא לעומק הוא רשימת ההגדרות שהקלאסטר כופה עליכם, ושני מקומות שבהם העמודים של גוגל עצמה לא מסכימים אחד עם השני.

זו קריאה של שלושה עמודי תיעוד של Google Cloud. לא יצרתי קלאסטר, לא הרצתי את התוסף, ולא מדדתי שום דבר. כל מספר למטה הוא מהתיעוד.

מה זה

עמוד הסקירה מתאר את Agent Sandbox ב-GKE כדרך לנהל "עומסי עבודה מבודדים, stateful ובעלי רפליקה אחת", שמכוון ל-runtimes של סוכני AI שבהם קוד לא-מהימן חייב לרוץ בסביבה מאובטחת. גוגל מנהלת את מחזור החיים של הבקר, כולל שדרוגים ועדכוני אבטחה.

חמישה custom resources של Kubernetes עושים את העבודה, לפי התיעוד:

  • Sandbox: pod אחד stateful עם hostname יציב, זהות רשת ואחסון מתמשך.
  • SandboxTemplate: תבנית לשימוש חוזר ל-sandboxes.
  • SandboxClaim: בקשה ל-sandbox שמצביעה על תבנית. הבקר ממפה את ה-claim ל-sandbox, ויכול לעשות שימוש חוזר באחד או לקחת אחד מ-pool.
  • SandboxWarmPool: קבוצה של pods מחוממים מראש שמוחזקים מוכנים ל-claiming.
  • Sandbox Router: רכיב שנותן endpoint יציב ומנהל מנהרת תעבורה ל-sandbox pod הנכון.

הסקירה גם אומרת שהתוסף משתלב עם GKE Pod snapshots, כך שאפשר להשהות ולהחזיר עומס עבודה על ידי שמירה ושחזור של מצב הקונטיינר. היא מפרטת את Kata Containers כאפשרות נתמכת בקוד פתוח ואומרת ש-Kata הוא לא מוצר של Google Cloud, אז התמיכה וה-SLAs של גוגל לא חלים עליו.

טענת המהירות, ומה היא תלויה בו

התיעוד של גוגל אומר ש-warm pools נותנים לכם סביבת הרצה בפחות משנייה ("typically <1s"). עמוד ה-how-to מסביר את המנגנון: warm pool מחזיק pods מאותחלים רצים, ו-claim מאמץ אחד במקום להתחיל pod חדש. ה-pool אז ממלא את עצמו מחדש למספר הרפליקות שהגדרתם.

זו טענת ספק בלי מערך בדיקה מצורף. היא גם תלויה בכך של-pool יש pod פנוי. ל-pool לדוגמה בתיעוד יש replicas: 2. אם הסוכנים שלכם עושים claim ל-sandboxes מהר יותר ממה שה-pool מתמלא מחדש, התיעוד לא אומר מה claim עולה באותה נקודה, אז בדקו את זה עם העומס שלכם.

מה הקלאסטר כופה על ה-pods שלכם

זה החלק הכי שימושי בעמוד ה-how-to. GKE אוכפת כללי sandbox דרך Validating Admission Policy. אם manifest מפספס אותם, ה-deployment נדחה.

נדרש, לפי התיעוד:

  • runtimeClassName: gvisor
  • automountServiceAccountToken: false
  • securityContext.runAsNonRoot: true
  • השלכת כל ה-Linux capabilities (capabilities.drop: ["ALL"])
  • מגבלות CPU וזיכרון, שלפי התיעוד מונעות תרחישי denial-of-service
  • nodeSelector עבור sandbox.gke.io/runtime: gvisor
  • toleration עבור ה-taint sandbox.gke.io/runtime=gvisor:NoSchedule

אסור: hostNetwork, hostPID, hostIPC, קונטיינרים privileged, volumes מסוג hostPath, capabilities נוספים, hostPort, sysctls מותאמים אישית, ו-projected volumes לטוקנים או תעודות של service account.

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

ברירת המחדל של הרשת היא לא "אין רשת"

עמוד הסקירה אומר שהתוסף משתמש בעמדת רשת "Default Deny", כך שקוד לא-מהימן לא יכול להגיע לרשתות פנימיות לא-מורשות או ל-control plane של GKE כברירת מחדל.

עמוד ה-how-to ספציפי יותר לגבי מה זה אומר עם networkPolicyManagement: Managed:

  • Ingress חסום מכל המקורות חוץ מ-Sandbox Router.
  • Egress לאינטרנט הציבורי מותר.
  • Egress לטווחי LAN פרטיים (RFC 1918), DNS פנימי של הקלאסטר (CoreDNS) וטווח ה-metadata server 169.254.0.0/16 חסום.

אז ברירת המחדל חוסמת את הרשת הפנימית שלכם. היא לא חוסמת את האינטרנט. אם מודל האיומים שלכם כולל סוכן ששולח נתונים החוצה ל-endpoint ציבורי, ברירת המחדל לא תעצור את זה, ותצטרכו מדיניות רשת מותאמת ב-SandboxTemplate. התיעוד מפנה לעמוד Network Policy Management נפרד לתבניות air-gapped. לא קראתי את העמוד ההוא.

יש השלכה שנייה. מכיוון שה-metadata server חסום, sandbox שצריך APIs של Google Cloud כמו Cloud Storage צריך מדיניות מותאמת בתוספת Workload Identity Federation ל-GKE, לפי התיעוד.

שני מקומות שהתיעוד לא מסכים עם עצמו

גרסת הקלאסטר. עמוד הסקירה אומר שתמיכת תכונות מלאה, כולל snapshots, צריכה GKE 1.35.2-gke.1269000 ומעלה. עמוד ההפעלה אומר שהקלאסטר שלכם חייב להריץ 1.36.3-gke.1767000 ומעלה, כי הגרסה ההיא תומכת ב-API של v1beta1, והדוגמאות שלו משתמשות ב-extensions.agents.x-k8s.io/v1beta1. העמודים אולי מתארים סטים שונים של תכונות, אבל הם לא אומרים זאת. אם אתם מתכננים קלאסטר, קחו את המספר הגבוה ובדקו קודם את העמוד העדכני.

תגיות image לדוגמה. דוגמת ה-router בעמוד ה-how-to משתמשת בתגית latest-main. העמוד עצמו אומר אחר כך לנעוץ digest של image לפרודקשן, כי התגית תמיד מצביעה על ה-build החדש ביותר. אל תעתיקו את הדוגמה כמו שהיא.

עלות, מגבלות ומה עדיין ב-preview

  • עלות: התיעוד אומר ש-Agent Sandbox ב-GKE מוצע בלי חיוב נוסף, ותמחור GKE חל על המשאבים שאתם יוצרים. ה-warm pool הוא משאבים שנוצרו: pods מחוממים מראש שיושבים idle עדיין רצים.
  • סוגי מכונות: הסקירה אומרת שהוא ממוטב לתצורות node ספציפיות, כמו סוגי מכונות N2. הדוגמאות ב-how-to משתמשות ב-e2-standard-2.
  • בידוד: הוא תומך בכמה runtimes אבל "מיועד בעיקר" ל-gVisor. לקלאסטרים מסוג Standard, צריך node pool שנוצר עם --sandbox=type=gvisor. התיעוד ממליץ על Autopilot, שם מעבירים --enable-agent-sandbox.
  • סטטוס preview: הסקירה אומרת שחלק מהתכונות התשתיתיות, כמו Pod snapshots, עשויות להיות ב-Preview או עם זמינות אזורית מוגבלת. פקודות ההפעלה משתמשות ב-gcloud beta.

איך זה מתקשר ל-Agent Compute Engine

גוגל גם הכריזה החודש על Agent Compute Engine ועל Agent Substrate בקוד פתוח. כיסיתי את זה במאמר נפרד. אלה מוצרים שונים. Agent Compute Engine מתואר כמיועד ל-preview בחודשים הקרובים. ל-Agent Sandbox ב-GKE יש תיעוד ודגל --enable-agent-sandbox היום. התיעוד שקראתי לא משווה בין השניים, אז לא הייתי מניח שאחד מחליף את השני.

מה הייתי בודק

אלה הצעות שלי שלא נבדקו, לא תוצאות.

1. חביון claim תחת עומס. הגדירו warm pool קטן, שגרו claims מהר יותר ממה שהוא מתמלא מחדש, ותעדו כמה זמן ה-claim מחכה. התיעוד נותן נתון תת-שנייה רק למקרה החם.

2. Egress. מתוך sandbox, נסו בקשה ל-URL ציבורי, ואז לכתובת RFC 1918 ול-IP של ה-metadata. השוו עם מה שהתיעוד אומר.

3. מדיניות ה-admission. פרסו manifest שחסרה בו הגדרת חובה אחת וקראו את הודעת הדחייה. תלמדו כמה ברורות השגיאות לפני שחבר צוות ייתקל בהן.

4. עלות idle. תמחרו את ה-pods של ה-warm pool לשבוע במספר הרפליקות שלכם. התיעוד אומר שאין עמלת תוסף, אז העלות היא ה-pods.

5. נעיצת גרסה. צרו קלאסטר בגרסה שעמוד ההפעלה מזכיר ואשרו שהתוסף ומשאבי v1beta1 קיימים.

מה לא הייתי מסיק

  • שקוד לא-מהימן לא יכול לצאת מה-sandbox. ברירת המחדל של egress מאפשרת את האינטרנט הציבורי.
  • שזמן התחלה תת-שנייה מובטח. זה נתון "typically" ל-pods שכבר ב-warm pool.
  • שזה מוכן לפרודקשן מקצה לקצה. חלק מהתכונות התשתיתיות מתוייגות Preview, והתיעוד אומר שמסלול ה-kubectl port-forward של מצב פיתוח לא מאובטח וצריך להישאר בפיתוח.
  • ש-gVisor הוא גבול אבטחה שלם. התיעוד קורא לו "security-hardened" ו"בידוד ברמת הקרנל". לא הערכתי את זה.

שאלות נפוצות

מהו Agent Sandbox ב-GKE?

תוסף מנוהל של GKE, מבוסס על בקר Agent Sandbox בקוד פתוח, להרצת עומסי עבודה מבודדים, stateful ובעלי רפליקה אחת כמו runtimes של סוכני AI שמבצעים קוד לא-מהימן.

האם זה עולה תוספת?

התיעוד אומר שהוא מוצע בלי חיוב נוסף, ותמחור GKE חל על המשאבים שאתם יוצרים, כולל pods של warm pool.

איך מפעילים את זה?

ב-Autopilot, צרו את הקלאסטר עם --enable-agent-sandbox בעזרת gcloud beta container clusters create-auto. ב-Standard, צרו node pool עם gVisor, ואז עדכנו את הקלאסטר עם --enable-agent-sandbox. בדקו בתיעוד את גרסת הקלאסטר העדכנית.

מה warm pool עושה?

SandboxWarmPool מחזיק מספר קבוע של pods מאותחלים מוכנים. SandboxClaim מאמץ אחד, כך ש-sandbox זמין בלי התחלה קרה של pod. גוגל אומרת שזה בדרך כלל פחות משנייה.

האם sandbox יכול להגיע לאינטרנט?

כברירת מחדל, לפי עמוד ה-how-to, כן. Egress לאינטרנט ציבורי מותר. טווחים פרטיים, DNS של הקלאסטר וה-metadata server חסומים. אפשר להדק את זה עם מדיניות רשת מותאמת.

האם sandbox יכול לקרוא ל-APIs של Google Cloud?

כן, עם Workload Identity Federation ל-GKE ומדיניות רשת שמאפשרת את תעבורת ה-metadata server, מכיוון שמדיניות ברירת המחדל חוסמת אותה.

האם זה אותו דבר כמו Agent Compute Engine?

לא. אלה הכרזות ותיעוד נפרדים של גוגל. Agent Compute Engine תואר כמיועד ל-preview בחודשים הקרובים.

מקורות

כל העמודים נקראו ב-26 באוקטובר 2026.

לא נקראו: עמוד Network Policy Management, המדריך של Kata Containers, מאגר הבקר בקוד פתוח, ותיעוד Pod snapshots.

קריאה נוספת

יומן הבנייה

לעקוב אחרי העבודה.

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

עקבו ב-RSS