ניהול שירותים שפורסמו

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

לכל קובץ מצורף של שירות יש העדפת חיבור שקובעת אם החיבורים יאושרו באופן אוטומטי.

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

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

מומלץ לאשר במפורש את החיבורים לצרכנים נבחרים. יכול להיות שיהיה לכם נוח לאשר אוטומטית את כל החיבורים אם אתם שולטים בגישת הצרכנים באמצעים אחרים ורוצים לאפשר גישה לשירות שלכם.

מידע נוסף על פרסום שירות זמין במאמר פרסום שירות.

תפקידים

תפקיד ה-IAM הבא מספק את ההרשאות שנדרשות לביצוע המשימות במדריך הזה.

• אדמין ברשת Compute (roles/compute.networkAdmin)

ניהול הגישה לשירות שפורסם

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

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

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

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

ההרשאות שנדרשות למשימה הזו

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

הרשאות

• compute.serviceAttachments.update

תפקידים

מידע על תפקידים מופיע במאמר תפקידים.

המסוף

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

איך צופים בפרטים של שירות שפורסם

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לנהל.

אישור או דחייה של בקשות לחיבור

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

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

1. לוחצים על עריכת פרטי השירות.
2. אופציונלי: בוחרים העדפה חדשה לחיבור.

3. מבצעים את השלב הרלוונטי. אפשר לחזור על השלב הזה לכל צרכן שרוצים להוסיף.

   • בקטע Accept connections for selected projects (אישור חיבורים לפרויקטים נבחרים), לוחצים על Add accepted project (הוספת פרויקט שאושר), ואז מזינים את הפרויקט ואת מגבלת החיבורים.
   • בקטע Accept connections for selected networks (אישור חיבורים לרשתות נבחרות), לוחצים על Add accepted network (הוספת רשת שאושר לה חיבור) ומזינים את הפרויקט, רשת ה-VPC ומגבלת החיבור.

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

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

gcloud

1. כדי לראות את החיבורים הקיימים והממתינים לצירוף השירות שרוצים לשנות, משתמשים בפקודה gcloud compute service-attachments describe.

   gcloud compute service-attachments describe ATTACHMENT_NAME \
       --region=REGION
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.

   הפלט אמור להיראות כך: אם יש חיבורים צרכניים בהמתנה, הם מופיעים עם הסטטוס PENDING. ה-URI מבוסס-המזהה של נקודת הקצה ב-Private Service Connect, שבו אפשר להשתמש כדי לאשר או לדחות נקודות קצה ספציפיות, מוצג בשדה endpointWithId.

   בדוגמת הפלט הזו, הפרויקט CONSUMER_PROJECT_1 נמצא ברשימת ההיתרים, ולכן הפרויקט ENDPOINT_1 מתקבל ויכול להתחבר לשירות. הפרויקט CONSUMER_PROJECT_2 לא נמצא ברשימת הפרויקטים המאושרים, ולכן הפרויקט ENDPOINT_2 נמצא בהמתנה. אחרי שמוסיפים את CONSUMER_PROJECT_2 לרשימת ההיתרים, הסטטוס של ENDPOINT_2 משתנה ל-ACCEPTED, ונקודת הקצה יכולה להתחבר לשירות.

   connectedEndpoints:
   - consumerNetwork: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_1/global/networks/CONSUMER_NETWORK_1
     endpoint: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_1/regions/REGION_1/forwardingRules/ENDPOINT_1
     endpointWithId: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_1/regions/REGION_1/forwardingRules/RESOURCE_ID_1
     pscConnectionId: 'ENDPOINT_1_ID'
     status: ACCEPTED
   - consumerNetwork: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_2/global/networks/CONSUMER_NETWORK_2
     endpoint: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_2/regions/REGION_2/forwardingRules/ENDPOINT_2
     endpointWithId: https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_2/regions/REGION_2/forwardingRules/RESOURCE_ID_2
     pscConnectionId: 'ENDPOINT_2_ID'
     status: PENDING
   connectionPreference: ACCEPT_MANUAL
   consumerAcceptLists:
   - connectionLimit: LIMIT_1
     projectIdOrNum: CONSUMER_PROJECT_1
   creationTimestamp: 'TIMESTAMP'
   description: 'DESCRIPTION'
   enableProxyProtocol: false
   fingerprint: FINGERPRINT
   id: 'ID'
   kind: compute#serviceAttachment
   name: NAME
   natSubnets:
   - https://www.googleapis.com/compute/v1/projects/PRODUCER_PROJECT/regions/REGION/subnetworks/PSC_SUBNET
   pscServiceAttachmentId:
     high: 'PSC_ATTACH_ID_HIGH'
     low: 'PSC_ATTACH_ID_LOW'
   region: https://www.googleapis.com/compute/v1/projects/PRODUCER_PROJECT/regions/REGION
   selfLink: https://www.googleapis.com/compute/v1/projects/projects/PRODUCER_PROJECT/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   targetService: https://www.googleapis.com/compute/v1/projects/PRODUCER_PROJECT/regions/REGION/forwardingRules/PRODUCER_FWD_RULE
   

