העברת Ingress ל-Gateway API

בדף הזה מוסבר איך להעביר את ניהול התנועה ב-Google Kubernetes Engine (GKE) מ-Ingress API ל-Gateway API. ‫Gateway API מספק פתרון Google Cloud בניהול מלא לטיפול בתנועה באפליקציה.

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

באופן כללי, אסטרטגיית ההעברה כוללת את השלבים הבאים:

  1. מגדירים את מאזן העומסים החדש.
  2. הגדירו כללים לטיפול בתנועה נכנסת.
  3. פורסים את ההגדרה החדשה ובודקים את זרימת התנועה לכתובת ה-IP החדשה של השער.
  4. מעבירים את תנועת הייצור ל-Gateway API.
  5. מנקים את משאבי ה-Ingress שנותרו.

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

בשלב הזה פורסים משאב של שער Kubernetes כדי לאזן עומסים של תעבורת נתונים לאשכול GKE. כשפורסים משאב Gateway, ‏GKE מגדיר מאזן עומסים של אפליקציות (ALB) בשכבה 7 כדי לחשוף תנועת HTTP(S) לאפליקציות שפועלות באשכול. פורסים משאב Gateway אחד לכל אשכול או לכל מאזן עומסים שצריך.

בדוגמה הבאה, אתם מגדירים מאזן עומסים גלובלי חיצוני של אפליקציות (ALB). כדי ליצור שער, שומרים את המניפסט הבא בתור gateway.yaml:

kind: Gateway
apiVersion: gateway.networking.k8s.io/v1
metadata:
  name: external-http-gateway
spec:
  gatewayClassName: gke-l7-global-external-managed # GKE's managed external Application Load Balancer
  listeners:
  - name: http
    protocol: HTTP
    port: 80
    allowedRoutes:
      namespaces:
        from: Same # Only allow HTTPRoutes from the same namespace

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

  • ‫gatewayClassName: gke-l7-global-external-managed: מציין את GatewayClass של השער הזה. במחלקה הזו של Gateway נעשה שימוש במאזן עומסים גלובלי חיצוני של אפליקציות (ALB).
  • ‫protocol: HTTP ו-port: 80: מציינים שהשער חושף את יציאה 80 לתנועת HTTP.

הגדרת כללי תנועה לתנועה נכנסת

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

בשלב הזה, אתם מתרגמים את המניפסט של Ingress למשאב HTTPRoute. כדי להמיר את המניפסט של Ingress, פועלים לפי השלבים בכלי ingress2gateway.

בדוגמה הזו אנחנו מניחים שיש לכם את משאב ה-Ingress הבא:

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: cafe-ingress
spec:
  ingressClassName: nginx
  rules:
  - host: cafe.example.com
    http:
      paths:
      - path: /tea
        pathType: Prefix
        backend:
          service:
            name: tea-svc
            port:
              number: 80
      - path: /coffee
        pathType: Prefix
        backend:
          service:
            name: coffee-svc
            port:
              number: 80

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

שומרים את המניפסט לדוגמה הבא בתור httproute.yaml:

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: cafe-route
spec:
  # This route attaches to our new Gateway
  parentRefs:
  - name: external-http-gateway
  # The hostname is the same as before
  hostnames:
  - "cafe.example.com"
  # The routing rules are now more explicit
  rules:
  - matches:
    - path:
        type: PathPrefix
        value: /tea
    backendRefs:
    - name: tea-svc
      port: 80
  - matches:
    - path:
        type: PathPrefix
        value: /coffee
    backendRefs:
    - name: coffee-svc
      port: 80

שימו לב שהשדה rules במניפסט של HTTPRoute תואם ישירות לכללי הניתוב שהוגדרו במניפסט המקורי של Ingress.

פריסה ובדיקה של ההגדרות החדשות

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

  1. מחילים את המניפסטים של Gateway ו-HTTPRoute:

    kubectl apply -f gateway.yaml
    kubectl apply -f httproute.yaml
    
  2. משיגים את כתובת ה-IP של השער. יכול להיות שיעברו כמה דקות עד שכתובת ה-IP תוקצה:

    kubectl get gateway external-http-gateway -o=jsonpath="{.status.addresses[0].value}" --watch
    

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

  3. בודקים את כתובת ה-IP החדשה של השער. משתמשים בפקודה curl הבאה כדי לשלוח בקשה לכתובת ה-IP ולציין את שם המארח cafe.example.com. לדוגמה:

    curl --resolve cafe.example.com:80:203.0.113.90 http://cafe.example.com/tea
    curl --resolve cafe.example.com:80:203.0.113.90 http://cafe.example.com/coffee
    

    מחליפים את 203.0.113.90 בכתובת ה-IP החיצונית שקיבלתם בשלב הקודם. הפלט מאשר שכתובת ה-IP החדשה של השער מנתבת בצורה נכונה את התנועה של cafe.example.com בלי לבצע חיפוש DNS.

הפניית תנועה לכתובת ה-IP החדשה של השער

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

לדוגמה, אם הגדרתם את cafe.example.com ב-Ingress, אתם צריכים לאתר את הרשומה A של cafe.example.com אצל ספק ה-DNS ולשנות את הערך של כתובת ה-IP הישנה של Ingress ל-203.0.113.90, שהיא כתובת ה-IP החדשה של Gateway.

