פרסום שירותים באמצעות Private Service Connect

המסוף

1. נכנסים לדף VPC networks במסוף Google Cloud .

   מעבר לרשתות VPC

2. לוחצים על השם של רשת VPC כדי להציג את הדף פרטי רשת ה-VPC.

3. לוחצים על Subnets (רשתות משנה).

4. לוחצים על הוספת רשת משנה. בחלונית שמופיעה, מבצעים את הפעולות הבאות:

   1. מזינים שם.
   2. בחירת אזור.
   3. בקטע מטרה, בוחרים באפשרות Private Service Connect.
   4. בקטע IP stack type, בוחרים סוג של ערימת IP.
   5. אם אתם יוצרים רשת משנה עם IPv4 בלבד או עם מחסנית כפולה, מזינים טווח כתובות IPv4 – לדוגמה, 10.10.10.0/24.
   6. אם אתם יוצרים רשת משנה עם IPv6 בלבד או עם מחסנית כפולה, לוחצים על סוג הגישה ל-IPv6 ובוחרים באפשרות פנימי.
   7. לוחצים על הוספה.

gcloud

משתמשים בפקודה gcloud compute networks subnets create.

• כדי ליצור תת-רשת של Private Service Connect עם IPv4 בלבד, מבצעים את הפעולות הבאות:

  gcloud compute networks subnets create SUBNET_NAME \
      --network=NETWORK_NAME \
      --region=REGION \
      --range=SUBNET_RANGE \
      --purpose=PRIVATE_SERVICE_CONNECT
  

• כדי ליצור תת-רשת של Private Service Connect עם תמיכה ב-IPv4 ו-IPv6, מבצעים את הפעולות הבאות:

  gcloud compute networks subnets create SUBNET_NAME \
      --network=NETWORK_NAME \
      --region=REGION \
      --stack-type=IPV4_IPV6 \
      --ipv6-access-type=INTERNAL \
      --range=SUBNET_RANGE \
      --purpose=PRIVATE_SERVICE_CONNECT
  

• כדי ליצור תת-רשת של Private Service Connect עם IPv6 בלבד, מבצעים את הפעולות הבאות:

  gcloud compute networks subnets create SUBNET_NAME \
      --network=NETWORK_NAME \
      --region=REGION \
      --stack-type=IPV6_ONLY \
      --ipv6-access-type=INTERNAL \
      --purpose=PRIVATE_SERVICE_CONNECT
  

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

• ‫SUBNET_NAME: השם שרוצים להקצות לרשת המשנה.

• ‫NETWORK_NAME: השם של ה-VPC לתת-הרשת החדשה.

• ‫REGION: האזור של רשת המשנה החדשה. האזור הזה צריך להיות זהה לאזור של השירות שאתם מפרסמים.

• ‫SUBNET_RANGE: טווח כתובות IPv4 לשימוש ברשת המשנה – לדוגמה, 10.10.10.0/24.

API

שולחים בקשת POST ל-method‏ subnetworks.insert.

• כדי ליצור תת-רשת של Private Service Connect עם IPv4 בלבד, מבצעים את הפעולות הבאות:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
  
  {
    "ipCidrRange": "SUBNET_RANGE",
    "name": "SUBNET_NAME",
    "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
    "purpose": "PRIVATE_SERVICE_CONNECT"
  }
  

• כדי ליצור תת-רשת של Private Service Connect עם תמיכה ב-IPv4 ו-IPv6, מבצעים את הפעולות הבאות:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
  
  {
    "ipCidrRange": "SUBNET_RANGE",
    "name": "SUBNET_NAME",
    "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
    "purpose": "PRIVATE_SERVICE_CONNECT",
    "stackType": "IPV4_IPV6",
    "ipv6AccessType": "INTERNAL"
  }
  

• כדי ליצור תת-רשת של Private Service Connect עם IPv6 בלבד, מבצעים את הפעולות הבאות:

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/subnetworks
  
  {
    "name": "SUBNET_NAME",
    "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
    "purpose": "PRIVATE_SERVICE_CONNECT",
    "stackType": "IPV6_ONLY",
    "ipv6AccessType": "INTERNAL"
  }
  

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