2. כדי לאשר או לדחות חיבורים של צרכנים:

   • כדי לאשר או לדחות צרכנים על סמך פרויקט או רשת VPC, משתמשים בפקודה gcloud compute service-attachments update.

     אפשר לציין --consumer-accept-list או --consumer-reject-list, או את שניהם. אפשר לציין כמה ערכים ב---consumer-accept-list וב---consumer-reject-list. אפשר לכלול פרויקטים או רשתות של VPC, אבל לא שילוב של פרויקטים ורשתות.

     gcloud compute service-attachments update ATTACHMENT_NAME \
         --region=REGION \
         --consumer-accept-list=ACCEPTED_PROJECT_OR_NETWORK_1=LIMIT_1,ACCEPTED_PROJECT_OR_NETWORK_2=LIMIT_2 \
         --consumer-reject-list=REJECTED_PROJECT_OR_NETWORK_1,REJECTED_PROJECT_OR_NETWORK_2
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

     • ‫REGION: האזור שבו נמצאת ההצמדה לשירות.

     • ‫ACCEPTED_PROJECT_OR_NETWORK_1 ו-ACCEPTED_PROJECT_OR_NETWORK_2: מזהי הפרויקטים, שמות הפרויקטים או כתובות ה-URL של הרשתות שרוצים לאשר. הפרמטר --consumer-accept-list הוא אופציונלי ויכול להכיל פרויקט אחד או יותר או רשתות, אבל לא שילוב של שני הסוגים.

     • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבור לפרויקטים או לרשתות. מגבלת החיבור היא מספר נקודות הקצה של הצרכנים שיכולות להתחבר לשירות הזה.

     • ‫REJECTED_PROJECT_OR_NETWORK_1 ו-REJECTED_PROJECT_OR_NETWORK_2: מזהי הפרויקטים, שמות הפרויקטים או כתובות ה-URL של הרשתות שרוצים לדחות. ‫--consumer-reject-list הוא אופציונלי ויכול להכיל פרויקט אחד או יותר או רשתות, אבל לא שילוב של שני הסוגים.

   • כדי לאשר או לדחות נקודות קצה ספציפיות של Private Service Connect, משתמשים בפקודה gcloud compute service-attachments update.

     gcloud compute service-attachments update ATTACHMENT_NAME \
         --region=REGION \
         --consumer-accept-list=ACCEPTED_ENDPOINT_URI_1,ACCEPTED_ENDPOINT_URI_2 \
         --consumer-reject-list=REJECTED_ENDPOINT_URI_1,REJECTED_ENDPOINT_URI_2
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫ACCEPTED_ENDPOINT_URI_1 ו-ACCEPTED_ENDPOINT_URI_2: מזהי ה-URI מבוססי המזהה של נקודת קצה אחת או יותר של Private Service Connect שרוצים לאשר. כדי למצוא URI מבוסס-מזהה של נקודת קצה (endpoint) של Private Service Connect, מתארים קובץ מצורף עם שירות מחובר ובודקים את השדה endpointWithId, או מתארים את נקודת הקצה (endpoint) של Private Service Connect ובודקים את השדה selfLinkWithId. --consumer-accept-list הוא אופציונלי.

       לדוגמה, מזהה המשאבים האחיד (URI) שמבוסס על מזהה של נקודת קצה (endpoint) ממתינה של Private Service Connect בדוגמה של הפלט בתחילת הקטע הזה הוא https://www.googleapis.com/compute/v1/projects/CONSUMER_PROJECT_2/regions/REGION_2/forwardingRules/RESOURCE_ID_2

     • ‫REJECTED_ENDPOINT_URI_1 ו-REJECTED_ENDPOINT_URI_2: מזהי ה-URI שמבוססים על מזהים של נקודות קצה אחת או יותר של Private Service Connect שצריך לדחות. השדה --consumer-reject-list הוא אופציונלי.

API

