הגדרה של dual-stack ‏ (IPv4 ו-IPv6)

תת-רשתות בשני פרוטוקולים מאפשרות למשאבים של App Engine לשלוח תנועת IPv4 ו-IPv6 לרשת VPC עם Direct VPC egress. אפשר לשנות תת-רשת קיימת עם IPv4 בלבד (פרוטוקול יחיד) לתת-רשת בשני פרוטוקולים.

סוגי רשתות משנה

רשתות VPC תומכות בסוגי תת-הרשתות הבאים של Compute Engine:

מגבלות של מחסנית כפולה

לפני שמשנים את סוג המחסנית במשאב קיים של App Engine, חשוב להביא בחשבון את המגבלות הבאות:

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

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

  • אין תמיכה ב-NAT64.

לפני שמתחילים

כדי להשתמש ברשת המשנה עם כתובת IPv6 חיצונית, ודאו שלסוכן השירות של App Engine יש את התפקיד "אדמין של כתובות IP ציבוריות ב-Compute"‏ (roles/compute.publicIpAdmin).

הגדרה של רשת משנה בשני פרוטוקולים

לתת-רשתות בשני פרוטוקולים יש טווחים של כתובות IPv4 ו-IPv6.

כדי להגדיר תת-רשת בשני פרוטוקולים, אפשר להשתמש במסוף Google Cloud או ב-Google Cloud CLI:

המסוף

  1. נכנסים למסוף Google Cloud ומפעילים את Compute Engine API:

    להפעלת Compute Engine API

  2. נכנסים לדף רשתות VPC:

    כניסה לדף VPC networks

  3. אם יוצרים רשת חדשה במצב מותאם אישית, לוחצים על Create VPC network. אם אתם משתמשים ברשת VPC קיימת, לוחצים על השם של רשת ה-VPC כדי להציג את הדף VPC network details.

  4. אם אתם יוצרים רשת חדשה או ממירים רשת קיימת, הזינו את השם וודאו שהאפשרות Subnet creation mode מוגדרת כ-Custom, ואז בחרו באפשרות Configure a ULA internal IPv6 range for this רשת VPC.

  5. בכרטיסייה Subnets, לוחצים על Add subnet. בחלונית שמופיעה:

    1. מזינים שם.
    2. בוחרים Region.
    3. בשביל IP stack type, בוחרים IPv4 and IPv6 (dual-stack).
    4. מזינים טווח IPv4. זהו טווח ה-IPv4 הראשי של רשת המשנה.
    5. בוחרים את סוג הגישה ל-IPv6.

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

    6. לוחצים על הוספה.

gcloud

  1. כדי ליצור רשת במצב מותאם אישית שתומכת בתת-רשתות בשני פרוטוקולים, מריצים את הפקודה gcloud compute networks create.

    כדי להגדיר טווחי IPv6 פנימיים בכל רשתות המשנה ברשת הזו, משתמשים בדגל --enable-ula-internal-ipv6. האפשרות הזו מקצה קידומת ULA של /48 מתוך הטווח fd20::/20 שמשמש את Google Cloud לטווחי רשתות משנה פנימיות של IPv6.

    gcloud compute networks create NETWORK \
      --subnet-mode=custom \
      --enable-ula-internal-ipv6

    מחליפים את NETWORK בשם של רשת ה-VPC שתכיל את רשת המשנה החדשה.

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

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

      gcloud compute networks update NETWORK \
        --switch-to-custom-subnet-mode
    2. הפעלת טווח IPv6 פנימי ברשת:

      gcloud compute networks update NETWORK \
        --enable-ula-internal-ipv6

      מחליפים את NETWORK בשם של רשת ה-VPC שמכילה את רשת המשנה החדשה.

  3. כדי ליצור תת-רשת בשני פרוטוקולים עם טווח IPv6, מריצים את הפקודה subnets create באמצעות ההגדרות של שני הפרוטוקולים:

    gcloud compute networks subnets create SUBNET \
      --network=NETWORK \
      --range=PRIMARY_IPv4_RANGE \
      --stack-type=IPV4_IPV6 \
      --ipv6-access-type=IPV6_ACCESS_TYPE \
      --region=REGION

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

    • ‫SUBNET: שם לתת-הרשת החדשה.
    • ‫NETWORK: השם של רשת ה-VPC שתכיל את רשת המשנה החדשה.
    • ‫PRIMARY_IPv4_RANGE: טווח ה-IPv4 הראשי של תת-הרשת החדשה, בסימון CIDR. מידע נוסף זמין במאמר טווחי רשתות משנה של IPv4.
    • ‫IPV6_ACCESS_TYPE: סוג הגישה ל-IPv6 של תת-הרשת החדשה, internal או external.
    • ‫REGION: האזור ב- Google Cloud שבו תיווצר תת-הרשת החדשה.

