שימוש בממשק Private Service Connect עם Agent Runtime

‫Agent Runtime תומך בממשק Private Service Connect (ממשק PSC) ובקישור בין רשתות שכנות (peering) ב-DNS כדי לאפשר תעבורת נתונים יוצאת פרטית ומאובטחת. כך הסוכנים יכולים לגשת בצורה מאובטחת למשאבים ברשתות ה-VPC או ברשתות המקומיות.

במאמר הזה מוסבר איך להשתמש בממשק PSC עם Agent Runtime.

סקירה כללית

הנציג שלכם פרוס ברשת מאובטחת בניהול Google, בלי גישה לרשת הענן הווירטואלי הפרטי (VPC) שלכם. ממשק PSC יוצר גשר פרטי ומאובטח לרשת שלכם, ולכן הוא הפתרון המומלץ לאינטראקציה עם שירותים שמתארחים באופן פרטי ב-VPC, בסביבות מקומיות ובסביבות מרובות עננים.

כשמגדירים ממשק PSC, Agent Runtime מקצה ממשק בפרויקט של דייר בבעלות Google שבו הסוכן פועל. הממשק הזה מתחבר ישירות לחיבור לרשת בפרויקט שלכם. כל התנועה בין הנציג לבין ה-VPC עוברת באופן מאובטח בתוך הרשת של Google, ולא עוברת דרך האינטרנט הציבורי.

בנוסף למתן גישה פרטית, ממשק PSC נדרש כדי לאפשר גישה לאינטרנט כשמשתמשים ב-VPC Service Controls.

היכולת של הסוכן לגשת לאינטרנט הציבורי תלויה בהגדרות האבטחה של הפרויקט, ובמיוחד אם אתם משתמשים ב-VPC Service Controls.

  • בלי VPC Service Controls: כשמגדירים את הנציג רק עם ממשק PSC, התנועה מהנציג מנותבת ל-VPC. כברירת מחדל, ה-VPC לא מספק נתיב יוצא לאינטרנט הציבורי לתנועה הזו. כדי לאפשר לנציג גישה לאינטרנט, צריך להגדיר במפורש נתיב תעבורת נתונים יוצאת ב-VPC. לדוגמה, אתם יכולים להגדיר מכונה וירטואלית ייעודית של שרת proxy ב-VPC. מידע נוסף זמין ב-Codelab בנושא ממשק PSC של Agent Runtime.

  • עם VPC Service Controls: כשהפרויקט הוא חלק מהיקף של VPC Service Controls, הגישה של הסוכן לאינטרנט כברירת מחדל נחסמת על ידי ההיקף כדי למנוע זליגת נתונים. כדי לאפשר לסוכן לגשת לאינטרנט הציבורי בתרחיש הזה, צריך להגדיר באופן מפורש נתיב מאובטח לתעבורת נתונים יוצאת (egress) שמנתב את התנועה דרך ה-VPC. הדרך המומלצת לעשות זאת היא להגדיר שרת proxy בתוך היקף ה-VPC וליצור שער Cloud NAT כדי לאפשר למכונה הווירטואלית של שרת ה-proxy לגשת לאינטרנט.

פרטי ההגדרה של ממשק Private Service Connect

כדי להפעיל חיבור מבודד לנציג שפרסתם באמצעות ממשק Private Service Connect, אתם צריכים להגדיר רשת VPC, רשת משנה ומחבר רשת בפרויקט המשתמש שלכם.

הדרישות לגבי טווח כתובות ה-IP של רשת המשנה

ל-Agent Runtime נדרשת רשת משנה של ‎/28 לפחות לכל פרויקט משתמש של Agent Engine.

תת-הרשת של מחבר הרשת תומכת בכתובות RFC 1918 ובכתובות שאינן RFC 1918, למעט תת-הרשתות 100.64.0.0/20 ו-240.0.0.0/4. ‫Agent Runtime יכול להתחבר רק לטווחי כתובות IP מסוג RFC 1918 שאפשר לנתב מהרשת שצוינה. ‫Agent Runtime לא יכול להגיע לכתובת IP ציבורית בשימוש פרטי או לטווחים הבאים שלא שייכים ל-RFC 1918:

  • 100.64.0.0/20
  • 192.0.0.0/24
  • 192.0.2.0/24
  • 198.18.0.0/15
  • 198.51.100.0/24
  • 203.0.113.0/24
  • 240.0.0.0/4

מידע נוסף זמין במאמר הגדרת ממשק Private Service Connect.

