פרמטרים של שירות LoadBalancer

טייס אוטומטי רגילה

בדף הזה מתוארים פרמטרים של מניפסטים של שירותים ששולטים בהתנהגות ובהגדרה של שירות LoadBalancer. לפני שקוראים את הדף הזה, חשוב להכיר את המושגים של שירות LoadBalancer ב-Google Kubernetes Engine ‏ (GKE).

חשוב: שירותי LoadBalancer מסתמכים על finalizers ספציפיים (עם הקידומת networking.gke.io) ועל הערות לניפוי באגים (עם הקידומת service.kubernetes.io). אל תערכו או תסירו את ה-finalizers או את ההערות האלה באופן ידני. שינוי או הסרה של האובייקטים האלה עלולים לגרום להתנהגות לא צפויה או לשיבושים.

פרמטרים של שירות

‫GKE תומך בפרמטרים הבאים של שירותי LoadBalancer.

פרמטר	שדה השירות ותיאור	פנימי	חיצוני	תמיכה בגרסאות
מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי	spec.loadBalancerClass: networking.gke.io/l4-regional-internal networking.gke.io/load-balancer-type: "Internal" הוראה ל-GKE ליצור מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי. מאזן העומסים משתמש בקצוות עורפיים של GCE_VM_IP NEG אם מתקיים אחד מהתנאים הבאים: מחילים את מניפסט השירות על אשכול שמופעל בו חלוקת משנה של GKE. מניפסט השירות מוחל על אשכול שפועל ב-GKE בגרסה 1.36 ואילך. התכונה GKE subsetting מופעלת אוטומטית ב-GKE מגרסה 1.36 ואילך. בכל שאר המצבים, מאזן העומסים משתמש בקצוות עורפיים של קבוצות מכונות. למידע נוסף, קראו על קיבוץ צמתים.			spec.loadBalancerClass: networking.gke.io/l4-regional-internal: נדרשת גרסת GKE‏ 1.33.1-gke.1779000 ואילך וגם הפעלת הגדרת קבוצת משנה ב-GKE. ‫networking.gke.io/load-balancer-type: "Internal": כל הגרסאות הנתמכות. מומלץ להשתמש ב-spec.loadBalancerClass אם האשכול שלכם משתמש ב-GKE בגרסה 1.33.1-gke.1779000 ואילך, והאפשרות GKE subsetting מופעלת בו. אי אפשר לשנות את המאפיין הזה אחרי שמחילים את מניפסט השירות על אשכול.
מאזן עומסי רשת אזורי חיצוני להעברת סיגנל ללא שינוי שמבוסס על שירות לקצה העורפי	התנהגות ברירת המחדל ב-GKE מגרסה 1.37 ואילך spec.loadBalancerClass: networking.gke.io/l4-regional-external cloud.google.com/l4-rbs: "enabled" הוראה ל-GKE ליצור מאזן עומסי רשת אזורי חיצוני להעברת סיגנל ללא שינוי. מאזן העומסים משתמש בקצוות עורפיים של GCE_VM_IP NEG אם מתקיים אחד מהתנאים הבאים: השירות נוצר באשכול שפועל ב-GKE בגרסה 1.37 ואילך. לא נדרשות הערות או סיווגים. קובץ המניפסט של השירות כולל את spec.loadBalancerClass: networking.gke.io/l4-regional-external והוא חל על אשכול שמופעלת בו גרסה GKE‏ ‎1.33.1-gke.1779000 עד 1.36. מניפסט השירות כולל את ההערה cloud.google.com/l4-rbs: "enabled" והוא מוחל על אשכול שמופעלת בו גרסה GKE‏ ‎1.32.2-gke.1652000 עד 1.36. בכל שאר המצבים, מאזן העומסים משתמש בקצוות עורפיים של קבוצות מכונות. מידע נוסף זמין במאמר בנושא קיבוץ צמתים.			‫spec.loadBalancerClass: networking.gke.io/l4-regional-external: נדרשת גרסה ‎1.33.1-gke.1779000 ואילך של GKE. ‫cloud.google.com/l4-rbs: "enabled": כל הגרסאות הנתמכות. מומלץ להשתמש ב-spec.loadBalancerClass אם האשכול שלכם משתמש בגרסה GKE 1.33.1-gke.1779000 עד 1.36. המאפיין הזה לא ניתן לשינוי אחרי שמחילים את המניפסט של השירות על אשכול. ב-GKE 1.37 ואילך, לא נדרשים שדות לסוג הזה של מאזן העומסים.
איזון עומסים משוקלל	networking.gke.io/weighted-load-balancing: "pods-per-node" מאפשר לצמתים עם יותר פודים להצגת מודעות לקבל חלק גדול יותר מהחיבורים החדשים בהשוואה לצמתים עם פחות פודים להצגת מודעות.			GKE 1.31.0 ואילך
מדיניות בנושא תנועה פנימית	spec.internalTrafficPolicy כשמגדירים את הערך Local, ‏GKE מנתב רק חבילות מ-Pods של לקוחות בצומת ל-Pods שמספקים שירות באותו צומת. כשמגדירים את הערך Cluster, ‏ GKE מעביר מנות מ-Pods של לקוחות בצומת ל-Pods של שרתים בכל צומת. פרטים נוספים מופיעים במאמר מדיניות תעבורה פנימית של שירות. הפרמטר הזה לא נתמך באשכולות שמופעל בהם GKE Dataplane V2.			‫GKE מגרסה 1.22 ואילך
מדיניות בנושא תנועה חיצונית	spec.externalTrafficPolicy הוא קובע אילו מכונות וירטואליות של צמתים עוברות בדיקות תקינות של מאזן העומסים, ואיך מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות מנות ההגדרה הזו גם קובעת איך הצמתים מקובצים ל-GCE_VM_IP NEGs כשמופעלת חלוקת משנה של GKE. פרטים נוספים זמינים במאמר מושגים של שירות LoadBalancer.			‫GKE 1.14 ואילך (‫1.23.4-gke.400 ואילך למאגר צמתים של Windows).
זיקה לאזור	spec.trafficDistribution: PreferSameZone הפעלת שיוך אזורי לשירותי LoadBalancer פנימיים. הזיקה לתחום (zonal) קובעת לאיזה תחום מאזן העומסים הפנימי להעברת סיגנל ללא שינוי ינתב תעבורה נכנסת עבור לקוחות תואמים, כשאפשר למצוא התאמה לתחום. כדי להשתמש בהעדפה אזורית, צריך להפעיל את תכונת החלוקה לקבוצות משנה ב-GKE (התכונה מופעלת כברירת מחדל מגרסה 1.36 של GKE ואילך). מידע נוסף זמין במאמר בנושא זיקה לאזור וחלוקת תנועה.			תצוגה מקדימה בגרסה GKE 1.33.3-gke.1392000 ואילך. זמין לכלל המשתמשים ב-GKE מגרסה 1.36 ואילך.
יציאת בדיקת תקינות	spec.healthCheckNodePort פריסה של בדיקת תקינות של מאזן עומסים לשירותי LoadBalancer. הפרמטר הזה תקף רק אם הערך של spec.externalTrafficPolicy הוא Local.			כל הגרסאות הנתמכות.
כללי חומת אש ורשימת היתרים של כתובות IP של מקור	spec.loadBalancerSourceRanges מגדירים כללי חומת אש אופציונליים ב-GKE וברשת ה-VPC כדי לאפשר רק טווחי מקור מסוימים. ‫kube-proxy גם מגדיר כללים של iptables להתאמה לטווחי המקור שצוינו.			כל הגרסאות הנתמכות.
כתובות IP סטטיות	‫spec.loadBalancerIP (IPv4 בלבד) networking.gke.io/load-balancer-ip-addresses מציינים כתובת IPv4 סטטית, טווח כתובות IPv6 סטטי או את שניהם, שמוקצים לכללי ההעברה של מאזן העומסים. במאמר שיקולים לשיתוף כתובת IP משותפת מפורטים דרישות הגדרה חשובות ופרטי הטמעה.			‫spec.loadBalancerIP: כל הגרסאות הנתמכות. ‫networking.gke.io/load-balancer-ip-addresses: GKE מגרסה 1.29 ואילך. מידע נוסף על דרישות להערות או להגדרת אשכולות נוספות זמין במאמר בנושא פרמטרים של כתובות IP סטטיות.
Network Service Tiers	cloud.google.com/network-tier מציינת את מסלולי שירות הרשת שבהם GKE משתמש עבור כלל ההעברה החיצוני וכתובת ה-IP. הערכים התקפים של ההערה הם Standard ו-Premium (ברירת מחדל).			‫GKE 1.19 ואילך.
רשת משנה בהתאמה אישית	networking.gke.io/internal-load-balancer-subnet networking.gke.io/load-balancer-subnet		‫ (רלוונטי רק ל-IPv6)	‫networking.gke.io/internal-load-balancer-subnet: כל הגרסאות הנתמכות ‫networking.gke.io/load-balancer-subnet: GKE 1.29 ואילך. מידע נוסף על דרישות נוספות זמין במאמר בנושא הערות לגבי רשתות משנה בהתאמה אישית.
גישה גלובלית	networking.gke.io/internal-load-balancer-allow-global-access: "true" מאפשר ללקוחות בכל אזור של רשת ה-VPC או של רשת מחוברת לגשת לכתובת ה-IP של כלל ההעברה.			גרסת טרום-השקה ב-GKE 1.16 ואילך. זמינות לכלל המשתמשים ב-GKE 1.17.9-gke.600 ואילך.
כל היציאות	אם מציינים יותר מחמש יציאות ייחודיות (עד 100) ב-spec.ports[].port,‏ GKE מגדיר אוטומטית את כלל ההעברה כך שישתמש בכל היציאות.			‫GKE בגרסה 1.18.19-gke.1400 ואילך
ipFamilyPolicy	spec.ipFamilyPolicy ההגדרה קובעת איך GKE מקצה כתובות IP לשירות. אפשר להגדיר את spec.ipFamilyPolicy בתור SingleStack, PreferDualStack או RequireDualStack. למידע נוסף, אפשר לקרוא את המאמר שירותים עם סטאק כפול של IPv4/IPv6.			אשכולות GKE בגרסה 1.29 ואילך תומכים ברשת עם שני סוגי כתובות (IPv4 ו-IPv6) עבור שירותי LoadBalancer.
‫ipFamilies (אופציונלי)	spec.ipFamilies הגדרת משפחת כתובות ה-IP להקצאת שירותים עם מחסנית יחידה או מחסנית כפולה. אפשר להשתמש בכל אחד מהערכים הבאים: ‫IPv4 רק לשירות IPv4 עם מחסנית יחידה. ‫IPv6 עבור שירות IPv6 בלבד. ‫IPv4,IPv6 בשירות עם סטאק כפול שבו כתובת ה-IP הראשית של השירות היא IPv4. ‫IPv6,IPv4 בשירות עם סטאק כפול שבו כתובת ה-IP הראשית של השירות היא IPv6.			אשכולות GKE בגרסה 1.29 ואילך תומכים ברשת עם שני סוגי כתובות (IPv4 ו-IPv6) עבור שירותי LoadBalancer.

