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

המסוף

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

   מעבר לרשתות VPC

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

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

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

   1. מזינים שם.
   2. בחירת אזור.
   3. בקטע Purpose (מטרה), בוחרים באפשרות 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.s3nsapis.fr/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.s3nsapis.fr/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.s3nsapis.fr/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 במסוף Cloud de Confiance .

   מעבר אל Private Service Connect

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

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

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

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

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

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

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

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

הגדרת תת-רשת של Private Service Connect

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

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

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

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

2. אופציונלי: אם רוצים להקצות שתי כתובות IP של NAT לכל נקודת קצה או לכל שרת קצה (backend) של צרכן שאושרו, לוחצים על כתובות IP שהוקצו לכל נקודת קצה של PSC ואז בוחרים באפשרות 2.

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

השלמת ההגדרה

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

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

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

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

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

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 \ \
    [ --nat-ips-per-endpoint=NAT_IPS_PER_ENDPOINT ] \
    [ --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: רשימה מופרדת בפסיקים של שמות של רשתות משנה (לפחות אחת) לשימוש עם קובץ השירות המצורף הזה.

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

• ‫NAT_IPS_PER_ENDPOINT: מספר כתובות ה-IP של NAT שיוקצו לכל נקודת קצה או לכל קצה עורפי של צרכן שאושרה.

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

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

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

API

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

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
{
  "name": "ATTACHMENT_NAME",
  "connectionPreference": "ACCEPT_AUTOMATIC",
  "targetService": "TARGET_SERVICE",
  "enableProxyProtocol": false,
  "natIpsPerEndpoint": NAT_IPS_PER_ENDPOINT,
  "natSubnets": [
    "PSC_SUBNET_1_URI",
    "PSC_SUBNET_2_URI"
  ],
  "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 משותפת.

• ‫NAT_IPS_PER_ENDPOINT: מספר כתובות ה-IP של NAT שיוקצו לכל נקודת קצה או לכל קצה עורפי של צרכן שאושרה.

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

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

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

המסוף

הגדרת השירות

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

   מעבר אל Private Service Connect

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

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

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

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

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

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

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

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

הגדרת תת-רשת של Private Service Connect

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

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

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

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

2. אופציונלי: אם רוצים להקצות שתי כתובות IP של NAT לכל נקודת קצה או לכל שרת קצה (backend) של צרכן שאושרו, לוחצים על כתובות IP שהוקצו לכל נקודת קצה של PSC ואז בוחרים באפשרות 2.

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

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

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

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

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

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

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

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

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

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

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

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

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

השלמת ההגדרה

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

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

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

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

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

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 \
    [ --nat-ips-per-endpoint=NAT_IPS_PER_ENDPOINT ] \
    [ --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: מגבלות החיבור לפרויקטים או לרשתות. מגבלת החיבור היא מספר נקודות הקצה או ה-backend של הלקוחות שיכולים להתחבר לשירות הזה. לכל פרויקט או רשת שאושרו צריך להגדיר מגבלת חיבורים.

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

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

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

• ‫NAT_IPS_PER_ENDPOINT: מספר כתובות ה-IP של NAT שיוקצו לכל נקודת קצה או לכל קצה עורפי של צרכן שאושרו.

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

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

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

API

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

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

  POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
  {
    "name": "ATTACHMENT_NAME",
    "region": "ATTACHMENT_REGION",
    "connectionPreference": "ACCEPT_MANUAL",
    "targetService": "TARGET_SERVICE",
    "enableProxyProtocol": false,
    "natIpsPerEndpoint": NAT_IPS_PER_ENDPOINT,
    "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"
      }
    ],
    "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 משותפת.

  • ‫NAT_IPS_PER_ENDPOINT: מספר כתובות ה-IP של NAT שיוקצו לכל נקודת קצה או לכל קצה עורפי של צרכן שאושרו.

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

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

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

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

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

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

  POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/ATTACHMENT_REGION/serviceAttachments
  {
    "name": "ATTACHMENT_NAME",
    "region": "ATTACHMENT_REGION",
    "connectionPreference": "ACCEPT_MANUAL",
    "targetService": "TARGET_SERVICE",
    "enableProxyProtocol": false,
    "natIpsPerEndpoint": NAT_IPS_PER_ENDPOINT,
    "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"
      }
    ],
    "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: מגבלות החיבור לרשתות. מגבלת החיבור היא מספר נקודות הקצה או השרתים העורפיים של הצרכן שיכולים להתחבר לשירות הזה. לכל פרויקט שאושר צריך להגדיר מגבלת חיבורים.

  • ‫NAT_IPS_PER_ENDPOINT: מספר כתובות ה-IP של NAT שיוקצו לכל נקודת קצה או לכל קצה עורפי של צרכן שאושרו.

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

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

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

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

המסוף

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

   מעבר אל 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.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments
  

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

  GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/aggregated/serviceAttachments
  

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

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

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

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

המסוף

כדי לראות את הפרטים של שירות שפורסם:

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

   מעבר אל Private Service Connect

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

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

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

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

gcloud

כדי לראות פרטים על שירות שפורסם, משתמשים בפקודה gcloud compute service-attachments describe.

השדה selfLink מכיל את מזהה המשאבים האחיד (URI) של קובץ השירות. לכל נקודת קצה ברשימת נקודות הקצה המחוברות, השדה endpointWithId מכיל את ה-URI שמבוסס על המזהה של נקודת הקצה. אפשר להשתמש ב-URI הזה כדי לאשר או לדחות חיבורים מנקודות קצה נפרדות של Private Service Connect.

אם כוללים את הדגל --show-nat-ips, הרשימה connectedEndpoints מציגה את כתובות ה-IP של NAT לכל נקודת קצה או לכל שרת קצה.

gcloud compute service-attachments describe \
    ATTACHMENT_NAME --region=REGION \
    --show-nat-ips

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

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

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

API

כדי לראות פרטים על שירות שפורסם, שולחים בקשת GET לשיטה serviceAttachments.get.

השדה selfLink מכיל את מזהה המשאבים האחיד (URI) של קובץ השירות. לכל נקודת קצה ברשימת נקודות הקצה המחוברות, השדה endpointWithId מכיל את ה-URI של נקודת הקצה שמבוסס על מזהה, שבו אפשר להשתמש כדי לאשר או לדחות חיבורים מנקודות קצה נפרדות של Private Service Connect.

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME

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

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

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

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

המסוף

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

   מעבר אל 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.s3nsapis.fr/compute/v1/projects/PROJECT_ID/regions/REGION/serviceAttachments/ATTACHMENT_NAME

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

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

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

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