• ‫PROJECT_ID: הפרויקט של רשת המשנה.

• ‫REGION: האזור של רשת המשנה החדשה. האזור הזה צריך להיות זהה לאזור של השירות שאתם מפרסמים.

• ‫SUBNET_RANGE: טווח כתובות IPv4 לשימוש ברשת המשנה. לדוגמה, 10.10.10.0/24.

• ‫SUBNET_NAME: השם שרוצים להקצות לרשת המשנה.

• ‫NETWORK_NAME: השם של רשת ה-VPC של תת-הרשת החדשה.

המסוף

הגדרת השירות

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

   מעבר אל Private Service Connect

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

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

4. בקטע פרטי יעד, בוחרים באפשרות מאזן עומסים.

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

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

   אדמינים של פרויקט שירות יכולים לבחור מאזן עומסים פנימי עם כתובת IP מרשת VPC משותפת. מידע נוסף זמין במאמר בנושא VPC משותף.

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

8. בשדה Service name, מזינים שם לחיבור השירות.

בחירת רשת משנה של Private Service Connect

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

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

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

1. לוחצים על Subnets (רשתות משנה) ואז על Reserve new subnet (שמירת רשת משנה חדשה).
2. מזינים שם ותיאור אופציונלי לרשת המשנה.
3. בוחרים אזור לרשת המשנה.
4. בוחרים סוג של ערימת פרוטוקולים.
5. אם אתם יוצרים רשת משנה עם IPv4 בלבד או עם מחסנית כפולה, מזינים טווח כתובות IPv4 לשימוש ברשת המשנה.
6. לוחצים על הוספה.

השלמת ההגדרה

1. כדי להציג את פרטי החיבור של הצרכן, בוחרים באפשרות Use Proxy Protocol (שימוש בפרוטוקול Proxy).
2. בוחרים באפשרות אישור אוטומטי של כל החיבורים.
3. כדי להשבית את התאמת החיבורים, מבטלים את הסימון בתיבה הפעלת התאמת החיבורים.

4. אופציונלי: לוחצים על הגדרות מתקדמות ומבצעים את הפעולות הבאות:

   1. אם רוצים להגדיר שם דומיין, מזינים שם דומיין, כולל נקודה בסוף.

      הפורמט המומלץ לשם הדומיין הוא REGION.p.DOMAIN.

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

   2. מזינים מגבלה על חיבורים שהועברו. אם לא מציינים ערך, ערך ברירת המחדל הוא 250.

5. לוחצים על הוספת שירות.

gcloud

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

gcloud compute service-attachments create ATTACHMENT_NAME \
    --region=ATTACHMENT_REGION \
    --target-service=TARGET_SERVICE \
    --connection-preference=ACCEPT_AUTOMATIC \
    --nat-subnets=PSC_SUBNET_LIST \
    [ --propagated-connection-limit=PROPAGATED_CONNECTION_LIMIT ] \
    [ --enable-proxy-protocol ] \
    [ --domain-names=DOMAIN_NAME ]

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

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

• ‫ATTACHMENT_REGION: האזור של קובץ השירות החדש. האזור הזה צריך להיות זהה לאזור של כתובת ה-IP של כלל ההעברה של היעד.

• ‫TARGET_SERVICE: ה-URI של כלל ההעברה שמשויך לשירות שאתם מפרסמים.

  • במאזני עומסים פנימיים של אפליקציות (ALB) חוצי-אזורים, משתמשים בפורמט הבא: projects/PROJECT_ID/global/forwardingRules/RULE_NAME
  • לכל שאר כללי ההעברה של היוצרים, משתמשים בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME

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