יציאה של בדיקת תקינות

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

האפשרות להגדיר פרמטר healthCheckNodePort תלויה בהגדרות externalTrafficPolicy הבאות:

externalTrafficPolicy	יציאה של בדיקת תקינות
Cluster	אין לך אפשרות להשתמש ב-spec.healthCheckNodePort.
Local	אפשר לבחור יציאה מותאמת אישית באמצעות התג spec.healthCheckNodePort. אם לא מציינים יציאה, מישור הבקרה של Kubernetes מקצה יציאה לבדיקת תקינות מטווח היציאות של הצומת. הערה: תוכנת kube-proxy (באשכולות שלא משתמשים ב-GKE Dataplane V2) או cilium-agent (GKE Dataplane V2) מגיבה לחבילות שנשלחות ליציאת הצומת של בדיקת תקינות. פודים שמשרתים בקשות לא יכולים לענות לבדיקות תקינות של שירותי LoadBalancer.

אזהרה: אל תתאימו אישית את מאזן עומסי הרשת החיצוני האזורי להעברת סיגנל ללא שינוי או את מאזן עומסי הרשת הפנימי להעברת סיגנל ללא שינוי על ידי שינוי של משאב בדיקת התקינות שלו מחוץ ל-GKE. ב-GKE אין פרמטרים אחרים להתאמה אישית של בדיקות תקינות של מאזן עומסים שנוצרות עבור שירותי LoadBalancer.