1. כדי לתאר את קובץ השירות שרוצים לשנות, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

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

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. כדי לאשר או לדחות פרויקטים או רשתות של צרכנים, שולחים בקשה ל-method‏ serviceAttachments.patch.

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

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

     ה-method של ה-HTTP וכתובת ה-URL:

     PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
     

     תוכן בקשת JSON:

     {
       "consumerAcceptLists": [
         {
           "projectIdOrNum": "ACCEPTED_PROJECT_1",
           "connectionLimit": "LIMIT_1"
         },
         {
           "projectIdOrNum": "ACCEPTED_PROJECT_2",
           "connectionLimit": "LIMIT_2"
         }
       ],
       "consumerRejectLists": [
         "REJECTED_PROJECT_1",
         "REJECTED_PROJECT_2"
       ],
       "fingerprint" : "FINGERPRINT"
     }
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
     • ‫REGION: האזור של קובץ השירות המצורף.
     • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.
     • ‫ACCEPTED_PROJECT_1 ו-ACCEPTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לאשר. consumerAcceptList הוא אופציונלי ויכול לכלול פרויקט אחד או יותר.
     • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבורים לפרויקטים. מגבלת החיבור היא מספר נקודות הקצה של הצרכנים שיכולות להתחבר לשירות הזה.
     • ‫REJECTED_PROJECT_1 ו-REJECTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לדחות. consumerRejectList הוא אופציונלי ויכול לכלול פרויקט אחד או יותר.
     • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב הקודם.

   • כדי לאשר או לדחות צרכנים על סמך רשת VPC, שולחים את הבקשה הבאה.

     ה-method של ה-HTTP וכתובת ה-URL:

     PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
     

     תוכן בקשת JSON:

     {
       "consumerAcceptLists": [
         {
           "networkUrl": "projects/ACCEPTED_PROJECT_ID_1/global/network/ACCEPTED_NETWORK_1",
           "connectionLimit": "LIMIT_1"
         },
         {
           "networkUrl": "projects/ACCEPTED_PROJECT_ID_2/global/network/ACCEPTED_NETWORK_2",
           "connectionLimit": "LIMIT_2"
         }
       ],
       "consumerRejectLists": [
         "projects/REJECTED_PROJECT_ID_1/global/networks/REJECTED_NETWORK_1",
         "projects/REJECTED_PROJECT_ID_2/global/network/REJECTED_NETWORK_2"
       ],
       "fingerprint": "FINGERPRINT"
     }
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫ACCEPTED_PROJECT_ID_1 ו-ACCEPTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לאשר. ‫consumerAcceptLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
     • ‫ACCEPTED_NETWORK_1 ו-ACCEPTED_NETWORK_2: שמות הרשתות שרוצים לאשר.
     • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבור לרשתות. מגבלת החיבור היא מספר נקודות הקצה של הצרכנים שיכולות להתחבר לשירות הזה.
     • ‫REJECTED_PROJECT_ID_1 ו-REJECTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לדחות. ‫consumerRejectLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
     • ‫REJECTED_NETWORK_1 ו-REJECTED_NETWORK_2: שמות הרשתות שרוצים לדחות.

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

     ה-method של ה-HTTP וכתובת ה-URL:

     PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
     

     תוכן בקשת JSON:

     {
       "consumerAcceptLists": [
         {
           "endpointUrl": "ACCEPTED_ENDPOINT_URI_1"
         },
         {
           "endpointUrl": "ACCEPTED_ENDPOINT_URI_2"
         }
       ],
       "consumerRejectLists": [
         "REJECTED_ENDPOINT_URI_1",
         "REJECTED_ENDPOINT_URI_2"
       ],
       "fingerprint": "FINGERPRINT"
     }
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫ACCEPTED_ENDPOINT_URI_1 ו-ACCEPTED_ENDPOINT_URI_2: מזהי ה-URI מבוססי המזהה של נקודת קצה אחת או יותר של Private Service Connect שרוצים לאשר. כדי למצוא URI מבוסס-מזהה של נקודת קצה מסוג Private Service Connect, מתארים את קובץ ה-attachment של שירות מקושר ובודקים את השדה endpointWithId, או מתארים את נקודת הקצה ובודקים את השדה selfLinkWithId. דוגמה ל-URI שמבוסס על מזהה: https://www.googleapis.com/compute/v1/projects/consumer-project/regions/us-central1/forwardingRules/1234567890

       הרשימה הזו היא אופציונלית.

     • ‫REJECTED_ENDPOINT_URI_1 ו-REJECTED_ENDPOINT_URI_2: מזהי ה-URI שמבוססים על מזהים של נקודות קצה אחת או יותר של Private Service Connect שצריך לדחות. הרשימה הזו היא אופציונלית.

שינוי העדפת החיבור לשירות שפורסם

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

אם ניהול חיבורים מושבת, שינוי העדפת החיבור לא ישפיע על חיבורים קיימים של ACCEPTED או REJECTED:

• כשעוברים מאישור אוטומטי לאישור מפורש, חיבורים חדשים צריכים להיות ברשימת האישורים של הצרכן כדי להיות ACCEPTED.
• כשעוברים מאישור מפורש לאישור אוטומטי, כל החיבורים הקיימים של PENDING ACCEPTED באופן אוטומטי.