• ‫PSC_SUBNET_LIST: רשימה מופרדת בפסיקים של שמות של רשתות משנה (לפחות אחת) לשימוש עם שירות ה-Service Attachment הזה.

  אם אתם יוצרים קובץ מצורף לשירות עם כלל העברה שכולל כתובת IP מרשת VPC משותפת, אתם צריכים להשתמש ברשתות משנה משותפות מאותה רשת VPC משותפת. לכל תת-רשת משותפת, מציינים את ה-URI המלא של המשאב – לדוגמה, --nat-subnets=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET.

• ‫PROPAGATED_CONNECTION_LIMIT: מכסת החיבורים שהועברה לכל פרויקט. ערך ברירת המחדל הוא 250.

• ‫DOMAIN_NAME: שם דומיין DNS של השירות, כולל נקודה בסוף. פורמט מומלץ: REGION.p.DOMAIN.

  מידע נוסף זמין במאמר בנושא הגדרת DNS.

API

שולחים בקשת POST ל-method‏ serviceAttachments.insert.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
{
  "name": "ATTACHMENT_NAME",
  "connectionPreference": "ACCEPT_AUTOMATIC",
  "targetService": "TARGET_SERVICE",
  "enableProxyProtocol": false,
  "natSubnets": [
    "PSC_SUBNET_1_URI",
    "PSC_SUBNET_2_URI"
  ],
  "propagatedConnectionLimit": "PROPAGATED_CONNECTION_LIMIT",
  "domainNames": [
    "DOMAIN_NAME"
  ]
}

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

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

• ‫ATTACHMENT_REGION: האזור של קובץ השירות החדש. האזור הזה צריך להיות זהה לאזור של כתובת ה-IP של כלל ההעברה של היעד.

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

• ‫TARGET_SERVICE: ה-URI של כלל ההעברה המשויך לשירות שאתם מפרסמים.

  • במאזני עומסים פנימיים של אפליקציות (ALB) חוצי-אזורים, משתמשים בפורמט הבא: projects/PROJECT_ID/global/forwardingRules/RULE_NAME
  • לכל שאר כללי ההעברה של היוצרים, משתמשים בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME

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

• ‫PSC_SUBNET_1_URI ו-PSC_SUBNET_2_URI: כתובות ה-URI של רשתות המשנה שבהן יש להשתמש לחיבור השירות הזה. אפשר לציין רשת משנה אחת או יותר באמצעות URI.

  אם אתם יוצרים קובץ מצורף לשירות עם כלל העברה שכולל כתובת IP מרשת VPC משותפת, אתם צריכים להשתמש ברשתות משנה משותפות מאותה רשת VPC משותפת.

• ‫DOMAIN_NAME: שם דומיין DNS של השירות, כולל נקודה בסוף. פורמט מומלץ: REGION.p.DOMAIN.

  מידע נוסף זמין במאמר בנושא הגדרת DNS.

• ‫PROPAGATED_CONNECTION_LIMIT: מכסת החיבורים שהועברה לכל פרויקט. ערך ברירת המחדל הוא 250.

המסוף

הגדרת השירות

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

   מעבר אל Private Service Connect

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

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

4. בקטע פרטי יעד, בוחרים באפשרות מאזן עומסים.

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

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

   אדמינים של פרויקט שירות יכולים לבחור מאזן עומסים פנימי עם כתובת IP מרשת VPC משותפת. מידע נוסף זמין במאמר בנושא VPC משותף.

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

8. בשדה Service name, מזינים שם לחיבור השירות.

בחירת רשת משנה של Private Service Connect

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

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

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

1. לוחצים על Subnets (רשתות משנה) ואז על Reserve new subnet (שמירת רשת משנה חדשה).
2. מזינים שם ותיאור אופציונלי לרשת המשנה.
3. בוחרים אזור לרשת המשנה.
4. בוחרים סוג של ערימת פרוטוקולים.
5. אם אתם יוצרים רשת משנה עם IPv4 בלבד או עם מחסנית כפולה, מזינים טווח כתובות IPv4 לשימוש ברשת המשנה.
6. לוחצים על הוספה.

הגדרת גישה לצרכנים