כללי חומת אש ורשימת כתובות IP מותרות

אם לא הגדרתם את האשכול כך שידלג על יצירת כללי חומת אש של VPC לשירותי LoadBalancer,‏ GKE יוצר כלל חומת אש של VPC שמאפשר תעבורת נתונים נכנסת לכל שירות.

לכל כלל חומת אש שנוצר באופן אוטומטי יש את המאפיינים הבאים:

• הכיוון של כלל חומת האש הוא תעבורת נתונים נכנסת, והפעולה שלו היא "אישור". כללי חומת האש שמוגדרים כברירת מחדל לסירוב מרומז של תנועת כניסה ב- Google Cloudאומרים ש-GKE משתמש במודל של רשימת היתרים כשיוצרים כללי חומת אש לתנועת כניסה.
• ‫GKE מגדיר את הפרוטוקול ואת יציאת היעד של כלל חומת האש בהתאם לאלה שצוינו ברשימת spec.ports[] של השירות.
• ‫GKE מגדיר כללי חומת אש לשירותי LoadBalancer על ידי הגדרה מפורשת של פרמטר היעד לכתובת ה-IP הווירטואלית של LoadBalancer (כלל ההעברה של מאזן העומסים).
• ‫GKE מגדיר את הפרמטר target של כלל חומת האש כך שיכלול את כל הצמתים באשכול.
• אם השירות כולל spec.loadBalancerSourceRanges[], GKE מגדיר את פרמטר המקור של כלל חומת האש לכתובות ה-IP שברשימה הזו. בנוסף, GKE מגדיר מסלולים וכללים במערכת ההפעלה של הצומת כדי להגביל את כתובות ה-IP של המקור לתנועה מאוזנת עומסים, באמצעות kube-proxy ו-iptables (באשכולות שלא משתמשים ב-GKE Dataplane V2) או cilium-agent וכללי eBPF (באשכולות עם GKE Dataplane V2). אם השירות לא כולל את loadBalancerSourceRanges[], ‏ GKE מגדיר את פרמטר המקור של כלל חומת האש לכל כתובות ה-IP‏ (0.0.0.0/0).

כתובות IP סטטיות