אחרי שמעדכנים את רשומת ה-DNS, התנועה מתחילה לעבור מ-Ingress ל-Gateway, אבל המעבר החד למערכת אחרת (cutover) לא מתרחש מיד לכל הלקוחות. מפענחי DNS ששמרו במטמון את הרשומה הקודמת ממתינים עד שיפוג ערך משך החיים (TTL) של הרשומה, לפני שהם שולחים שוב שאילתה לגבי הרשומה ומקבלים את כתובת ה-IP המעודכנת. לכן, כדאי להמשיך להריץ את ה-Ingress הקיים ואת ה-Gateway החדש במקביל עד שמוודאים שהתנועה ל-Ingress פסקה, מה שמצביע על כך שהפצת ה-DNS הושלמה והלקוחות כבר לא מופנים לכתובת ה-IP הישנה. כדי לוודא שהתנועה מגיעה, אפשר לעקוב אחרי התנועה במאזן העומסים או בבקר ה-Ingress. למידע נוסף, ראו בדיקת הפצה של DNS.

אם אתם משתמשים ב-Cloud DNS, אתם יכולים להשתמש במשקלי יעד כדי להעביר בהדרגה את התנועה מכתובת ה-IP הישנה לכתובת ה-IP החדשה. מידע נוסף זמין במאמר הגדרה של מדיניות ניתוב ובדיקות תקינות של DNS.

מחיקת משאבי ה-Ingress שנותרו

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

  1. מוחקים את משאב ה-Ingress:

    kubectl delete ingress cafe-ingress
    
  2. מסירים את הבקר ingress-nginx. לדוגמה, אם השתמשתם ב-Helm כדי להתקין את הבקר, הריצו את הפקודה הבאה:

    helm uninstall ingress-nginx -n ingress-nginx
    

השוואת תכונות בין Ingress NGINX לבין GKE Gateway

‫Gateway API מספק דרך סטנדרטית יותר להגדיר Ingress, ויש לו תכונות דומות לתכונות הנפוצות ביותר כמו ניתוב, כותרות וחלוקת תנועה.

בטבלה הבאה מוצגת השוואה בין ההגדרות של תכונות נפוצות ב-Ingress controller וב-Gateway API.

תכונה הערה ב-Ingress הגדרה ב-GKE Gateway זוגיות
ניתוב מבוסס-מארח השדה spec.rules.host באובייקט Ingress. השדה hostnames באובייקט HTTPRoute. שוויון מלא.
ניתוב מבוסס-נתיב השדה spec.rules.http.paths באובייקט Ingress, וההערה nginx.ingress.kubernetes.io/use-regex להתאמת נתיב של ביטוי רגולרי. השדה rules.matches.path באובייקט HTTPRoute. שוויון מלא. ‫GKE Gateway תומך בהתאמה מדויקת, בהתאמה לפי תחילית ובהתאמה לפי ביטוי רגולרי (RegularExpression) לנתיבים. בנוסף, אפשר להתאים כותרות HTTP‏ (rules.matches.headers) ופרמטרים של שאילתות (rules.matches.queryParams) באמצעות ערכים מדויקים או ביטויים רגולריים.
חלוקת התנועה ‫nginx.ingress.kubernetes.io/canary הערות. ‫HTTPRoute עם השדה המשוקלל backendRefs. שוויון מלא. בנוסף, אתם יכולים לפצל את התנועה באמצעות בקרה מדויקת.
זיקה לסשן (session affinity) ‫nginx.ingress.kubernetes.io/affinity ו-nginx.ingress.kubernetes.io/affinity-mode הערות. GCPTrafficDistributionPolicy עם השדה sessionAffinity. שוויון מלא. ‫GKE Gateway תומך בכמה סוגים של זיקה לסשן, כולל סוגי זיקה שמבוססים על קובצי Cookie‏ (HTTP_COOKIE,‏ GENERATED_COOKIE ו-STRONG_COOKIE_AFFINITY עם שמירת מצב), זיקה שמבוססת על כותרות (HEADER_FIELD) וזיקה שמבוססת על כתובת ה-IP של הלקוח (CLIENT_IP).
‫CORS (שיתוף משאבים ממקורות שונים) nginx.ingress.kubernetes.io/enable-cors ‫HTTPRoute עם מסנן CORS. שוויון מלא. הערה: ב-GKE Gateway יש מגבלות על מספר התבניות של תווים כלליים לחיפוש שאפשר להגדיר לכל מאזין או שם מארח.
שכתוב כתובות URL nginx.ingress.kubernetes.io/rewrite-target ‫HTTPRoute עם מסנן urlRewrite, או GCPHTTPFilter עם השדה spec.urlRewrite.regexModifier. שוויון מלא. ‫GKE Gateway תומך בהחלפות של נתיבים מלאים, בהחלפות של קידומות ובשכתובים של נתיבי ביטויים רגולריים.
מניפולציה של כותרות nginx.ingress.kubernetes.io/proxy-set-headers או add-headers ‫HTTPRoute עם משתנה requestHeaderModifier או מסנן responseHeaderModifier. שוויון מלא.
אימות ‫nginx.ingress.kubernetes.io/auth-url לאימות חיצוני.
  • שרת proxy לאימות זהויות (IAP): משאב בהתאמה אישית של GCPBackendPolicy.
  • אחר: נדרשת גישה מותאמת אישית יותר, אולי עם Service mesh או מסננים בהתאמה אישית.
שוויון חלקי. שרת proxy לאימות זהויות (IAP) הוא הדרך המומלצת לאבטח את השער, והוא מוגדר בקצה העורפי.

המאמרים הבאים