1. כדי לראות את פרטי החיבור של הלקוח, בוחרים באפשרות Use Proxy Protocol (שימוש בפרוטוקול Proxy).

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

   • כדי לאשר חיבורים לפרויקטים נבחרים, בוחרים באפשרות אישור חיבורים לפרויקטים נבחרים, ואז:

     1. לכל פרויקט שרוצים לאשר ממנו חיבורים, לוחצים על Add accepted project ומזינים את הפרטים הבאים:

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

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

   • כדי לאשר חיבורים לרשתות שנבחרו, בוחרים באפשרות Accept connections for selected networks (אישור חיבורים לרשתות שנבחרו), ואז:

     1. לכל רשת VPC שרוצים לאשר ממנה חיבורים, לוחצים על הוספת רשת שאושרה ומזינים את הפרטים הבאים:

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

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

   • כדי לאשר חיבורים לנקודות קצה ספציפיות של Private Service Connect, בוחרים באפשרות Accept connections for selected projects. בשלב הזה, אל תוסיפו ערכים לרשימת ההיתרים של הצרכנים. אחרי שצרכן מבקש להתחבר לשירות שלכם, אתם יכולים להוסיף את נקודת הקצה לרשימת הצרכנים המורשים.

השלמת ההגדרה

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

2. אופציונלי: לוחצים על הגדרות מתקדמות ומבצעים את הפעולות הבאות:

   1. אם רוצים להגדיר שם דומיין, מזינים שם דומיין, כולל נקודה בסוף.

      הפורמט המומלץ לשם הדומיין הוא REGION.p.DOMAIN.

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

   2. מזינים מגבלה על חיבורים שהועברו. אם לא מציינים ערך, ערך ברירת המחדל הוא 250.

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

gcloud

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

gcloud compute service-attachments create ATTACHMENT_NAME \
    --region=ATTACHMENT_REGION \
    --target-service=TARGET_SERVICE \
    --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 \
    --nat-subnets=PSC_SUBNET_LIST \
    [ --propagated-connection-limit=PROPAGATED_CONNECTION_LIMIT ] \
    [ --enable-proxy-protocol ] \
    [ --domain-names=DOMAIN_NAME ] \
    [ --reconcile-connections ]

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

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

• ‫ATTACHMENT_REGION: האזור של קובץ השירות החדש. האזור הזה צריך להיות זהה לאזור של כתובת ה-IP של כלל ההעברה של היעד.

• ‫TARGET_SERVICE: ה-URI של כלל ההעברה שמשויך לשירות שאתם מפרסמים.

  • במאזני עומסים פנימיים של אפליקציות (ALB) חוצי-אזורים, משתמשים בפורמט הבא: projects/PROJECT_ID/global/forwardingRules/RULE_NAME
  • לכל שאר כללי ההעברה של היוצרים, משתמשים בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME

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

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

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

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

• ‫PSC_SUBNET_LIST: רשימה מופרדת בפסיקים של שמות של רשתות משנה (לפחות אחת) לשימוש עם שירות ה-Service Attachment הזה.

  אם אתם יוצרים קובץ מצורף לשירות עם כלל העברה שכולל כתובת IP מרשת VPC משותפת, אתם צריכים להשתמש ברשתות משנה משותפות מאותה רשת VPC משותפת. לכל תת-רשת משותפת, מציינים את ה-URI המלא של המשאב – לדוגמה, --nat-subnets=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET.

• ‫PROPAGATED_CONNECTION_LIMIT: מגבלת החיבורים שהועברה. ערך ברירת המחדל הוא 250.

• ‫DOMAIN_NAME: שם דומיין DNS של השירות, כולל נקודה בסוף. פורמט מומלץ: REGION.p.DOMAIN.

  מידע נוסף זמין במאמר בנושא הגדרת DNS.

API