אתם יכולים ליצור כתובת IP סטטית ולהגדיר את GKE כך שיקצה את הכתובת הסטטית הזו לכלל ההעברה של מאזן העומסים. שימוש בכתובת IP סטטית מבטיח שכתובת ה-IP של מאזן העומסים תישאר זהה גם אם תבצעו שינויים בשירות LoadBalancer. בלי כתובת IP סטטית, יכול להיות ש-GKE יקצה כתובת IP אחרת לכלל העברה של מאזן העומסים כשמעדכנים LoadBalancerService. כתובת ה-IP של כלל ההעברה לא זהה לכתובת של שירות spec.clusterIP. כתובת ה-ClusterIP של שירות אף פעם לא משתנה כשמעדכנים שירות LoadBalancer.

פרמטרים של כתובת IP סטטית

כדי להגדיר ששירות LoadBalancer ישתמש בכתובת IP סטטית, משתמשים בפרמטר spec.loadBalancerIP או בהערה networking.gke.io/load-balancer-ip-addresses. ב-GKE בגרסה 1.29 ואילך, ההערה מקבלת עדיפות על פני spec.loadBalancerIP אם מניפסט השירות מכיל גם את הפרמטר וגם את ההערה.

פרמטר או הערה וערך	דרישות ויכולות
spec.loadBalancerIP: IPv4_ADDRESS	אתם יכולים לציין כתובת IPv4 פנימית סטטית לשירות Internal LoadBalancer שמבוסס רק על IPv4. אפשר לציין כתובת IPv4 חיצונית סטטית לשירות External LoadBalancer עם IPv4 בלבד. הפרמטר פועל עם כל הגרסאות הנתמכות של GKE.
networking.gke.io/load-balancer-ip-addresses: IP_ADDRESS_RESOURCE_NAME בשירותי LoadBalancer עם ערימה יחידה, צריך להגדיר את הערך של ההערה לשם משאב כתובת IPv4 או IPv6, ולא לכתובת ה-IP עצמה. בשירותי LoadBalancer עם סטאק כפול, מגדירים את הערך של האנוטציה לשם המשאב של כתובת ה-IPv4 הסטטית ולשם המשאב של טווח כתובות ה-IPv6 הסטטי, כשהם מופרדים בפסיק.	אתם יכולים לציין כתובת IPv4 סטטית, טווח כתובות IPv6 סטטי או את שניהם לשירותים של מאזני עומסים פנימיים וחיצוניים עם IPv4 בלבד, עם IPv6 בלבד ועם סטאק כפול. ההערה דורשת GKE 1.29 או גרסה מתקדמת יותר, וגם את הדרישות הנוספות הבאות: כדי להשתמש בהערה הזו עם שירות Internal LoadBalancer, צריך להפעיל באשכול את GKE subsetting. הגדרת קבוצת משנה ב-GKE מופעלת כברירת מחדל בגרסה 1.36 של GKE ואילך. כדי להשתמש בהערה הזו עם שירות External LoadBalancer, צריך להגדיר את השדה spec.loadBalancerClass לערך networking.gke.io/l4-regional-external במניפסט של השירות כשיוצרים את שירות External LoadBalancer.

שיקולים לגבי שיתוף של כתובת IP משותפת

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

• כתובות IPv6 סטטיות הן למעשה טווחי כתובות IPv6 של /96, אבל GKE מגדיר צמתים רק כדי לקבל חבילות בכתובת ה-IPv6 הראשונה (/128) בטווח /96.

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

	שירות Internal LoadBalancer	שירות External LoadBalancer
