בדף הזה מוסבר איך להגדיר ולהשתמש ב-Ingress למאזני עומסים של אפליקציות (ALB) פנימיים ב-Google Kubernetes Engine (GKE). ב-Ingress יש תמיכה מובנית באיזון עומסים פנימי באמצעות בקר Ingress של GKE.
למידע נוסף על התכונות שנתמכות ב-Ingress למאזני עומסים פנימיים של אפליקציות (ALB), קראו את המאמר תכונות של Ingress. במאמר Ingress למאזני עומסים פנימיים של אפליקציות מוסבר איך פועל Ingress למאזני עומסים פנימיים של אפליקציות.
לפני שמתחילים
לפני שמתחילים, חשוב לוודא שביצעתם את המשימות הבאות:
- מפעילים את Google Kubernetes Engine API. הפעלת Google Kubernetes Engine API
- כדי להשתמש ב-Google Cloud CLI למשימה הזו, מתקינים ואז מאתחלים את ה-CLI של gcloud. אם כבר התקנתם את ה-CLI של gcloud, הריצו את הפקודה
gcloud components updateכדי לקבל את הגרסה העדכנית. יכול להיות שבגרסאות קודמות של ה-CLI של gcloud אי אפשר להריץ את הפקודות שבמסמך הזה.
דרישות ומגבלות
אלה הדרישות של Ingress למאזני עומסים פנימיים של אפליקציות:
- גרסת ה-GKE של האשכול צריכה להיות חדשה יותר מ-1.16.5-gke.10.
- האשכול חייב להיות מקורי ב-VPC.
- התוסף
HttpLoadBalancingצריך להיות מופעל באשכול. התוסף הזה מופעל כברירת מחדל. אסור להשבית אותו. - אתם צריכים להשתמש בקבוצות של נקודות קצה ברשת (NEG) כ-backend של השירות.
- אי אפשר להפעיל גישה גלובלית למאזן עומסים של אפליקציות (ALB) פנימי. אם אתם צריכים גישה גלובלית, מומלץ לפרוס שער פנימי.
- אשכולות IPv6 עם מחסנית אחת לא תומכים ב-GKE Ingress. כדי להגדיר מאזני עומסים של אפליקציות (ALB) פנימיים באשכולות IPv6 עם מחסנית אחת, צריך לפרוס שער פנימי.
פריסת Ingress למאזני עומסים פנימיים של אפליקציות (ALB)
בתרגילים הבאים מוסבר איך לפרוס Ingress למאזני עומסים של אפליקציות פנימיים:
- הכנת הסביבה.
- יוצרים אשכול.
- פריסת אפליקציה.
- פריסת שירות.
- פריסת Ingress.
- מאמתים את הפריסה.
- מחיקת משאבי Ingress.
הכנת הסביבה
כדי לפרוס משאבים של מאזן עומסים באמצעות Kubernetes Ingress API, צריך להכין את סביבת הרשת כך שיהיה אפשר לפרוס את שרתי ה-proxy של מאזן העומסים באזור נתון.
יוצרים רשת משנה מסוג proxy-only:
gcloud compute networks subnets create proxy-only-subnet \
--purpose=REGIONAL_MANAGED_PROXY \
--role=ACTIVE \
--region=COMPUTE_REGION \
--network=NETWORK_NAME \
--range=10.129.0.0/23
מחליפים את מה שכתוב בשדות הבאים:
COMPUTE_REGION: אזור ב-Compute Engine.-
NETWORK_NAME: שם הרשת של רשת המשנה.
מידע נוסף זמין במאמר הגדרת רשת משנה של שרתי proxy בלבד.
יצירת כלל של חומת אש
בקר ה-Ingress לא יוצר כלל חומת אש שמאפשר חיבורים משרתי ה-proxy של מאזן העומסים בתת-הרשת של שרת ה-proxy. צריך ליצור את הכלל הזה בחומת האש באופן ידני. עם זאת, בקר ה-Ingress יוצר כללי חומת אש שמאפשרים תעבורת נתונים נכנסת (ingress) לבדיקות תקינות של Google Cloud .
יוצרים כלל של חומת אש שמאפשר חיבורים משרתי ה-proxy של מאזן העומסים בתת-הרשת של שרת ה-proxy בלבד, ליציאת ההאזנה של ה-Pod:
gcloud compute firewall-rules create allow-proxy-connection \
--allow=TCP:CONTAINER_PORT \
--source-ranges=10.129.0.0/23 \
--network=NETWORK_NAME
מחליפים את CONTAINER_PORT בערך של היציאה שה-Pod מאזין לה, למשל 9376.
יצירת אשכול
בקטע הזה, יוצרים אשכול המותאם ל-VPC שאפשר להשתמש בו עם Ingress למאזני עומסים של אפליקציות פנימיים. אפשר ליצור את האשכול באמצעות Google Cloud CLI או מסוף Google Cloud .
gcloud
יוצרים אשכול באותה רשת שבה נמצאת רשת המשנה לשרתי proxy בלבד:
gcloud container clusters create-auto CLUSTER_NAME \
--location=COMPUTE_LOCATION \
--network=NETWORK_NAME
מחליפים את מה שכתוב בשדות הבאים:
-
CLUSTER_NAME: שם לאשכול. COMPUTE_LOCATION: המיקום של Compute Engine לאשכול. צריך להשתמש באותו מיקום של רשת המשנה של שרת ה-proxy שיצרתם בקטע הקודם.
המסוף
- נכנסים לדף Create an Autopilot cluster במסוף Google Cloud .
- בקטע Cluster basics, מבצעים את הפעולות הבאות:
- מזינים את השם (Name) של האשכול.
- בשדה Location type, בוחרים אזור ב-Compute Engine לאשכול. אתם צריכים להשתמש באותו אזור כמו של רשת המשנה של שרת ה-proxy שיצרתם בקטע הקודם.
- בחלונית הניווט, לוחצים על Networking.
- ברשימה Network, בוחרים את הרשת שבה רוצים ליצור את האשכול. הרשת הזו צריכה להיות באותה רשת VPC כמו רשת המשנה של שרת ה-proxy.
- ברשימה Node subnet, בוחרים את רשת המשנה של שרת ה-proxy שיצרתם.
- לוחצים על יצירה.
פריסה של אפליקציית אינטרנט
בקטע הזה יוצרים פריסה.
כדי ליצור פריסה:
שומרים את המניפסט לדוגמה הבא בתור
web-deployment.yaml:apiVersion: apps/v1 kind: Deployment metadata: labels: app: hostname name: hostname-server spec: selector: matchLabels: app: hostname minReadySeconds: 60 replicas: 3 template: metadata: labels: app: hostname spec: containers: - image: registry.k8s.io/serve_hostname:v1.4 name: hostname-server ports: - containerPort: 9376 protocol: TCP terminationGracePeriodSeconds: 90המניפסט הזה מתאר פריסה שמאזינה לשרת HTTPS ביציאה 9376. הפריסה הזו גם מנהלת את ה-Pods של האפליקציה. כל Pod מריץ קונטיינר אחד של אפליקציה עם שרת HTTPS שמחזיר את שם המארח של שרת האפליקציה כתגובה. שם המארח שמוגדר כברירת מחדל ל-Pod הוא השם של ה-Pod. הקונטיינר גם מטפל בסגירה מבוקרת.
מחילים את המניפסט על האשכול:
kubectl apply -f web-deployment.yaml
פריסת שירות כקבוצה של נקודות קצה ברשת (NEG)
בקטע הזה יוצרים משאב Service. השירות בוחר את קונטיינרי הקצה העורפי לפי התוויות שלהם, כדי שבקר ה-Ingress יוכל לתכנת אותם כנקודות קצה עורפיות. כדי להשתמש ב-Ingress למאזני עומסים פנימיים של אפליקציות (ALB), צריך להשתמש ב-NEG כקצוות עורפיים. התכונה לא תומכת בקבוצות של מכונות כרכיבי backend. מכיוון שנדרשים קצוות עורפיים של NEG, צריך להוסיף את ההערה הבאה של NEG כשפורסים שירותים שנחשפים דרך Ingress:
annotations:
cloud.google.com/neg: '{"ingress": true}'
השירות שלכם מקבל הערה אוטומטית עם cloud.google.com/neg: '{"ingress": true}' כשכל התנאים הבאים מתקיימים:
- אתם משתמשים באשכולות המותאמים ל-VPC.
- אתם לא משתמשים ב-VPC משותף.
- אתם לא משתמשים במדיניות הרשת ב-GKE.
ההערה מתווספת באופן אוטומטי באמצעות MutatingWebhookConfiguration עם השם neg-annotation.config.common-webhooks.networking.gke.io. כדי לבדוק אם MutatingWebhookConfiguration קיים, אפשר להשתמש בפקודה הבאה:
kubectl get mutatingwebhookconfigurations
השימוש ב-NEG מאפשר לבקר ה-Ingress לבצע איזון עומסים שמקורם בקונטיינר. העומס של תעבורת הנתונים מאוזן משרת ה-proxy של Ingress ישירות לכתובת ה-IP של Pod, במקום לעבור דרך כתובת ה-IP של הצומת או הרשת של kube-proxy. בנוסף, שערי המוכנות של Pod מיושמים כדי לקבוע את תקינות ה-Pods מנקודת המבט של מאזן העומסים, ולא רק את בדיקות המוכנות והפעילות של Kubernetes. שערי מוכנות של Pods מבטיחים שהתנועה לא תרד במהלך אירועים במחזור החיים, כמו הפעלת Pod, אובדן Pod או אובדן צומת.
אם לא תכללו הערת NEG, תקבלו אזהרה על אובייקט ה-Ingress שתמנע מכם להגדיר את מאזן העומסים הפנימי של האפליקציה. בנוסף, נוצר אירוע Kubernetes ב-Ingress אם ההערה של ה-NEG לא נכללת. ההודעה הבאה היא דוגמה להודעת אירוע:
Message
-------
error while evaluating the ingress spec: could not find port "8080" in service "default/no-neg-svc"
קבוצת NEG לא נוצרת עד ש-Ingress מפנה לשירות. קבוצת נקודות הקצה של הרשת לא תופיע ב-Compute Engine עד שגם ה-Ingress וגם השירות שאליו הוא מפנה יהיו קיימים. קבוצות NEG הן משאב של תחום מוגדר, ובאשכולות עם כמה תחומים נוצרת קבוצה אחת לכל שירות בכל תחום.
כדי ליצור שירות:
שומרים את המניפסט לדוגמה הבא בתור
web-service.yaml:apiVersion: v1 kind: Service metadata: name: hostname namespace: default annotations: cloud.google.com/neg: '{"ingress": true}' spec: ports: - name: host1 port: 80 protocol: TCP targetPort: 9376 selector: app: hostname type: ClusterIPמחילים את המניפסט על האשכול:
kubectl apply -f web-service.yaml
פריסת Ingress
בקטע הזה, יוצרים משאב Ingress שמפעיל את הפריסה של מאזן עומסים ב-Compute Engine באמצעות בקר Ingress. כדי להשתמש ב-Ingress למאזני עומסים פנימיים של אפליקציות (ALB), צריך להוסיף את האנוטציה הבאה:
annotations:
kubernetes.io/ingress.class: "gce-internal"
אי אפשר להשתמש בשדה ingressClassName כדי לציין Ingress של GKE. צריך להשתמש בהערה kubernetes.io/ingress.class. למידע נוסף, קראו את המאמר התנהגות של בקר Ingress ב-GKE.
כדי ליצור Ingress:
שומרים את המניפסט לדוגמה הבא בתור
internal-ingress.yaml:apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: ilb-demo-ingress namespace: default annotations: kubernetes.io/ingress.class: "gce-internal" spec: defaultBackend: service: name: hostname port: number: 80מחילים את המניפסט על האשכול:
kubectl apply -f internal-ingress.yaml
אימות של פריסת Ingress מוצלחת
בקטע הזה אתם בודקים אם הפריסה בוצעה בהצלחה.
יכול להיות שיעברו כמה דקות עד שההקצאה של משאב ה-Ingress תסתיים. במהלך הזמן הזה, בקר ה-Ingress יוצר פריטים כמו כללי העברה, שירותים לקצה העורפי, מפות URL וקבוצות NEG.
כדי לאחזר את הסטטוס של משאב ה-Ingress שיצרתם בקטע הקודם, מריצים את הפקודה הבאה:
kubectl get ingress ilb-demo-ingress
הפלט אמור להיראות כך:
NAME HOSTS ADDRESS PORTS AGE
ilb-demo-ingress * 10.128.0.58 80 59s
כשהשדה ADDRESS מאוכלס, ה-Ingress מוכן. שימוש בכתובת RFC 1918 בשדה הזה מציין כתובת IP פנימית ב-VPC.
מאזן העומסים הפנימי של אפליקציות (ALB) הוא מאזן עומסים אזורי, ולכן אפשר לגשת לכתובת ה-IP הווירטואלית (VIP) רק מלקוח שנמצא באותו אזור ובאותו VPC. אחרי שמאחזרים את ה-VIP של מאזן העומסים, אפשר להשתמש בכלים (לדוגמה, curl) כדי לשלוח קריאות HTTP GET ל-VIP מתוך ה-VPC.
כדי לבצע קריאה ל-HTTP GET, מבצעים את השלבים הבאים:
כדי להגיע ל-VIP של Ingress מתוך ה-VPC, פורסים מכונה וירטואלית באותו אזור ורשת כמו האשכול:
gcloud compute instances create l7-ilb-client \ --image-family=debian-12 \ --image-project=debian-cloud \ --network=NETWORK_NAME \ --subnet=SUBNET_NAME \ --zone=COMPUTE_ZONE \ --tags=allow-sshמחליפים את מה שכתוב בשדות הבאים:
-
SUBNET_NAME: השם של רשת משנה ברשת. COMPUTE_ZONE: אזור ב-Compute Engine במחוז.
מידע נוסף על יצירת מכונות זמין במאמר יצירה והפעלה של מכונה וירטואלית.
-
כדי לגשת ל-VIP הפנימי מתוך המכונה הווירטואלית, משתמשים ב-
curl:מתחברים ב-SSH למכונה הווירטואלית שיצרתם בשלב הקודם:
gcloud compute ssh l7-ilb-client \ --zone=COMPUTE_ZONEמשתמשים ב-
curlכדי לגשת ל-VIP של האפליקציה הפנימית:curl 10.128.0.58 hostname-server-6696cf5fc8-z4788תגובת ה-HTTP המוצלחת ושם המארח של אחד ממארזי הקצה העורפי מצביעים על כך שנתיב איזון העומסים המלא פועל בצורה תקינה.
מחיקת משאבי Ingress
כשמסירים משאבי Ingress ומשאבי שירות, גם משאבי איזון העומסים של Compute Engine שמשויכים אליהם מוסרים. כדי למנוע דליפת משאבים, חשוב לוודא שמשאבי Ingress נמחקים כשכבר לא צריך אותם. בנוסף, צריך למחוק את המשאבים של Ingress ו-Service לפני שמוחקים את האשכולות, אחרת המשאבים של איזון העומסים ב-Compute Engine יהיו מיותמים.
כדי להסיר Ingress, מבצעים את השלבים הבאים:
מוחקים את ה-Ingress. לדוגמה, כדי למחוק את ה-Ingress שיצרתם בדף הזה, מריצים את הפקודה הבאה:
kubectl delete ingress ilb-demo-ingressכשמוחקים את ה-Ingress, כללי ההעברה, השירותים לקצה העורפי ומפות כתובות ה-URL שמשויכים למשאב ה-Ingress הזה נמחקים.
מוחקים את השירות. לדוגמה, כדי למחוק את השירות שיצרתם בדף הזה, מריצים את הפקודה הבאה:
kubectl delete service hostnameמחיקת השירות מסירה את ה-NEG שמשויך לשירות.
כדי לפרוס אפליקציה ב-GKE ולחשוף אותה באמצעות כתובת IP פרטית עם איזון עומסים, קראו את המאמר Ingress פנימי בסיסי.
כתובות IP סטטיות
משאבי Ingress פנימיים תומכים בכתובות IP סטטיות וזמניות. אם לא מציינים כתובת IP, המערכת מקצה באופן אוטומטי כתובת IP זמינה מתת-הרשת של צומת GKE. עם זאת, משאב ה-Ingress לא מקצה כתובות IP מתת-הרשת לשרתי proxy בלבד, כי תת-הרשת הזו משמשת רק לצריכת שרתי proxy פנימיים. כתובות ה-IP הזמניות האלה מוקצות ל-Ingress רק למשך מחזור החיים של משאב ה-Ingress הפנימי. אם תמחקו את ה-Ingress ותיצרו Ingress חדש מאותו קובץ מניפסט, לא בטוח שתקבלו את אותה כתובת IP חיצונית.
אם רוצים כתובת IP קבועה שלא תלויה במחזור החיים של משאב ה-Ingress הפנימי, צריך לשמור כתובת IP פנימית סטטית אזורית. לאחר מכן תוכלו לציין כתובת IP סטטית באמצעות ההערה kubernetes.io/ingress.regional-static-ip-name במשאב Ingress.
בדוגמה הבאה אפשר לראות איך להוסיף את ההערה הזו:
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: my-ingress
annotations:
kubernetes.io/ingress.regional-static-ip-name: STATIC_IP_NAME
kubernetes.io/ingress.class: "gce-internal"
מחליפים את STATIC_IP_NAME בשם של כתובת IP סטטית שעומד בקריטריונים הבאים:
- צריך ליצור את כתובת ה-IP הסטטית לפני שפורסים את ה-Ingress. איזון העומסים לא נפרס עד שכתובת ה-IP הסטטית קיימת, והפניה למשאב של כתובת IP שלא קיים לא יוצרת כתובת IP סטטית. אם משנים Ingress קיים כדי להשתמש בכתובת IP סטטית במקום בכתובת IP זמנית, יכול להיות ש-GKE ישנה את כתובת ה-IP של מאזן העומסים כשהוא ייצור מחדש את כלל ההעברה של מאזן העומסים.
- כתובת ה-IP הסטטית שמורה בפרויקט השירות ל-Ingress שנפרס בפרויקט השירות של VPC משותף.
- מפנים ל Google Cloud משאב של כתובת ה-IP לפי השם שלו, ולא לפי כתובת ה-IP.
- כתובת ה-IP צריכה להיות מתת-רשת באותו אזור של אשכול GKE. אפשר להשתמש בכל רשת משנה פרטית שזמינה באזור (חוץ מרשת משנה לשרת proxy בלבד). למשאבי Ingress שונים יכולות להיות גם כתובות מתת-רשתות שונות.
HTTPS בין הלקוח למאזן העומסים
Ingress לאיזון עומסים פנימי תומך בהצגת אישורי TLS ללקוחות. אפשר להציג אישורי TLS באמצעות Kubernetes Secrets או באמצעות אישורי SSL אזוריים משותפים מראש ב- Google Cloud. אפשר גם לציין כמה אישורים לכל משאב Ingress. בגרסאות GKE 1.25 ואילך אפשר להשתמש גם ב-HTTPS וגם ב-HTTP בו-זמנית. כדי להפעיל את התכונה הזו, צריך ליצור כתובת IP סטטית עם PURPOSE=SHARED_LOADBALANCER_VIP, ולהגדיר אותה ב-ingress. אם לא מספקים כתובת IP סטטית, רק תנועת HTTPS מותרת, וצריך לפעול לפי ההוראות במאמר השבתת HTTP.
בשלבים הבאים מוסבר איך ליצור אישור ב- Google Cloud ואז להציג אותו באמצעות Ingress ללקוחות פנימיים, גם לתנועת HTTPS וגם לתנועת HTTP:
יוצרים את האישור האזורי:
gcloud compute ssl-certificates create CERT_NAME \ --certificate CERT_FILE_PATH \ --private-key KEY_FILE_PATH \ --region COMPUTE_REGIONמחליפים את מה שכתוב בשדות הבאים:
-
CERT_NAME: שם לאישור שאתם בוחרים. -
CERT_FILE_PATH: הנתיב לקובץ האישור המקומי כדי ליצור אישור בניהול עצמי. האישור צריך להיות בפורמט PEM. -
KEY_FILE_PATH: הנתיב לקובץ של מפתח פרטי מקומי. המפתח הפרטי צריך להיות בפורמט PEM ולהשתמש בהצפנה מסוג RSA או ECDSA. COMPUTE_REGION: אזור ב-Compute Engine לאישור.
-
שומרים כתובת IP סטטית ומחילים אותה לפי ההוראות במאמר כתובות IP סטטיות.
שומרים את המניפסט לדוגמה הבא בתור
ingress-pre-shared-cert.yaml:apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: ilb-demo-ing namespace: default annotations: ingress.gcp.kubernetes.io/pre-shared-cert: "CERT_NAME" kubernetes.io/ingress.regional-static-ip-name: STATIC_IP_NAME kubernetes.io/ingress.class: "gce-internal" spec: rules: - host: DOMAIN http: paths: - pathType: ImplementationSpecific backend: service: name: SERVICE_NAME port: number: 80מחליפים את מה שכתוב בשדות הבאים:
-
DOMAIN: הדומיין שלכם. -
CERT_NAME: שם האישור שיצרתם בקטע הקודם. -
SERVICE_NAME: שם השירות.
-
מחילים את המניפסט על האשכול:
kubectl apply -f ingress-pre-shared-cert.yaml
HTTPS בין מאזן העומסים לאפליקציה
אם האפליקציה פועלת ב-Pod של GKE ויכולה לקבל בקשות HTTPS, אתם יכולים להגדיר את מאזן העומסים כך שישתמש ב-HTTPS כשהוא מעביר בקשות לאפליקציה. מידע נוסף זמין במאמר HTTPS (TLS) בין מאזן העומסים לאפליקציה.
VPC משותף
הוספה ידנית של ההערה NEG
אם ה-GKE שבו אתם פורסים את משאבי ה-Ingress נמצא בפרויקט שירות של VPC משותף, השירותים לא מקבלים באופן אוטומטי את ההערה cloud.google.com/neg: '{"ingress": true}' כי ה-MutatingWebhookConfiguration שאחראי להוספת ההערה לשירותים לא מותקן.
צריך להוסיף את האנוטציה NEG למניפסט של השירותים שנחשפים דרך Ingress למאזני עומסים של אפליקציות (ALB) פנימיים.
כללי חומת אש של VPC
אם אשכול GKE שבו אתם פורסים את משאבי ה-Ingress נמצא בפרויקט שירות של VPC משותף, ואתם רוצים שמישור הבקרה של GKE ינהל את משאבי חומת האש בפרויקט המארח, צריך לתת לחשבון השירות של GKE בפרויקט השירות את הרשאות ה-IAM המתאימות בפרויקט המארח, בהתאם לניהול משאבי חומת אש לאשכולות עם VPC משותף. כך בקר ה-Ingress יכול ליצור כללים של חומת אש שמאפשרים תעבורת נתונים נכנסת (ingress) לבדיקות תקינות שלGoogle Cloud .
הדוגמה הבאה היא אירוע שעשוי להופיע ביומני המשאבים של Ingress. השגיאה הזו מתרחשת כשבקר ה-Ingress לא יכול ליצור כלל חומת אש כדי לאפשר תעבורת נתונים נכנסת (ingress) לבדיקות תקינות של Google Cloud , אם ההרשאות לא מוגדרות בצורה נכונה.
Firewall change required by security admin: `gcloud compute firewall-rules update <RULE_NAME> --description "GCE L7 firewall rule" --allow tcp:<PORT> --source-ranges 130.211.0.0/22,35.191.0.0/16 --target-tags <TARGET_TAG> --project <HOST_PROJECT>
אם אתם מעדיפים להקצות באופן ידני כללי חומת אש מהפרויקט המארח, אתם יכולים להשתיק את האירועים של firewallXPNError על ידי הוספת ההערה networking.gke.io/suppress-firewall-xpn-error: "true" למשאב Ingress.
סיכום של הערות Ingress פנימיות
בטבלאות הבאות מוצגות ההערות שאפשר להוסיף כשיוצרים משאבי Ingress ומשאבי שירות ל-Ingress בשביל מאזני עומסים פנימיים של אפליקציות.
הערות Ingress
| הערה | תיאור |
|---|---|
kubernetes.io/ingress.class |
אפשר להגדיר את הערך "gce-internal" ל-Ingress פנימי. אם לא מציינים את המחלקה, משאב Ingress מפורש כברירת מחדל כ-Ingress חיצוני.
מידע נוסף זמין במאמר ההתנהגות של בקר Ingress ב-GKE. |
kubernetes.io/ingress.allow-http |
אתם יכולים לאפשר תעבורת נתונים מסוג HTTP בין הלקוח לבין מאזן העומסים מסוג HTTP(S). הערכים האפשריים הם true ו-false.
ערך ברירת המחדל הוא true. מידע נוסף זמין במאמר השבתת HTTP. |
ingress.gcp.kubernetes.io/pre-shared-cert |
אתם יכולים להעלות אישורים ומפתחות לפרויקט ב- Google Cloud . משתמשים בהערה הזו כדי להפנות לאישורים ולמפתחות. מידע נוסף זמין במאמר שימוש בכמה אישורי SSL עם מאזני עומסים חיצוניים של אפליקציות. |
networking.gke.io/suppress-firewall-xpn-error |
בגרסה GLBC 1.4 ואילך, אפשר להשתיק את האירוע
מוסיפים את ההערה |
kubernetes.io/ingress.regional-static-ip-name |
אתם יכולים לציין כתובת IP סטטית כדי להקצות את משאב ה-Ingress הפנימי. מידע נוסף זמין במאמר כתובות IP סטטיות. |
הערות שירות שקשורות ל-Ingress
| הערה | תיאור |
|---|---|
cloud.google.com/backend-config |
משתמשים בהערה הזו כדי להגדיר את שירות הקצה העורפי שמשויך ל-servicePort. מידע נוסף זמין במאמר הגדרת Ingress. |
cloud.google.com/neg |
משתמשים בהערה הזו כדי לציין שמאזן העומסים צריך להשתמש בקבוצות של נקודות קצה ברשת. מידע נוסף זמין במאמר שימוש באיזון עומסים שמקורם בקונטיינר. |
פתרון בעיות
כדי להבין את המצב של Ingress ולעקוב אחריו, בדרך כלל צריך לבדוק את המשאבים המשויכים. סוגי הבעיות שנתקלים בהן כוללים לעיתים קרובות משאבים של איזון עומסים שלא נוצרו כמו שצריך, תנועה שלא מגיעה לקצוות העורפיים או קצוות עורפיים שלא נראים תקינים.
הנה כמה שלבים נפוצים לפתרון בעיות:
- מוודאים שתנועת הלקוחות מגיעה מאותו אזור ומאותו VPC כמו מאזן העומסים.
- מוודאים שה-Pods וה-backends תקינים.
- אימות נתיב התנועה ל-VIP ולבדיקות התקינות של Compute Engine כדי לוודא שהוא לא חסום על ידי כללי חומת אש.
- בודקים אם יש שגיאות באירועים של משאב ה-Ingress.
- תיאור של משאב ה-Ingress כדי לראות את המיפוי למשאבי Compute Engine.
- מוודאים שמשאבי איזון העומסים של Compute Engine קיימים, שההגדרות שלהם נכונות ושלא דווחו שגיאות.
סינון אירועי Ingress
השאילתה הבאה מסננת שגיאות בכל אירועי ה-Ingress באשכול:
kubectl get events --all-namespaces --field-selector involvedObject.kind=Ingress
אפשר גם לסנן לפי אובייקטים או שמות של אובייקטים:
kubectl get events --field-selector involvedObject.kind=Ingress,involvedObject.name=hostname-internal-ingress
בשגיאה הבאה, אפשר לראות שהשירות שאליו מפנה ה-Ingress לא קיים:
LAST SEEN TYPE REASON OBJECT MESSAGE
0s Warning Translate ingress/hostname-internal-ingress error while evaluating the ingress spec: could not find service "default/hostname-invalid"
בדיקת המשאבים של מאזן העומסים ב-Compute Engine
הפקודה הבאה מציגה את הפלט המלא של משאב ה-Ingress, כדי שתוכלו לראות את המיפויים למשאבי Compute Engine שנוצרו על ידי בקר ה-Ingress:
kubectl get ing INGRESS_FILENAME -o yaml
מחליפים את INGRESS_FILENAME בשם הקובץ של משאב ה-Ingress.
הפלט אמור להיראות כך:
apiVersion: v1
items:
- apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
ingress.kubernetes.io/backends: '{"k8s1-241a2b5c-default-hostname-80-29269aa5":"HEALTHY"}'
ingress.kubernetes.io/forwarding-rule: k8s-fw-default-ilb-demo-ingress--241a2b5c94b353ec
ingress.kubernetes.io/target-proxy: k8s-tp-default-ilb-demo-ingress--241a2b5c94b353ec
ingress.kubernetes.io/url-map: k8s-um-default-ilb-demo-ingress--241a2b5c94b353ec
kubectl.kubernetes.io/last-applied-configuration: |
{"apiVersion":"networking.k8s.io/v1","kind":"Ingress","metadata":{"annotations":{"kubernetes.io/ingress.class":"gce-internal"},"name":"ilb-demo-ingress","namespace":"default"},"spec":{"defaultBackend":{"service":{"name":"hostname"},"port":{"number":80}}}}
kubernetes.io/ingress.class: gce-internal
creationTimestamp: "2019-10-15T02:16:18Z"
finalizers:
- networking.gke.io/ingress-finalizer
generation: 1
name: ilb-demo-ingress
namespace: default
resourceVersion: "1538072"
selfLink: /apis/networking.k8s.io/v1/namespaces/default/ingresses/ilb-demo-ingress
uid: 0ef024fe-6aea-4ee0-85f6-c2578f554975
spec:
defaultBackend:
service:
name: hostname
port:
number: 80
status:
loadBalancer:
ingress:
- ip: 10.128.0.127
kind: List
metadata:
resourceVersion: ""
selfLink: ""
ההערות של ingress.kubernetes.io/backends מפרטות את הקצוות העורפיים ואת הסטטוס שלהם. מוודאים שה-backends מופיעים בתור HEALTHY.
כדי להבין את הסטטוס וההגדרות של משאבי Compute Engine שנוצרו על ידי Ingress, אפשר לשלוח אליהם שאילתות ישירות. הרצת השאילתות האלה יכולה גם לעזור בפתרון בעיות.
כדי להציג את כל כללי ההעברה ב-Compute Engine:
gcloud compute forwarding-rules list
הפלט אמור להיראות כך:
NAME REGION IP_ADDRESS IP_PROTOCOL TARGET
k8s-fw-default-hostname-internal-ingress--42084f6a534c335b REGION_NAME 10.128.15.225 TCP REGION_NAME/targetHttpProxies/k8s-tp-default-hostname-internal-ingress--42084f6a534c335b
כדי להציג את הסטטוס של שירות לקצה העורפי, קודם מציגים את רשימת השירותים לקצה העורפי ומעתיקים את השם של השירות שרוצים לבדוק:
gcloud compute backend-services list
הפלט אמור להיראות כך:
NAME BACKENDS PROTOCOL
k8s1-42084f6a-default-hostname-80-98cbc1c1 REGION_NAME/networkEndpointGroups/k8s1-42084f6a-default-hostname-80-98cbc1c1 HTTP
עכשיו אפשר להשתמש בשם של שירות הקצה העורפי כדי לשלוח שאילתה לגבי התקינות שלו:
gcloud compute backend-services get-health k8s1-42084f6a-default-hostname-80-98cbc1c1 \
--region COMPUTE_REGION
מחליפים את COMPUTE_REGION באזור של השירות לקצה העורפי ב-Compute Engine.
הפלט אמור להיראות כך:
backend: https://www.googleapis.com/compute/v1/projects/user1-243723/zones/ZONE_NAME/networkEndpointGroups/k8s1-42084f6a-default-hostname-80-98cbc1c1
status:
healthStatus:
- healthState: HEALTHY
המאמרים הבאים
מידע על GKE Ingress למאזני עומסים של אפליקציות (ALB) חיצוניים
איך יוצרים מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי ב-GKE
מטמיעים Ingress פנימי בסיסי.