יצירת Cloud Router לחיבור רשת VPC לרשת שכנה

gcloud

כדי להשתמש בדוגמאות לשורת הפקודה במדריך הזה:

1. מתקינים או מעדכנים את הגרסה האחרונה של Google Cloud CLI.
2. מגדירים אזור ותחום ברירת מחדל.

API

אם רוצים להשתמש בדוגמאות ל-API במדריך הזה, צריך להגדיר גישה ל-API.

המסוף

1. נכנסים לדף Create a Cloud Router במסוף Google Cloud .

   איך יוצרים Cloud Router

2. מציינים את הפרטים של Cloud Router:

• שם: השם של Cloud Router. השם הזה מוצג במסוף Google Cloud ומשמש את Google Cloud CLI כדי להפנות ל-Cloud Router. לדוגמה, my-router.
• תיאור: אופציונלי. תיאור של Cloud Router.
• Network: רשת ה-VPC שמכילה את המכונות שאליהן רוצים להגיע – לדוגמה, my-network.
• אזור: האזור שבו רוצים למקם את Cloud Router – לדוגמה, asia-east1.

• ‫Google ASN: כל מספר מערכת אוטונומית פרטי (64512-65534,‏ 4200000000-4294967294) שאתם עדיין לא משתמשים בו ברשת המקומית. ב-Cloud Router צריך להשתמש במספר מערכת אוטונומית (ASN) פרטי, אבל מספר ה-ASN המקומי יכול להיות ציבורי או פרטי.

• BGP peer keepalive interval: The interval between two successive BGP keepalive messages that are sent to the peer router. הערך צריך להיות מספר שלם בין 20 ל-60 שמציין את מספר השניות של המרווח. ברירת המחדל היא 20 שניות. מידע נוסף זמין במאמר בנושא ניהול טיימרים של BGP.

• מזהה BGP: אופציונלי. מזהה BGP, שלפעמים נקרא מזהה נתב, שמזהה באופן ייחודי Cloud Router ברשת. אם לא מציינים כתובת, Cloud Routers עם סשנים של IPv4 BGP משתמשים באחת מכתובות ה-IPv4 BGP כמזהה BGP, והוספה של ממשק IPv6 ראשון ל-Cloud Router הזה מאכלסת את השדה באופן אוטומטי.

  מידע נוסף זמין במאמר בנושא הגדרת טווח מזהי BGP ל-Cloud Router.

3. אופציונלי: כדי לציין מסלולים מפורסמים בהתאמה אישית, עוברים לקטע Advertised routes. מידע נוסף מופיע במאמר בנושא מסלולים שפורסמו.
   1. כדי לציין מסלולים מותאמים אישית, בוחרים באפשרות יצירת מסלולים מותאמים אישית.
   2. בוחרים אם לפרסם את רשתות המשנה שגלויות ל-Cloud Router. הפעלת האפשרות הזו מחקה את התנהגות ברירת המחדל של Cloud Router.
   3. כדי להוסיף מסלול שפורסם, בוחרים באפשרות הוספת מסלול מותאם אישית ואז מגדירים אותו.
4. כדי לשמור את ההגדרות וליצור Cloud Router, לוחצים על Create. הנתב החדש של Cloud Router מופיע בדף של רשימת Cloud Router. כדי לראות את הפרטים שלו ולהגדיר סשן BGP, בוחרים אותו.

gcloud

הפקודה gcloud compute routers create יוצרת Cloud Router חדש. נתב Cloud Router משויך לרשת VPC או ל-NCC Gateway spoke. אחרי שיוצרים את ה-Gateway, אי אפשר לשנות את האזור, את רשת ה-VPC המשויכת או את רכזת ה-NCC Gateway המשויכת.

הדגל --set-advertisement-groups=ALL_SUBNETS תקף רק כשהדגל --advertisement-mode=CUSTOM מוגדר. כשמציינים את הדגל והערך האלה, הפרסומים ברמת הנתב כוללים טווחי רשתות משנה מקומיות בהתאם למצב הניתוב הדינמי של רשת ה-VPC.

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

‫ כוללים את הדגל --encrypted-interconnect-router רק אם Cloud Router מנהל סשנים של BGP עבור HA VPN דרך Cloud Interconnect. ‫