מפרט הניוד	כללי העברה למאזני עומסי רשת פנימיים להעברת סיגנל ללא שינוי תומכים בעד חמישה מספרי יציאות נפרדים, או שאפשר להגדיר אותם לשימוש בכל היציאות. אם בשירות Internal LoadBalancer מצוינים יותר מחמישה spec.ports[], ‏ GKE מגדיר את כלל ההעברה של מאזן העומסים הפנימי להעברת סיגנל ללא שינוי לשימוש בכל היציאות. כללי העברה עם אותה כתובת IP ואותו פרוטוקול לא יכולים לכלול יציאות חופפות. כלומר, אי אפשר ליצור כמה שירותים של מאזן עומסים פנימי שמשתפים את אותה כתובת IP, פרוטוקול ויציאות. לדוגמה: אם יוצרים שירות Internal LoadBalancer באמצעות יציאת TCP 80, אי אפשר ליצור שירות אחר באמצעות יציאות TCP 80,‏ 81 ו-90 כי יש חפיפה בין יציאה 80. אם שירות Internal LoadBalancer משתמש ביציאות TCP‏ 80, 8080 ו-90, אי אפשר ליצור שירות אחר שמשתמש ב-TCP בכל היציאות, כי גם זה יגרום לחפיפה בין היציאות. מידע נוסף זמין במאמר כללי העברה של מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי שמשתמשים בכתובת IP משותפת.	באשכולות שמריצים גרסאות GKE מוקדמות מ-1.37,‏ GKE יוצר מאגר יעד שמבוסס על מאזן עומסי רשת אזורי חיצוני להעברת סיגנל ללא שינוי, אם במניפסט של שירות LoadBalancer לא מוגדר השדה spec.loadBalancerClass לערך networking.gke.io/l4-regional-external, או אם הוא לא כולל את ההערה cloud.google.com/l4-rbs: "enabled". באשכולות שמופעלת בהם GKE בגרסה 1.37 ואילך, צריך להגדיר במפורש את spec.loadBalancerClass: "networking.gke.io/l4-regional-external-legacy" כדי ליצור מאגר יעדים שמבוסס על מאזן עומסים אזורי חיצוני של רשתות להעברת סיגנל ללא שינוי. בכללי העברה של מאזנים חיצוניים אזוריים של עומסי רשת להעברת סיגנל ללא שינוי, שמבוססים על מאגרי יעד, צריך להשתמש בטווחי יציאות רציפים. טווח היציאות הרציף כולל את כל היציאות שהשירות צריך, אבל יכול להיות שהטווח יכלול גם יציאות נוספות שלא נמצאות בשימוש השירות. לדוגמה, שירות External LoadBalancer שמופעל על ידי מאזן עומסים אזורי חיצוני של רשת להעברת סיגנל ללא שינוי שמבוסס על מאגר יעד ומציין יציאות 80 ו-443 במניפסט השירות שלו, משתמש בכלל להעברת נתונים של מאזן עומסים עם טווח יציאות של 80-443. טווח היציאות הזה מונע משירותים אחרים של איזון עומסים חיצוני להשתמש ביציאות 80, 443 ובכל המספרים שבין 80 ל-443. בגרסה 1.37 ואילך, GKE יוצר כברירת מחדל מאזן עומסי רשת אזורי חיצוני להעברת סיגנל ללא שינוי שמבוסס על שירות קצה עורפי. בגרסאות קודמות, GKE יוצר את מאזן העומסים אם מניפסט השירות LoadBalancer כולל את השדה spec.loadBalancerClass שהערך שלו מוגדר ל-networking.gke.io/l4-regional-external. כללי העברה למאזני עומסי רשת אזוריים חיצוניים להעברת סיגנל ללא שינוי שמבוססים על שירותים לקצה העורפי תומכים בעד חמישה מספרי יציאות נפרדים או בטווח יציאות רציף.
Network Service Tiers	אי אפשר להגדיר – כתובות פנימיות הן תמיד במסלול פרימיום.	אפשר להגדיר את זה לכתובות IPv4 חיצוניות אזוריות סטטיות. אפשר ליצור טווחים סטטיים של כתובות IPv6 חיצוניות אזוריות רק במסלול הפרימיום. מסלול שירות הרשת של כתובת ה-IP החיצונית הסטטית צריך להיות זהה לאחד מהבאים: השכבה שצוינה בהערה cloud.google.com/network-tier במניפסט של LoadBalancer Service, אם ההערה הזו מופיעה במניפסט, או רמת ברירת המחדל של הפרויקט, אם ההערה cloud.google.com/network-tier לא קיימת במניפסט של שירות LoadBalancer. מסלול ברירת המחדל של הפרויקט הוא פרימיום, אלא אם הגדרתם אותו אחרת.

שמירת כתובת IP

‫GKE לא שומר את כתובות ה-IP הסטטיות שהוגדרו באמצעות ההערות spec.loadBalancerIP או networking.gke.io/load-balancer-ip-addresses. כלומר, כתובת ה-IP שהקציתם לשירות יכולה להשתחרר כשהשירות נמחק.

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

• להיות אזורי בלבד.
• להיות באותו אזור כמו האשכול.
• להיות באותם מסלולי שירות רשת כמו שירות LoadBalancer.
• השם לא יכול להיות זהה לשם של LoadBalancer, להתחיל בקידומות כמו k8s- או להיות זהה ל-UUID של השירות.

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

רשת משנה של מאזן עומסים

אתם יכולים להגדיר ששירות Internal LoadBalancer ישתמש בכתובת IPv4 ארעית או סטטית, בטווח כתובות IPv6 או בשניהם, ברשת משנה בהתאמה אישית שנמצאת באותו אזור ובאותה רשת VPC כמו האשכול. שימוש ברשת משנה בהתאמה אישית לשירות Internal LoadBalancer כדי:

• לקבץ מאזני עומסי רשת פנימיים להעברת סיגנל ללא שינוי שנוצרו על ידי שירותי Internal LoadBalancer משני אשכולות GKE או יותר באותה רשת VPC ואותו אזור.
• יוצרים שירותים של מאזן עומסים פנימי, שמאזני העומסים הפנימיים שלהם להעברת סיגנל ללא שינוי כוללים כתובות IPv4 נפרדות מכתובות ה-IPv4 של הצמתים באשכול.
• בקלסטר עם סטאק כפול, יוצרים שירותים של מאזן עומסים פנימי שהמאזנים הפנימיים של עומסי הרשת להעברת סיגנל ללא שינוי שלהם כוללים טווחי כתובות IPv6 נפרדים מכתובות ה-IPv6 של הצמתים וה-Pods בקלסטר. אם לרשת המשנה של האשכול יש טווח כתובות IPv6 חיצוני, חובה להשתמש ברשת משנה מותאמת אישית של LoadBalancer כדי לתמוך בשירותי LoadBalancer פנימיים.

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