אם ניהול חיבורים מופעל, כל החיבורים הקיימים מוערכים מחדש על סמך העדפת החיבור החדשה:

• כשעוברים מאישור אוטומטי לאישור מפורש, כל החיבורים הקיימים של צרכנים שלא נמצאים ברשימת הצרכנים המאושרים משתנים לPENDING והחיבורים האלה מסתיימים.
• כשעוברים מאישור מפורש לאישור אוטומטי, כל החיבורים הקיימים PENDING וREJECTED משתנים לACCEPTED.

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

ההרשאות שנדרשות למשימה הזו

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

הרשאות

• compute.serviceAttachments.update

תפקידים

מידע על תפקידים מופיע במאמר תפקידים.

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן ואז על עריכת פרטי השירות.

4. בוחרים את העדפת החיבור החדשה שרוצים להשתמש בה בשירות הזה.

5. אופציונלי: אם אתם עוברים לשימוש בהסכמה מפורשת, אתם יכולים להוסיף עכשיו צרכנים לרשימת ההסכמה שלכם, או להוסיף אותם מאוחר יותר. כדי לאשר צרכנים, מבצעים אחת מהפעולות הבאות. אפשר לחזור על השלב הזה לכל צרכן שרוצים להוסיף.

   • בקטע Accept connections for selected projects (אישור חיבורים לפרויקטים נבחרים), לוחצים על Add accepted project (הוספת פרויקט שאושר), מזינים את הפרויקט ואת מגבלת החיבורים.
   • בקטע Accept connections for selected networks (אישור חיבורים לרשתות נבחרות), לוחצים על Add accepted network (הוספת רשת שאושר לה חיבור) ומזינים את הפרויקט, רשת ה-VPC ומגבלת החיבור.
   • בקטע קבלת חיבורים לנקודות קצה נבחרות, לוחצים על הוספת נקודת קצה שאפשר לקבל ממנה חיבורים ומזינים את הפרויקט ואת מזהה נקודת הקצה.

6. לוחצים על Save.

gcloud

• כדי לשנות את העדפת החיבור של קובץ השירות מ-ACCEPT_AUTOMATIC ל-ACCEPT_MANUAL, משתמשים בפקודה gcloud compute service-attachments update.

  אתם קובעים אילו פרויקטים יכולים להתחבר לשירות באמצעות --consumer-accept-list ו---consumer-reject-list. אפשר להגדיר את רשימות האישור והדחייה כשמשנים את העדפת החיבור, או לעדכן את הרשימות מאוחר יותר.

  gcloud compute service-attachments update ATTACHMENT_NAME \
      --region=REGION \
      --connection-preference=ACCEPT_MANUAL \
      [ --consumer-accept-list=ACCEPTED_PROJECT_OR_NETWORK_1=LIMIT_1,ACCEPTED_PROJECT_OR_NETWORK_2=LIMIT_2] \
      [ --consumer-reject-list=REJECTED_PROJECT_OR_NETWORK_1,REJECTED_PROJECT_OR_NETWORK_2 ]
  

  מחליפים את מה שכתוב בשדות הבאים:

  • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

  • ‫REGION: האזור שבו נמצאת ההצמדה לשירות.

  • ‫ACCEPTED_PROJECT_OR_NETWORK_1 ו-ACCEPTED_PROJECT_OR_NETWORK_2: מזהי הפרויקטים, שמות הפרויקטים או כתובות ה-URL של הרשתות שרוצים לאשר. ‫--consumer-accept-list הוא אופציונלי ויכול להכיל פרויקט אחד או יותר או רשתות, אבל לא שילוב של שני הסוגים.

  • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבור לפרויקטים. מגבלת החיבור היא מספר נקודות הקצה של הצרכן שיכולות להתחבר לשירות הזה.

  • ‫REJECTED_PROJECT_OR_NETWORK_1 ו-REJECTED_PROJECT_OR_NETWORK_2: מזהי הפרויקטים, שמות הפרויקטים או כתובות ה-URL של הרשתות שרוצים לדחות. ‫--consumer-reject-list הוא אופציונלי ויכול להכיל פרויקט אחד או יותר או רשתות, אבל לא שילוב של שני הסוגים.

• כדי לשנות את העדפת החיבור של קובץ השירות מ-ACCEPT_MANUAL ל-ACCEPT_AUTOMATIC, משתמשים בפקודה הבאה.

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

  gcloud compute service-attachments update ATTACHMENT_NAME \
      --region=REGION \
      --connection-preference=ACCEPT_AUTOMATIC \
      --consumer-accept-list="" \
      --consumer-reject-list=""
  

  מחליפים את מה שכתוב בשדות הבאים:

  • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

  • ‫REGION: האזור שבו נמצאת ההצמדה לשירות.