• כדי ליצור Cloud Router שמשויך לאזור של רשת VPC, משתמשים בפקודה הבאה:

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --network=NETWORK \
      --region=REGION\
      --asn=ASN_NUMBER \
      [--advertisement-mode=ADVERTISEMENT_MODE] \
      [--set-advertisement-groups=ALL_SUBNETS] \
      [--set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES] \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
      [--encrypted-interconnect-router]
  

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

  • ‫ROUTER_NAME: השם של Cloud Router

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את Cloud Router

  • ‫NETWORK: רשת ה-VPC שמכילה את Cloud Router

  • ‫REGION: האזור שבו נמצא Cloud Router

  • ‫ASN_NUMBER: כל מספר מערכת אוטונומית (ASN) פרטי (64512-65534,‏ 4200000000-4294967294) שעדיין לא נמצא בשימוש ברשת המקומית

    ב-Cloud Router צריך להשתמש ב-ASN פרטי, אבל ה-ASN המקומי יכול להיות ציבורי או פרטי.

  • ‫ADVERTISEMENT_MODE: מציין את מצב הפרסום ברמת הנתב

    הערכים התקינים הם CUSTOM או DEFAULT. אם לא מציינים את הדגל --advertisement-mode, Google Cloud השימוש הוא במצב DEFAULTadvertisement ברמת הנתב. מידע על המשמעות של מצב הפרסום ברמת הנתב ועל ההשפעה שלו על פרסום של סשנים נפרדים של BGP זמין במאמרים מצבי פרסום ופרסומים אפקטיביים.

  • ‫CUSTOM_ADVERTISED_RANGES: תקף רק כשמציינים --advertisement-mode=CUSTOM, רשימה אופציונלית של טווחי כתובות IP מותאמים אישית בפורמט CIDR או כתובות IP בודדות שייכללו בפרסומים ברמת הנתב

    כתובות IPv4 בודדות מתפרשות כ-CIDR עם /32 מסכה של רשת משנה, וכתובות IPv6 בודדות מתפרשות כ-CIDR עם /128 מסכה של רשת משנה. מידע על המספר המקסימלי של מודעות מסלול מותאם אישית זמין במאמר מגבלות.

  • ‫ROUTER_IDENTIFIER_RANGE: טווח כתובות IPv4 אופציונלי שמשמש כמזהה ייחודי ל-Cloud Router

    מידע נוסף מופיע במאמר בנושא הגדרת טווח מזהי BGP.

  • ‫KEEPALIVE_TIMER: זמן אופציונלי בשניות שמגדיר את טיימר ה-keepalive של BGP

    הערכים התקפים הם בין 20 ל-60, כולל. אם לא מציינים את הדגל --keepalive-interval, ‏ Cloud Router משתמש בטיימר של 20 שניות ל-BGP keepalive. מידע נוסף זמין במאמר בנושא טיימר של Keepalive.

• כדי ליצור Cloud Router שמשויך ל-NCC Gateway spoke, משתמשים בפקודה הבאה.

  משתמשים בדגל --advertisement-mode=CUSTOM כדי להגדיר את מצב הפרסום ברמת הנתב ל-CUSTOM, כדי שתוכלו לציין פרסום של מסלולים מותאמים אישית ברמת הנתב.

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

  gcloud compute routers create ROUTER_NAME \
      --project=PROJECT_ID \
      --ncc-gateway=NCC_GATEWAY_URI \
      --region=REGION\
      --asn=ASN_NUMBER \
      --advertisement-mode=CUSTOM \
      --set-advertisement-ranges=CUSTOM_ADVERTISED_RANGES \
      [--bgp-identifier-range=ROUTER_IDENTIFIER_RANGE] \
      [--keepalive-interval=KEEPALIVE_TIMER] \
  

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

  • ‫ROUTER_NAME: השם של Cloud Router

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את Cloud Router

  • ‫NCC_GATEWAY_URI: ה-URI המלא של שער ה-NCC שמשויך לנתב. הפורמט של ה-URI הוא כזה: https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • ‫REGION: האזור שבו נמצא Cloud Router

  • ‫ASN_NUMBER: כל מספר מערכת אוטונומית (ASN) פרטי (64512-65534,‏ 4200000000-4294967294) שעדיין לא נמצא בשימוש ברשת המקומית

    ב-Cloud Router צריך להשתמש ב-ASN פרטי, אבל ה-ASN המקומי יכול להיות ציבורי או פרטי.

  • ‫--advertisement-mode=CUSTOM: מגדיר את מצב הפרסום ברמת הנתב ל-CUSTOM כדי שתוכלו לציין פרסום של מסלולים מותאמים אישית ברמת הנתב.

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

  • ‫CUSTOM_ADVERTISED_RANGES: רשימת טווחי כתובות IP מותאמים אישית בפורמט CIDR או כתובות IP בודדות שייכללו בפרסומים ברמת הנתב

    כתובות IPv4 בודדות מתפרשות כ-CIDR עם /32 מסכה של רשת משנה, וכתובות IPv6 בודדות מתפרשות כ-CIDR עם /128 מסכה של רשת משנה. מידע על המספר המקסימלי של פרסומים של מסלולים בהתאמה אישית מופיע במאמר מגבלות.

  • ‫ROUTER_IDENTIFIER_RANGE: טווח כתובות IPv4 אופציונלי שמשמש כמזהה ייחודי ל-Cloud Router

    מידע נוסף מופיע במאמר בנושא הגדרת טווח מזהי BGP.

  • ‫KEEPALIVE_TIMER: זמן אופציונלי בשניות שמגדיר את טיימר ה-keepalive של BGP

    הערכים התקפים הם בין 20 ל-60, כולל. אם לא מציינים את הדגל --keepalive-interval, ‏ Cloud Router משתמש בטיימר של 20 שניות ל-BGP keepalive. מידע נוסף זמין במאמר בנושא טיימר של Keepalive.