הערה: האנוטציה המותאמת אישית של רשת המשנה לא משפיעה על הבחירה של כתובת IPv4 חיצונית לשירות מאזן עומסים חיצוני, כי כתובות IPv4 למאזני עומסים אזוריים חיצוניים מסוג Network Load Balancer לא מגיעות מטווחים של רשתות משנה של רשת VPC.

הערות לרשתות משנה בהתאמה אישית

כדי להנחות את שירות LoadBalancer להשתמש בכתובת IP זמנית או סטטית ברשת משנה מותאמת אישית, משתמשים באחת מההערות הבאות. אם מניפסט של שירות LoadBalancer כולל את שתי ההערות, ההערה networking.gke.io/load-balancer-subnet מקבלת עדיפות, בתנאי שהדרישות שלה מתקיימות.

הערה וערך	דרישות ויכולות
networking.gke.io/internal-load-balancer-subnet: SUBNET_RESOURCE_NAME	אפשר להשתמש בהערה רק כדי לציין רשת משנה בהתאמה אישית לשירות Internal LoadBalancer עם IPv4 בלבד. ההערה פועלת עם כל הגרסאות הנתמכות של GKE.
networking.gke.io/load-balancer-subnet: SUBNET_RESOURCE_NAME	אפשר לציין תת-רשת מותאמת אישית לשירות Internal LoadBalancer עם IPv4 בלבד, IPv6 בלבד או סטאק כפול. אפשר לציין רשת משנה בהתאמה אישית לשירות External LoadBalancer עם IPv6 בלבד או עם שני סוגי הכתובות. ההערה דורשת GKE בגרסה 1.29 ואילך, וגם את הדרישות הנוספות הבאות: כדי להשתמש בהערה הזו כדי לציין רשת משנה בהתאמה אישית לשירות Internal LoadBalancer, צריך להפעיל באשכול חלוקה לרשתות משנה ב-GKE. החל מגרסה 1.36 ואילך, התכונה 'חלוקת משנה של GKE' מופעלת כברירת מחדל. כדי להשתמש בהערה הזו כדי לציין רשת משנה בהתאמה אישית לשירות External LoadBalancer, צריך להגדיר מאזן עומסים שמבוסס על שירות לקצה העורפי. ב-GKE מגרסה 1.37 ואילך, ההגדרה הזו היא התנהגות ברירת המחדל. בגרסאות קודמות, כשיוצרים את שירות External LoadBalancer, צריך לכלול את השדה spec.loadBalancerClass עם הערך networking.gke.io/l4-regional-external במניפסט של השירות.

תת-רשת וכתובת IPv4 לשירות Internal LoadBalancer

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

	כתובת IPv4 סטטית ב-IPv4 בלבד, אפשר לציין באמצעות הפרמטר של כתובת ה-IP הסטטית. במקרה של dual-stack, צריך לציין את הערך באמצעות ההערה networking.gke.io/load-balancer-ip-addresses.	כתובת IPv4 זמנית
תת-רשת בהתאמה אישית צריך להיות באותה רשת VPC ואותו אזור כמו האשכול. ב-IPv4 בלבד, אפשר לציין באמצעות אחת מההערות של תת-רשת בהתאמה אישית. במקרה של כתובות IPv4 ו-IPv6, צריך לציין את הכתובת באמצעות ההערה networking.gke.io/load-balancer-subnet.	רשת משנה בהתאמה אישית וכתובת IPv4 סטטית: כתובת ה-IPv4 הפנימית הסטטית חייבת להיווצר בטווח הכתובות הראשי של IPv4 ברשת המשנה בהתאמה אישית.	רשת משנה מותאמת אישית וכתובת IPv4 ארעית: ‏ GKE משתמש בכתובת IPv4 פנימית שלא הוקצתה בטווח הכתובות הראשי של IPv4 ברשת המשנה המותאמת אישית.
רשת משנה של אשכול	רשת משנה של אשכול וכתובת IPv4 סטטית: כתובת ה-IPv4 הפנימית הסטטית צריכה להיווצר בטווח הכתובות הראשי של IPv4 ברשת המשנה של האשכול.	רשת משנה של אשכול וכתובת IPv4 זמנית: GKE משתמש בכתובת IPv4 פנימית שלא הוקצתה בטווח כתובות ה-IPv4 הראשי של רשת המשנה של האשכול.

תת-רשת וטווח כתובות IPv6 לשירות Internal LoadBalancer