API

1. כדי לקבל את fingerprint של קובץ השירות המצורף, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. כדי לשנות את העדפת החיבור של קובץ השירות, שולחים בקשה ל-method‏ serviceAttachments.patch.

   • כדי לשנות את העדפת החיבור מ-ACCEPT_AUTOMATIC ל-ACCEPT_MANUAL ולעדכן את רשימות הלקוחות שאושרו ונדחו על סמך הפרויקט, שולחים את הבקשה הבאה.

     ה-method של ה-HTTP וכתובת ה-URL:

     PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
     

     תוכן בקשת JSON:

     {
       "connectionPreference": "ACCEPT_MANUAL",
       "consumerAcceptLists": [
         {
           "projectIdOrNum": "ACCEPTED_PROJECT_1"
           "connectionLimit": "LIMIT_1",
         },
         {
           "projectIdOrNum": "ACCEPTED_PROJECT_2"
           "connectionLimit": "LIMIT_2",
         }
       ],
       "consumerRejectLists": [
         "REJECTED_PROJECT_1",
         "REJECTED_PROJECT_2",
       ],
       "fingerprint" : "FINGERPRINT"
     }
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
     • ‫REGION: האזור של קובץ השירות המצורף.
     • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.
     • ‫ACCEPTED_PROJECT_1 ו-ACCEPTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לאשר. consumerAcceptList הוא אופציונלי ויכול לכלול פרויקט אחד או יותר.
     • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבורים לפרויקטים. מגבלת החיבור היא מספר נקודות הקצה של הצרכנים שיכולות להתחבר לשירות הזה.
     • ‫REJECTED_PROJECT_1 ו-REJECTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לדחות. consumerRejectList הוא אופציונלי ויכול לכלול פרויקט אחד או יותר.
     • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב 1.

   • כדי לשנות את העדפת החיבור מ-ACCEPT_AUTOMATIC ל-ACCEPT_MANUAL ולעדכן את רשימות האישור והדחייה של הצרכנים על סמך רשת VPC, שולחים את הבקשה הבאה.

     ה-method של ה-HTTP וכתובת ה-URL:

     PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
     

     תוכן בקשת JSON:

     {
       "connectionPreference": "ACCEPT_MANUAL",
       "consumerAcceptLists": [
         {
           "networkUrl": "projects/ACCEPTED_PROJECT_ID_1/global/networks/ACCEPTED_NETWORK_1",
           "connectionLimit": "LIMIT_1"
         },
         {
           "networkUrl": "projects/ACCEPTED_PROJECT_ID_2/global/networks/ACCEPTED_NETWORK_2",
           "connectionLimit": "LIMIT_2"
         }
       ],
       "consumerRejectLists": [
         "projects/REJECTED_PROJECT_ID_1/global/networks/REJECTED_NETWORK_1",
         "projects/REJECTED_PROJECT_ID_2/global/network/REJECTED_NETWORK_2"
       ],
       "fingerprint" : "FINGERPRINT"
     }
     

     מחליפים את מה שכתוב בשדות הבאים:

     • ‫ACCEPTED_PROJECT_ID_1 ו-ACCEPTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לאשר. ‫consumerAcceptLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
     • ‫ACCEPTED_NETWORK_1 ו-ACCEPTED_NETWORK_2: השמות של הרשתות שרוצים לאשר.
     • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבור לרשתות. מגבלת החיבור היא מספר נקודות הקצה של הצרכנים שיכולות להתחבר לשירות הזה.
     • ‫REJECTED_PROJECT_ID_1 ו-REJECTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לדחות. ‫consumerRejectLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
     • ‫REJECTED_NETWORK_1 ו-REJECTED_NETWORK_2: שמות הרשתות שרוצים לדחות.
     • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב 1.

• כדי לשנות את העדפת החיבור של קובץ השירות המצורף מ-ACCEPT_MANUAL ל-ACCEPT_AUTOMATIC, שולחים את הבקשה הבאה.

  אם השדות consumerAcceptLists או consumerRejectLists מציינים צרכנים כלשהם, צריך להגדיר אותם כריקים כשמשנים את העדפת החיבור ל-ACCEPT_AUTOMATIC.

  ה-method של ה-HTTP וכתובת ה-URL:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
  

  תוכן בקשת JSON:

  {
    "connectionPreference": "ACCEPT_AUTOMATIC",
    "consumerAcceptLists": [ ],
    "consumerRejectLists": [ ],
    "fingerprint" : "FINGERPRINT"
  }
  

  מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.

  • ‫REGION: האזור של קובץ השירות המצורף.

  • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

  • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב 1.

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