שולחים בקשת POST ל-method‏ serviceAttachments.insert.

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
  {
    "name": "ATTACHMENT_NAME",
    "region": "ATTACHMENT_REGION",
    "connectionPreference": "ACCEPT_MANUAL",
    "targetService": "TARGET_SERVICE",
    "enableProxyProtocol": false,
    "natSubnets": [
      "PSC_SUBNET_1_URI",
      "PSC_SUBNET_2_URI"
    ],
    "consumerRejectLists": [
      "REJECTED_PROJECT_1",
      "REJECTED_PROJECT_2"
    ],
    "consumerAcceptLists": [
      {
        "projectIdOrNum": "ACCEPTED_PROJECT_1",
        "connectionLimit": "LIMIT_1"
      },
      {
        "projectIdOrNum": "ACCEPTED_PROJECT_2",
        "connectionLimit": "LIMIT_2"
      }
    ],
    "propagatedConnectionLimit": "PROPAGATED_CONNECTION_LIMIT",
    "domainNames": [
      "DOMAIN_NAME"
    ]
  }
  

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

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

  • ‫ATTACHMENT_REGION: האזור של קובץ השירות החדש. האזור הזה צריך להיות זהה לאזור של כתובת ה-IP של כלל ההעברה של היעד.

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

  • ‫TARGET_SERVICE: ה-URI של כלל ההעברה המשויך לשירות שאתם מפרסמים.

    • במאזני עומסים פנימיים של אפליקציות (ALB) חוצי-אזורים, משתמשים בפורמט הבא: projects/PROJECT_ID/global/forwardingRules/RULE_NAME
    • לכל שאר כללי ההעברה של היוצרים, משתמשים בפורמט הבא: projects/PROJECT_ID/regions/RULE_REGION/forwardingRules/RULE_NAME

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

  • ‫PSC_SUBNET_1_URI ו-PSC_SUBNET_2_URI: כתובות ה-URI של רשתות המשנה שבהן יש להשתמש לחיבור השירות הזה. אפשר לציין רשת משנה אחת או יותר באמצעות URI.

    אם אתם יוצרים קובץ מצורף לשירות עם כלל העברה שכולל כתובת IP מרשת VPC משותפת, אתם צריכים להשתמש ברשתות משנה משותפות מאותה רשת VPC משותפת.

  • ‫REJECTED_PROJECT_1 ו-REJECTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לדחות. ‫consumerRejectLists הוא אופציונלי ויכול להכיל פרויקט אחד או יותר.

  • ‫ACCEPTED_PROJECT_1 ו-ACCEPTED_PROJECT_2: מזהי הפרויקטים או מספרי הפרויקטים שרוצים לאשר. ‫consumerAcceptLists הוא אופציונלי ויכול להכיל פרויקט אחד או יותר.

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

  • ‫PROPAGATED_CONNECTION_LIMIT: מגבלת החיבורים שהועברה. ערך ברירת המחדל הוא 250.
  • ‫DOMAIN_NAME: שם דומיין DNS של השירות, כולל נקודה בסוף. פורמט מומלץ: REGION.p.DOMAIN. מידע נוסף זמין במאמר בנושא הגדרת DNS.

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

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
  {
    "name": "ATTACHMENT_NAME",
    "region": "ATTACHMENT_REGION",
    "connectionPreference": "ACCEPT_MANUAL",
    "targetService": "TARGET_SERVICE",
    "enableProxyProtocol": false,
    "natSubnets": [
      "PSC_SUBNET_1_URI",
      "PSC_SUBNET_2_URI"
    ],
    "consumerRejectLists": [
      "projects/REJECTED_PROJECT_ID_1/global/networks/REJECTED_NETWORK_1",
      "projects/REJECTED_PROJECT_ID_2/global/networks/REJECTED_NETWORK_2"
    ],
    "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"
      }
    ],
    "propagatedConnectionLimit": PROPAGATED_CONNECTION_LIMIT,
    "domainNames": [
      "DOMAIN_NAME"
    ]
  }
  

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

  • ‫REJECTED_PROJECT_ID_1 ו-REJECTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לדחות. התג consumerRejectLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
  • ‫REJECTED_NETWORK_1 ו-REJECTED_NETWORK_2: שמות הרשתות שרוצים לדחות.
  • ‫ACCEPTED_PROJECT_ID_1 ו-ACCEPTED_PROJECT_ID_2: המזהים של פרויקטי האב של הרשתות שרוצים לאשר. התג consumerAcceptLists הוא אופציונלי ויכול להכיל רשת אחת או יותר.
  • ‫ACCEPTED_NETWORK_1 ו-ACCEPTED_NETWORK_2: שמות הרשתות שרוצים לאשר.
  • ‫LIMIT_1 ו-LIMIT_2: מגבלות החיבור לרשתות. מגבלת החיבור היא מספר נקודות הקצה או ה-backend של הצרכנים שיכולים להתחבר לשירות הזה. לכל פרויקט שאושר צריך להיות מוגדר מגבלת חיבור.
  • ‫PROPAGATED_CONNECTION_LIMIT: מגבלת החיבורים שהועברה. ערך ברירת המחדל הוא 250.
  • ‫DOMAIN_NAME: שם דומיין DNS של השירות, כולל נקודה בסוף. פורמט מומלץ: REGION.p.DOMAIN. מידע נוסף זמין במאמר בנושא הגדרת DNS.

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

  {
    ...
    "reconcileConnections": true
    ...
  }
  