בטבלה הבאה מפורטות שילובים של הגדרות תקינות של רשתות משנה וטווח כתובות IPv6 לשירות איזון עומסים פנימי עם IPv6 בלבד או עם תמיכה כפולה. למרות שכלל ההעברה של מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי של IPv6 משתמש בטווח כתובות IPv6 פנימיות של /96, ‏ GKE מגדיר רק צמתים לקבלת מנות שהיעדים שלהן תואמים לכתובת ה-IPv6 הראשונה (/128) בטווח /96 של כלל ההעברה.

	טווח כתובות IPv6 סטטיות צריך לציין את הערך באמצעות ההערה networking.gke.io/load-balancer-ip-addresses	טווח כתובות IPv6 זמניות
רשת משנה מותאמת אישית עם פרוטוקול כפול חייב להיות באותה רשת VPC ובאותו אזור כמו האשכול. חייב להיות טווח כתובות IPv6 פנימי (סוג הגישה INTERNAL). חובה לציין את המאפיין באמצעות האנוטציה networking.gke.io/load-balancer-subnet.	רשת משנה בהתאמה אישית וטווח כתובות IPv6 סטטיות: טווח כתובות ה-IPv6 הסטטיות הפנימיות /96 חייב להיווצר בטווח כתובות ה-IPv6 הפנימיות של רשת המשנה בהתאמה אישית /64.	טווח כתובות IPv6 ארעיות ורשת משנה בהתאמה אישית: GKE משתמש בטווח כתובות IPv6 פנימיות מסוג /96 שלא הוקצו, מתוך טווח כתובות IPv6 פנימיות מסוג /64 של רשת המשנה בהתאמה אישית.
רשת משנה בשני פרוטוקולים של אשכול חייב להיות טווח כתובות IPv6 פנימי (סוג הגישה INTERNAL).	רשת המשנה של האשכול וטווח כתובות ה-IPv6 הסטטיות: טווח כתובות ה-IPv6 הפנימיות הסטטיות של /96 חייב להיווצר בטווח כתובות ה-IPv6 הפנימיות של /64 ברשת המשנה של האשכול.	תת-רשת של האשכול וטווח כתובות IPv6 ארעיות: ‫GKE משתמש בטווח כתובות IPv6 פנימיות /96 שלא הוקצה, מתוך טווח כתובות IPv6 פנימיות /64 של תת-הרשת של האשכול.

תת-רשת וכתובת IPv4 לשירות External LoadBalancer

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

תת-רשת וטווח כתובות IPv6 לשירות External LoadBalancer

בטבלה הבאה מתוארים שילובים תקינים של מפרט רשת משנה וטווח כתובות IPv6 לשירות External LoadBalancer עם IPv6 בלבד או עם שני סוגי כתובות IP. למרות שכלל ההעברה של IPv6 במאזן העומסים החיצוני האזורי של רשת ה-Passthrough משתמש בטווח כתובות IPv6 חיצוני של /96, ‏GKE מגדיר את הצמתים כך שיקבלו רק חבילות שהיעדים שלהן תואמים לכתובת ה-IPv6 הראשונה (/128) בטווח /96 של כלל ההעברה.

	טווח כתובות IPv6 סטטיות צריך לציין את הערך באמצעות ההערה networking.gke.io/load-balancer-ip-addresses	טווח כתובות IPv6 זמניות
רשת משנה מותאמת אישית עם פרוטוקול כפול צריך להיות באותה רשת VPC ואותו אזור כמו האשכול. חייב להיות טווח כתובות IPv6 חיצוני (סוג גישה EXTERNAL). חובה לציין את המאפיין באמצעות האנוטציה networking.gke.io/load-balancer-subnet.	רשת משנה בהתאמה אישית וטווח כתובות IPv6 סטטיות: טווח כתובות ה-IPv6 החיצוניות הסטטיות /96 צריך להיווצר בטווח כתובות ה-IPv6 החיצוניות של רשת המשנה בהתאמה אישית /64. אפשר ליצור טווחים של כתובות IPv6 חיצוניות סטטיות רק במסלול הפרימיום.	תת-רשת בהתאמה אישית וטווח כתובות IPv6 ארעיות: ‫GKE משתמש בטווח כתובות IPv6 חיצוניות /96 שלא הוקצה, מתוך טווח כתובות IPv6 חיצוניות /64 של תת-הרשת בהתאמה אישית.
רשת משנה בשני פרוטוקולים של אשכול חייב להיות טווח כתובות IPv6 חיצוניות (סוג הגישה EXTERNAL).	רשת המשנה של האשכול וטווח כתובות ה-IPv6 הסטטיות: טווח כתובות ה-IPv6 החיצוניות הסטטיות של /96 חייב להיווצר בטווח כתובות ה-IPv6 החיצוניות של /64 ברשת המשנה של האשכול. אפשר ליצור טווחים של כתובות IPv6 חיצוניות סטטיות רק במסלול הפרימיום.	רשת משנה של אשכול וטווח כתובות IPv6 זמניות: GKE משתמש בטווח כתובות IPv6 חיצוניות מסוג /96 שלא הוקצו, מתוך טווח כתובות IPv6 חיצוניות מסוג /64 של רשת המשנה של האשכול.