שימוש בממשק Private Service Connect עם VPC משותף

אתם יכולים להשתמש בממשק Private Service Connect עם ארכיטקטורת VPC משותף, שמאפשרת ליצור את Agent Runtime בפרויקט שירות תוך שימוש ברשת מפרויקט מארח מרכזי.

כדי שפרויקט השירות ישתמש ברשת של הפרויקט המארח, סוכן השירות של Agent Platform מפרויקט השירות צריך את התפקיד Compute Network User‏ (roles/compute.networkUser) בפרויקט המארח.

כך עושים את זה:

  1. יוצרים את רשת המשנה בפרויקט המארח.

  2. יוצרים את חיבור הרשת בפרויקט השירות או בפרויקט המארח. אפשר ליצור את מחבר הרשת בכל פרויקט שמחובר ל-VPC המשותף, אבל כדי לפשט את ההרשאות, מומלץ למקם את מחבר הרשת בפרויקט השירות:

    • חיבור רשת בפרויקט השירות (מומלץ): מקצים את התפקיד "אדמין של רשת Compute"‏ (roles/compute.networkAdmin) לסוכן השירות של Agent Platform בפרויקט השירות. התפקיד הזה נדרש כדי שסוכן השירות יוכל לעדכן את חיבור הרשת כך שיקבל תנועה מהפרויקט הפנימי של Google. אם אתם לא רוצים להשתמש בתפקיד "אדמין של רשת Compute", אתם יכולים ליצור תפקיד בהתאמה אישית עם ההרשאות הבאות ולהקצות אותו לסוכן השירות של פלטפורמת הסוכנים בפרויקט השירות:

      • compute.networkAttachments.get
      • compute.networkAttachments.update
      • compute.regionOperations.get

    • חיבור רשת בפרויקט המארח: מבצעים את השלבים הבאים:

      1. מפעילים את Agent Platform API בפרויקט המארח. מידע נוסף זמין במאמר הגדרת ממשק Private Service Connect.

      2. אם סוכן השירות של Agent Platform לא קיים בפרויקט המארח, יוצרים אותו באמצעות הפקודה הבאה:

        gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT_ID
        

        ‫PROJECT_ID הוא מזהה הפרויקט.

      3. מקצים את התפקיד "אדמין רשת של Compute"‏ (roles/compute.networkAdmin) לסוכן השירות של Agent Platform בפרויקט המארח. מידע נוסף זמין במאמר הגדרת ממשק Private Service Connect. אם אתם לא רוצים להשתמש בתפקיד "אדמין של רשת Compute", אתם יכולים ליצור תפקיד בהתאמה אישית עם ההרשאות הבאות ולהקצות אותו לסוכן השירות של פלטפורמת הסוכנים בפרויקט המארח:

        • compute.networkAttachments.get
        • compute.networkAttachments.update
        • compute.regionOperations.get

קישור בין רשתות שכנות (peering) ב-DNS

ממשק Private Service Connect מספק את נתיב הרשת המאובטח, וקישור בין רשתות שכנות (peering) ב-DNS מספק את מנגנון זיהוי השירותים. בממשק PSC, צריך לדעת את כתובת ה-IP הספציפית של השירות ברשת ה-VPC. אפשר להתחבר לשירותים באמצעות כתובות ה-IP הפנימיות שלהם, אבל לא מומלץ לעשות את זה במערכות בסביבת הייצור שבהן כתובות ה-IP יכולות להשתנות. באמצעות קישור בין רשתות שכנות (peering) ב-DNS, הסוכן שנפרס יכול להתחבר לשירותים ברשת ה-VPC שלכם באמצעות שמות DNS יציבים וקריאים לאנשים, במקום כתובות IP. קישור בין רשתות שכנות (peering) ב-DNS מאפשר לסוכנים שנפרסו לזהות שמות DNS באמצעות הרשומות מאזור פרטי של Cloud DNS ב-VPC. מידע נוסף זמין במאמר הגדרת קישור בין רשתות שכנות (peering) ב-DNS פרטי.

מגבלות

הממשק של Private Service Connect עם Agent Runtime כפוף למגבלות הבאות:

  • אי אפשר לשנות ממשק קיים של Private Service Connect לסוכן של סביבת זמן ריצה בלי ליצור מחדש את המשאבים.

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

מדריך

חמש דרכים לפרוס סוכן ב-Agent Platform Runtime, בהתאם לצורכי הפיתוח שלכם.