המסוף

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

   מעבר אל Private Service Connect

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

   יוצגו קבצים מצורפים עם השירות Private Service Connect.

gcloud

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

gcloud compute service-attachments list [--regions=REGION_LIST]

מחליפים את REGION_LIST ברשימה מופרדת בפסיקים של אזור אחד או יותר שרוצים לראות את קבצים מצורפים לשירותים שלהם. לדוגמה, us-central1 או us-west1,us-central1.

API

כדי לראות את כל קבצים מצורפים לשירות באזור מסוים או בכל האזורים, שולחים בקשת GET לשיטה serviceAttachments.list.

• כדי לראות את כל קבצי השירות באזור מסוים:

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

• הצגת כל קובצי השירות המצורפים בכל האזורים:

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/serviceAttachments
  

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

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

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

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

המסוף

אפשר לראות את הפרטים של שירות שפורסם. השדה Service attachment מכיל את מזהה המשאבים האחיד (URI) של קובץ השירות המצורף.

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

   מעבר אל Private Service Connect

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

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

gcloud

• כדי לראות את הפרטים של שירות שפורסם, משתמשים בפקודה gcloud compute service-attachments describe. השדה selfLink מכיל את מזהה המשאבים האחיד (URI) של שירות ה-Attachment.

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

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

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

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

• כדי לראות את הפרטים של שירות שפורסם, כולל מזהי ה-URI של נקודות הקצה שמבוססים על מזהים שאפשר להשתמש בהם כדי לאשר נקודות קצה ספציפיות, משתמשים בפקודה gcloud beta compute service-attachments describe. לכל נקודת קצה ברשימת נקודות הקצה המחוברות, השדה endpointWithId מכיל את ה-URI של נקודת הקצה שמבוסס על מזהה.

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

API

• כדי לראות פרטים על שירות שפורסם, שולחים בקשת GET אל השיטה serviceAttachments.get. השדה selfLink מכיל את מזהה המשאבים האחיד (URI) של שירות ה-Attachment.

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

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

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

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

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

• כדי לראות את הפרטים של שירות שפורסם, כולל מזהי ה-URI של נקודות הקצה שמבוססים על מזהים שאפשר להשתמש בהם כדי לאשר נקודות קצה ספציפיות, שולחים בקשת GET לשיטה serviceAttachments.get בגרסת הבטא. לכל נקודת קצה ברשימת נקודות הקצה המחוברות, השדה endpointWithId מכיל את ה-URI של נקודת הקצה שמבוסס על מזהה.

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

המסוף

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

   מעבר אל Private Service Connect

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

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

4. לוחצים על Delete.

gcloud

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

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

API

שולחים בקשת DELETE ל-method‏ serviceAttachments.delete.

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

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

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

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

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