Terraform

משתמשים בGoogle Cloud מודול Terraform ל-Cloud Router.

module "cloud_router" {
  source = "../.."

  name   = "my-router"
  region = "us-central1"

  bgp = {
    # The ASN (16550, 64512 - 65534, 4200000000 - 4294967294) can be any private ASN
    # not already used as a peer ASN in the same region and network or 16550 for Partner Interconnect.
    asn = "65001"
  }

  project_id = var.project_id
  network    = module.vpc.network_name
}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

API

השיטה routers.insert יוצרת Cloud Router חדש. נתב Cloud Router משויך לרשת VPC או ל-NCC Gateway spoke. אחרי שיוצרים את ה-Gateway, אי אפשר לשנות את האזור, את רשת ה-VPC המשויכת או את רכזת ה-NCC Gateway המשויכת.

הדגל "advertisedGroups": [ALL_SUBNETS] תקף רק כשbgp.advertiseMode: CUSTOM, כשbgp.advertisedGroups: [ALL_SUBNETS], המודעות ברמת הנתב כוללות טווחי רשתות משנה מקומיות בהתאם למצב הניתוב הדינמי של רשת ה-VPC. מידע נוסף זמין במאמר בנושא פרסום טווח של רשת משנה.

הדגל encryptedInterconnectRouter הוא פרמטר בוליאני שמציין אם Cloud Router מנהל סשנים של BGP עבור HA VPN דרך Cloud Interconnect.

• כדי ליצור Cloud Router שמשויך לאזור ברשת VPC, משתמשים בבקשה הבאה:

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "network": "NETWORK",
         "encryptedInterconnectRouter": True|False,
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": "ADVERTISEMENT_MODE",
           "advertisedGroups": [ALL_SUBNETS],
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

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

  • ‫ROUTER_NAME: השם של Cloud Router

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את Cloud Router

  • ‫NETWORK: רשת ה-VPC שמכילה את Cloud Router

  • ‫REGION: האזור שבו נמצא Cloud Router

  • ‫ASN_NUMBER: כל מספר מערכת אוטונומית (ASN) פרטי (64512-65534,‏ 4200000000-4294967294) שעדיין לא נמצא בשימוש ברשת המקומית

    ב-Cloud Router צריך להשתמש ב-ASN פרטי, אבל ה-ASN המקומי יכול להיות ציבורי או פרטי.

  • ‫ADVERTISEMENT_MODE: מציין את מצב הפרסום ברמת הנתב

    הערכים התקינים הם CUSTOM או DEFAULT. אם לא מציינים את bgp.advertiseMode, Google Cloud השימוש ב-DEFAULT נעשה במצב פרסום ברמת הנתב. במאמרים מצבי פרסום ופרסומים אפקטיביים מוסבר מהו מצב הפרסום ברמת הנתב ומה ההשפעה שלו על פרסומים של סשנים ספציפיים של BGP.

  • ‫CUSTOM_ADVERTISED_RANGE ו-CUSTOM_ADVERTISED_RANGE_DESCRIPTION: מפתחות במילון שמציינים פרסום של מסלול מותאם אישית ברמת הנתב

    ‫bgp.advertisedIpRanges היא הרשימה שמכילה כל מילון של פרסום מסלול בהתאמה אישית. כדי לציין bgp.advertisedIpRanges, צריך לציין גם bgp.advertiseMode: CUSTOM. כל CUSTOM_ADVERTISED_RANGE הוא טווח כתובות IP בפורמט CIDR או כתובת IP בודדת. כתובות IPv4 בודדות מתפרשות כ-CIDR עם /32מסכה של רשת משנה, וכתובות IPv6 בודדות מתפרשות כ-CIDR עם /128מסכה של רשת משנה. מידע על המספר המרבי של פרסומים של מסלולים מותאמים אישית זמין במאמר מגבלות. כל אחד מהפרמטרים [CUSTOM_ADVERTISED_RANGE_DESCRIPTION] הוא מחרוזת שמתארת את המודעה.

  • ‫ROUTER_IDENTIFIER_RANGE: מגדיר טווח של כתובות IPv4 שמשמש כמזהה ייחודי ל-Cloud Router

    מידע נוסף מופיע במאמר בנושא הגדרת טווח מזהי BGP.

  • ‫KEEPALIVE_TIMER: זמן אופציונלי בשניות שמגדיר את טיימר ה-keepalive של BGP

    הערכים התקפים הם בין 20 ל-60, כולל. אם לא מציינים את הערך bgp.keepaliveInterval, Cloud Router משתמש בטיימר של 20 שניות ל-BGP keepalive. מידע נוסף זמין במאמר בנושא טיימר של Keepalive.

  • ‫encryptedInterconnectRouter: פרמטר בוליאני שמציין אם Cloud Router מנהל סשנים של BGP עבור HA VPN דרך Cloud Interconnect.