גישה גלובלית

אם האנוטציה networking.gke.io/internal-load-balancer-allow-global-access מוגדרת כ-false או לא מוגדרת לשירות Internal LoadBalancer,‏ GKE יוצר מאזן עומסי רשת פנימי להעברת סיגנל ללא שינוי, שכלל ההעברה שלו מוגדר ללא גישה גלובלית. כשהגישה הגלובלית מושבתת, לקוחות שצריכים לגשת למאזן העומסים חייבים להיות באותו אזור ורשת VPC, או ברשת שמחוברת לרשת ה-VPC של האשכול.

כשמשתמשים בnetworking.gke.io/internal-load-balancer-allow-global-accessהערה true בשירות Internal LoadBalancer, ‏ GKE מפעיל את אפשרות הגישה הגלובלית בכלל ההעברה של מאזן עומסים פנימי של רשת להעברת סיגנל ללא שינוי. לקוחות שנמצאים באזור כלשהו ברשת ה-VPC או ברשת שמחוברת לרשת ה-VPC של האשכול יכולים לגשת למאזן העומסים.

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

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

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

כל כללי העברת היציאות

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

ב-GKE, שירות Internal LoadBalancer יכול לתמוך רק ב-100 יציאות ב-spec.ports[].port של השירות. אם שירות Internal LoadBalancer מגדיר עד חמש יציאות, כלל ההעברה יכלול את היציאות הספציפיות האלה. עם זאת, אם בשירות מצוינות יותר מחמש יציאות, כלל ההעברה יוגדר אוטומטית כך שיתאים לכל היציאות. כשמגדירים כלל העברה לשימוש בכל היציאות, GKE יוצר רק כללים בחומת האש של תעבורת נתונים נכנסת (ingress) עבור היציאות הספציפיות שהוגדרו ב-spec.ports[].port בשירות.

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

שירות LoadBalancer עם סטאק כפול של IPv4/‏IPv6

אפשר ליצור שירות LoadBalancer פנימי או חיצוני שיכול להיות חד-ערוצי (IPv4 בלבד או IPv6 בלבד) או דו-ערוצי. בשירותי LoadBalancer עם מחסנית אחת נוצר כלל העברה אחד עם כתובת IPv4 או כתובת IPv6. שירותי LoadBalancer עם סטאק כפול יוצרים שני כללי העברה: אחד עם כתובת IPv4 ואחד עם כתובת IPv6. כדי ליצור שירות LoadBalancer עם סטאק כפול של IPv4/IPv6, פורסים אותו באשכול עם סטאק כפול של IPv4/IPv6 ומבצעים את אחת מהפעולות הבאות, בהתאם לסוג של מאזן העומסים שבו משתמשים:

• בשביל שירותים של מאזן עומסים פנימי, צריך להפעיל את התכונה 'חלוקה לקבוצות משנה' ב-GKE. ההגדרה 'חלוקת משנה של GKE' מופעלת כברירת מחדל באשכולות עם תמיכה כפולה. מידע נוסף זמין במאמר הפעלת חלוקת משנה של מאזן עומסים פנימי.
• בשביל שירותי External LoadBalancer, צריך להשתמש במאזן עומסי רשת אזורי חיצוני להעברת סיגנל ללא שינוי שמבוסס על שירות קצה עורפי. מידע נוסף זמין במאמר בנושא מאזן עומסי רשת חיצוני שמבוסס על שירות לקצה העורפי.

לכל שירות, אפשר להגדיר מפרטים של ipFamilyPolicy ושל ipFamilies. מידע נוסף זמין במאמר בנושא מערך כפול של IPv4/IPv6.

הגבלות על שירותי LoadBalancer עם מחסנית כפולה

• שירותי LoadBalancer עם כתובות IPv6 נתמכים רק באשכולות עם סוג הערימה ipv4-ipv6. מידע נוסף על שימוש בכתובת IP כפולה עבור אשכול המותאם ל-VPC

• אי אפשר לשדרג שירותים של LoadBalancer שנוצרו עם כתובת חד-ערוצית לשירותים דו-ערוציים.

• אפשר לשנות שירותים מסוג LoadBalancer שנוצרו עם כתובות dual-stack ל-single stack בהתאם לתנאים הבאים:

  • אפשר לשנות שירות עם ipFamilies ["IPv4","IPv6"] לשירות עם ipFamilies IPv4 אבל לא לשירות עם IPv6.
  • אפשר לשנות שירות עם ipFamilies ["IPv6","IPv4"] לשירות עם ipFamilies IPv6 אבל לא לשירות עם IPv4.

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

• מידע נוסף על שירותי איזון עומסים
• איך מגדירים מאזן עומסים פנימי
• סקירה כללית על Ingress למאזני עומסים של אפליקציות
• איך משתמשים בקבוצות NEG עצמאיות
• מידע נוסף על כללי חומת אש של VPC