אם רשימות הצרכנים שהסכימו או דחו את השימוש בנתונים שלהם מוגדרות לשימוש בנקודות קצה נפרדות, ערך יכול להישאר ברשימות גם אחרי שהצרכן מוחק את נקודת הקצה המתאימה. כדי לפשט את הניהול של רשימות הצרכנים, אפשר להשתמש בפקודה gcloud compute service-attachments update כדי להסיר ערכים של נקודות קצה שכבר לא קיימות. התכונה הזו נתמכת רק ב-Google Cloud CLI.

gcloud

gcloud compute service-attachments update ATTACHMENT_NAME \
    --region=REGION \
    --remove-obsolete-endpoint-accept-reject-entries

מחליפים את מה שכתוב בשדות הבאים:

• ‫ATTACHMENT_NAME: השם של קובץ השירות שרוצים לעדכן.
• ‫REGION: האזור של קובץ השירות המצורף.

הגדרת ניהול חיבורים

אתם יכולים להפעיל או להשבית התאמה של חיבורים לצירופי שירות קיימים.

ההרשאות שנדרשות למשימה הזו

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

הרשאות

• compute.serviceAttachments.update

תפקידים

מידע על תפקידים מופיע במאמר תפקידים.

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן ואז על עריכת פרטי השירות.

4. מסמנים או מבטלים את הסימון בתיבה הפעלת תיאום בין החיבורים ואז לוחצים על שמירה.

gcloud

• כדי להפעיל את תהליך ההתאמה של החיבורים, משתמשים בפקודה service-attachments update.

  gcloud compute service-attachments update ATTACHMENT_NAME \
      --region=REGION \
      --reconcile-connections
  

  מחליפים את מה שכתוב בשדות הבאים:

  • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.
  • ‫REGION: האזור של קובץ השירות המצורף.

• כדי להשבית את תהליך ההתאמה של החיבור, משתמשים בפקודה הבאה:

  gcloud compute service-attachments update ATTACHMENT_NAME \
      --region=REGION \
      --no-reconcile-connections
  

API