• כדי ליצור Cloud Router שמשויך ל-NCC Gateway spoke, משתמשים בבקשה הבאה.

  הדגל bgp.advertiseMode: CUSTOM מגדיר את מצב הפרסום ברמת הנתב ל-CUSTOM, כדי שתוכלו לציין פרסום של מסלולים בהתאמה אישית ברמת הנתב. מידע על ההשפעה של מצב הפרסום ברמת הנתב על פרסומים של סשנים ספציפיים של BGP זמין במאמר פרסומים אפקטיביים.

       POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers
       {
         "name": "ROUTER_NAME",
         "ncc_gateway": "NCC_GATEWAY_URI",
         "bgp": {
           "asn": "ASN_NUMBER",
           "advertiseMode": CUSTOM,
           "advertisedIpRanges": [
              {
                 "range": CUSTOM_ADVERTISED_RANGE,
                 "description": CUSTOM_ADVERTISED_RANGE_DESCRIPTION
              }, ...
           ],
           "identifierRange": ROUTER_IDENTIFIER_RANGE,
           "keepaliveInterval": KEEPALIVE_TIMER
         }
       }
  

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

  • ‫ROUTER_NAME: השם של Cloud Router

  • ‫PROJECT_ID: מזהה הפרויקט שמכיל את Cloud Router

  • ‫NCC_GATEWAY_URI: ה-URI המלא של שער ה-NCC שמשויך לנתב. הפורמט של ה-URI הוא כזה: https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/spokes/GATEWAY_SPOKE_NAME

  • ‫REGION: האזור שבו נמצא Cloud Router

  • ‫ASN_NUMBER: כל מספר מערכת אוטונומית (ASN) פרטי (64512-65534,‏ 4200000000-4294967294) שעדיין לא נמצא בשימוש ברשת המקומית

    ב-Cloud Router צריך להשתמש ב-ASN פרטי, אבל ה-ASN המקומי יכול להיות ציבורי או פרטי.

  • ‫CUSTOM_ADVERTISED_RANGE ו-CUSTOM_ADVERTISED_RANGE_DESCRIPTION: מפתחות במילון שמציינים פרסום של מסלול מותאם אישית ברמת הנתב

    ‫bgp.advertisedIpRanges היא הרשימה שמכילה כל מילון של פרסום מסלול בהתאמה אישית. כדי לציין bgp.advertisedIpRanges, צריך לציין גם bgp.advertiseMode: CUSTOM. כל אחד מהם CUSTOM_ADVERTISED_RANGE הוא טווח כתובות IP בפורמט CIDR או כתובת IP בודדת. כתובות IPv4 בודדות מתפרשות כ-CIDR עם /32מסכה של רשת משנה, וכתובות IPv6 בודדות מתפרשות כ-CIDR עם /128מסכה של רשת משנה. מידע על המספר המקסימלי של מודעות מסלול מותאם אישית זמין במאמר בנושא מגבלות. כל אחד מהפרמטרים [CUSTOM_ADVERTISED_RANGE_DESCRIPTION] הוא מחרוזת שמתארת את המודעה.

  • ‫ROUTER_IDENTIFIER_RANGE: מגדיר טווח של כתובות IPv4 שמשמש כמזהה ייחודי ל-Cloud Router

    מידע נוסף מופיע במאמר בנושא הגדרת טווח מזהי BGP.

  • ‫KEEPALIVE_TIMER: זמן אופציונלי בשניות שמגדיר את טיימר ה-keepalive של BGP

    הערכים התקפים הם בין 20 ל-60, כולל. אם לא מציינים את הערך bgp.keepaliveInterval, Cloud Router משתמש בטיימר של 20 שניות ל-BGP keepalive. מידע נוסף זמין במאמר בנושא keepalive timer.