הוספת תת-רשת בשני פרוטוקולים למשאב של App Engine

אחרי שיוצרים תת-רשת בשני פרוטוקולים, מוסיפים אותה לשירות App Engine באמצעות YAML או Terraform. כדי להפעיל Direct VPC egress בשירות שלא משתמש בו, צריך לפרוס גרסה חדשה ולהעביר אליה את תעבורת הנתונים. אפשר גם למחוק קודם את הגרסה שנפרסה, במקום להחליף מזהה גרסה קיים.

YAML

  1. בקובץ app.yaml, מציינים את הרשת ואת רשת המשנה בשדה vpc_access:

    vpc_access:
    network_interface:
     network: NETWORK
     subnet: SUBNET
    vpc_egress: EGRESS_SETTING

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

    • ‫NETWORK: השם של הרשת שיצרתם בשלב הקודם.

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

    • אופציונלי: EGRESS_SETTING קובע איך תנועה יוצאת מנותבת. השדה הזה תומך בהגדרות הבאות:

      • ‫all-traffic: כל הבקשות היוצאות מנותבות דרך רשת ה-VPC.
      • ‫private-ranges-only (ברירת המחדל): רק תעבורת נתונים לכתובות IP פנימיות מנותבת דרך רשת ה-VPC. תעבורת הנתונים באינטרנט משתמשת בנתיב ברירת המחדל של App Engine.
  2. מריצים את הפקודה הבאה כדי לפרוס ב-App Engine:

    gcloud app deploy

Terraform

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

  1. מוסיפים את הבלוק vpc_access הבא למשאב google_app_engine_standard_app_version בהגדרות של Terraform:

    vpc_access {
    vpc_egress = "EGRESS_SETTING"
    network_interfaces {
     network    = "NETWORK"
     subnetwork = "SUBNET"
    }
    }

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

    • ‫NETWORK: השם של רשת ה-VPC שיצרתם בשלב הקודם.
    • ‫SUBNET: השם של רשת המשנה שיצרתם בשלב הקודם.
    • אופציונלי: EGRESS_SETTING קובע איך תנועה יוצאת מנותבת. השדה הזה תומך בהגדרות הבאות:
    • ‫ALL_TRAFFIC: כל הבקשות היוצאות מנותבות דרך רשת ה-VPC.
    • PRIVATE_IP_RANGES (ברירת המחדל): רק תנועה לכתובות IP פנימיות מנותבת דרך רשת ה-VPC. תעבורת הנתונים משתמשת בנתיב ברירת המחדל של App Engine.
  2. אם הגרסה כבר נפרסה בלי תעבורת נתונים יוצאת של Direct VPC, צריך לעדכן את השדה version_id לערך חדש. אי אפשר להפעיל תעבורת נתונים יוצאת של Direct VPC בגרסה קיימת.

  3. מחילים את ההגדרה:

    terraform apply

שינוי תת-רשת ממחסנית אחת לשתי מחסניות

כדי להוסיף טווח של תת-רשת מסוג IPv6 לתת-רשת קיימת מסוג IPv4 בלבד ברשת VPC במצב מותאם אישית, קראו את המאמר שינוי סוג המקבץ של תת-רשת למקבץ כפול. לאחר מכן, פורסים את שירות App Engine בתת-הרשת בשני פרוטוקולים.

שינוי תת-רשת ממצב של שני פרוטוקולים למצב של פרוטוקול יחיד

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

אימות הרשת ורשת המשנה

כדי לוודא שהמשאב נמצא ברשת ה-VPC, מריצים את הפקודה הבאה:

gcloud app versions describe VERSION --service=SERVICE

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

  • ‫VERSION: הגרסה שנפרסה של השירות
  • ‫SERVICE: השירות שנפרס

בפלט לדוגמה הבא מוצגות הרשת ורשת המשנה:

  vpcAccess:
    networkInterfaces:
    - network: projects/YOUR_PROJECT/global/networks/YOUR_NETWORK
      subnet: projects/YOUR_PROJECT/regions/YOUR_REGION/subnetworks/YOUR_SUBNET
    vpcEgress: ALL_TRAFFIC/PRIVATE_IP_RANGES