1. כדי לקבל את fingerprint של קובץ השירות המצורף, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. שליחת בקשה ל-method‏ serviceAttachments.patch.

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   תוכן בקשת JSON:

   {
     "reconcileConnections": RECONCILIATION,
     "fingerprint": "FINGERPRINT"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.
   • RECONCILIATION: האם להפעיל את תהליך ההתאמה של החיבורים. האפשרויות הן true או false.
   • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב הקודם.

הוספה או הסרה של רשתות משנה משירות שפורסם

אפשר לערוך שירות שפורסם כדי להוסיף רשתות משנה של Private Service Connect.

לדוגמה, יכול להיות שתצטרכו להקצות עוד כתובות IP לשירות קיים. כדי להוסיף עוד כתובות, מבצעים אחת מהפעולות הבאות:

• יוצרים עוד תת-רשת של Private Service Connect ועורכים את קובץ השירות המצורף כדי להוסיף את התת-רשת החדשה.

• עורכים את רשת המשנה כדי להרחיב את טווח כתובות ה-IPv4.

באופן דומה, אפשר לערוך שירות שפורסם כדי להסיר רשתות משנה של Private Service Connect. עם זאת, אם נעשה שימוש בכתובות IP של רשת המשנה כדי לבצע SNAT עבור Private Service Connect, לא ניתן להסיר את רשת המשנה.

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

ההרשאות שנדרשות למשימה הזו

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

הרשאות

• compute.serviceAttachments.update

תפקידים

מידע על תפקידים מופיע במאמר תפקידים.

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן ואז על עריכת פרטי השירות.

4. שינוי של רשתות המשנה שמשמשות את השירות הזה.

   אם רוצים להוסיף רשת משנה חדשה, אפשר ליצור אחת:

   1. לוחצים על שמירת מסנן חדש.
   2. מזינים שם ותיאור (אופציונלי) לרשת המשנה.
   3. בוחרים Region לרשת המשנה.
   4. מזינים את טווח כתובות ה-IP שרוצים להשתמש בו עבור רשת המשנה ולוחצים על הוספה.

5. לוחצים על Save.

gcloud

כדי לעדכן את רשתות המשנה של Private Service Connect שמשמשות לחיבור השירות הזה, משתמשים בפקודה gcloud compute service-attachments update.

gcloud compute service-attachments update ATTACHMENT_NAME \
    --region=REGION \
    --nat-subnets=PSC_SUBNET_LIST

מחליפים את מה שכתוב בשדות הבאים:

• ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

• ‫REGION: האזור שבו נמצאת ההצמדה לשירות.

• ‫PSC_SUBNET_LIST: רשימה מופרדת בפסיקים של רשתות משנה אחת או יותר לשימוש עם קובץ השירות המצורף הזה.

API

1. כדי לקבל את fingerprint של קובץ השירות המצורף, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. כדי לעדכן את רשתות המשנה של Private Service Connect שמשמשות לחיבור השירות הזה, שולחים בקשה ל-method‏ serviceAttachments.patch.

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   תוכן בקשת JSON:

   {
     "natSubnets": [
     "PSC_SUBNET1_URI",
     "PSC_SUBNET2_URI"
     ],
     "fingerprint": "FINGERPRINT"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.

   • ‫REGION: האזור של קובץ השירות המצורף.

   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   • ‫PSC_SUBNET1_URI ו-PSC_SUBNET2_URI: ‏URI של רשתות המשנה שבהן רוצים להשתמש עם קובץ השירות המצורף הזה. אפשר לציין תת-רשת אחת או יותר.

   • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב הקודם.

עדכון מספר כתובות ה-IP של NAT לכל נקודת קצה

אפשר לעדכן את קובץ ה-Service Attachment כדי להגדיל את מספר כתובות ה-IP של NAT שהוקצו לכל נקודת קצה (endpoint) של צרכן או לכל קצה עורפי (backend) מ-1 ל-2. כשמבצעים את הפעולה הזו, כתובות ה-IP של NAT שכבר הוקצו לא מושפעות. אי אפשר להקטין את מספר כתובות ה-IP של NAT.

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

לרשתות המשנה של ה-NAT בצירוף השירות צריך להיות מספיק קיבולת כדי להקצות כתובות IP נוספות לכל נקודת קצה שאושרה (כולל חיבורים של נקודות קצה שהועברו) ולכל קצה עורפי.

אם אין מספיק כתובות IP זמינות ברשתות המשנה של NAT, העדכון ייכשל עם השגיאה הבאה:

Insufficient IPv4 capacity on NAT subnetworks for the requested Service Attachment update.

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

ההרשאות שנדרשות למשימה הזו

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

הרשאות

• compute.serviceAttachments.update

תפקידים

מידע על תפקידים מופיע במאמר תפקידים.

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן ואז על עריכת פרטי השירות.

4. לוחצים על Allocated IPs per PSC endpoint (כתובות IP שהוקצו לכל נקודת קצה של PSC) ובוחרים באפשרות 2.

5. לוחצים על Save.

gcloud

כדי להגדיל את מספר כתובות ה-IP של NAT לכל נקודת קצה לחיבור שירות קיים, משתמשים בפקודה gcloud compute service-attachments update.

gcloud compute service-attachments update ATTACHMENT_NAME \
    --region=REGION \
    --nat-ips-per-endpoint=2

מחליפים את מה שכתוב בשדות הבאים:

• ‫ATTACHMENT_NAME: השם של קובץ השירות שרוצים לעדכן.
• ‫REGION: האזור של קובץ השירות המצורף.

API

1. כדי לקבל את fingerprint של קובץ השירות, שולחים בקשה ל-method‏ serviceAttachments.get.

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט של קובץ השירות.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

2. שולחים בקשת PATCH ל-method‏ serviceAttachments.patch.

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   {
     "natIpsPerEndpoint": 2,
     "fingerprint": "FINGERPRINT"
   }
   

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

עדכון שירות היעד

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

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

הכנה לעדכון

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

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

הודעה לצרכנים על השבתה זמנית במהלך עדכון

כדי ליידע את הצרכנים באופן מפורש שהשירות לא זמין, אפשר לבצע את השלבים הבאים:

1. מוודאים שהאפשרות ניהול חיבורים מופעלת ב-service attachment.
2. להוסיף את כל הצרכנים מרשימת ההסכמה לרשימת הדחייה. הפעולה הזו משנה את סטטוס החיבור ל-REJECTED.
3. אחרי שהעדכון יסתיים, צריך להסיר את הצרכנים מרשימת הדחייה כדי להחזיר את סטטוס החיבור למצב ACCEPTED.

הכנת צרכן לבדיקה

כדי לוודא מתי הקישוריות לשירות משוחזרת, אפשר לשלוח חבילות בדיקה לשירות ממופע בדיקה. כדי להגדיר את הבדיקה:

1. יוצרים רשת VPC לבדיקה בפרויקט.
2. ברשת ה-VPC של הבדיקה, מבצעים את הפעולות הבאות:
   • יוצרים נקודת קצה מסוג Private Service Connect שמתחברת לקובץ המצורף של השירות.
   • יצירת מופע לבדיקה
3. כדי לבדוק את החיבור, אפשר להכין את אחת מהאפשרויות הבאות:
   • מגדירים בדיקות קישוריות כדי לבדוק את הקישוריות בין מכונת הבדיקה הווירטואלית לבין נקודת הקצה. אחרי העדכון, תוכלו לנסות שוב את הבדיקה הזו כדי לדעת מתי החיבור יחזור.
   • אם רוצים לשלוח מנות בדיקה באופן ידני, מתחברים למופע הבדיקה ומוודאים שאפשר להגיע לכתובת ה-IP של נקודת הקצה באמצעות כלי כמו curl.

עדכון של קובץ השירות

כדי לעדכן את שירות היעד של קובץ השירות המצורף:

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

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן.

4. לוחצים על עריכת פרטי השירות.

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

6. בוחרים את כלל ההעברה של שירות היעד החדש.

7. לוחצים על Save.

gcloud

משתמשים בפקודה gcloud compute service-attachments update.

gcloud compute service-attachments update ATTACHMENT_NAME \
    --region=REGION \
    --target-service=TARGET_SERVICE

מחליפים את מה שכתוב בשדות הבאים:

• ‫ATTACHMENT_NAME: השם של קובץ השירות שרוצים לעדכן.
• ‫REGION: האזור של קובץ השירות המצורף.
• ‫TARGET_SERVICE: ה-URI של שירות היעד החדש, בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME

API

1. כדי לקבל את fingerprint של קובץ השירות המצורף, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. שליחת בקשה ל-method‏ serviceAttachments.patch.

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   תוכן בקשת JSON:

   {
     "targetService": "TARGET_SERVICE",
     "fingerprint": "FINGERPRINT"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫TARGET_SERVICE: ה-URI של שירות היעד החדש, בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME
   • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב הקודם.

אימות העדכון ושחזור הגישה

אם יצרתם רשת VPC ומכונה לבדיקה, ודאו שהעדכון הושלם והשירות זמין. השלב הזה הוא אופציונלי. מבצעים אחת מהפעולות הבאות:

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

כשהקישוריות תחזור, צריך לבצע את הפעולות הבאות:

1. אם הוספתם צרכנים לרשימת הדחייה, הסירו אותם מרשימת הדחייה כדי לציין שהשירות זמין.
2. אם יצרתם משאבים כדי לוודא שהעדכון הסתיים, אתם יכולים לפעול לפי השלבים הבאים כדי למחוק את המשאבים ולמנוע חיובים מיותרים:
   1. מחיקת מכונת הבדיקה
   2. מחיקת נקודת הקצה של Private Service Connect לבדיקה
   3. מחיקת רשת ה-VPC לבדיקה

עדכון מגבלת החיבורים שהועברה של שירות שפורסם

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

המסוף

1. נכנסים לדף Private Service Connect במסוף Google Cloud .

   מעבר אל Private Service Connect

2. לוחצים על הכרטיסייה שירותים שפורסמו.

3. לוחצים על השירות שרוצים לעדכן ואז על עריכת פרטי השירות.

4. לוחצים על הגדרות מתקדמות.

5. מזינים את מגבלת החיבורים החדשה שהועברה על ידי NCC.

gcloud

משתמשים בפקודה gcloud compute service-attachments update.

gcloud compute service-attachments update ATTACHMENT_NAME \
    --region=REGION \
    --propagated-connection-limit=LIMIT

מחליפים את מה שכתוב בשדות הבאים:

• ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

• ‫REGION: האזור שבו נמצאת ההצמדה לשירות.

• ‫LIMIT: הערך החדש של מגבלת החיבור שהועברה.

API

1. כדי לקבל את fingerprint של קובץ השירות המצורף, שולחים בקשה ל-method‏ serviceAttachments.get.

   ה-method של ה-HTTP וכתובת ה-URL:

   GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.
   • ‫REGION: האזור של קובץ השירות המצורף.
   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   חשוב לשים לב לערך fingerprint, שבו תשתמשו בשלב הבא.

2. שליחת בקשה ל-method‏ serviceAttachments.patch.

   ה-method של ה-HTTP וכתובת ה-URL:

   PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME
   

   תוכן בקשת JSON:

   {
     "propagatedConnectionLimit": LIMIT,
     "fingerprint": "FINGERPRINT"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: הפרויקט של קובץ השירות המצורף.

   • ‫REGION: האזור של קובץ השירות המצורף.

   • ‫ATTACHMENT_NAME: השם של קובץ השירות המצורף.

   • ‫LIMIT: הערך החדש של מגבלת החיבור שהועברה.

   • ‫FINGERPRINT: טביעת האצבע העדכנית של קובץ השירות שזיהיתם בשלב הקודם.