מסמך עזר בנושא מאפייני הגדרה

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

סינון הדף הזה

כדי לסנן את המאפיינים שמוצגים בדף הזה, בוחרים באפשרות Basic (המאפיינים הנפוצים ביותר) או באפשרות Advanced (מאפיינים שצריך לשנות רק לעיתים רחוקות):

קמפיינים לרשת המדיה   מאפייני ההגדרות האישיות שבדף הזה.

מאפיינים ברמה העליונה

בטבלה הבאה מתוארים המאפיינים ברמה העליונה בקובץ overrides.yaml. אלה מאפיינים שלא שייכים לאובייקט אחר, והם חלים ברמת הארגון או הסביבה:

מאפיין (property) סוג תיאור
axHashSalt Advanced

נוסף בגרסה: 1.3.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-org

אופציונלי

השם של סוד של Kubernetes שמכיל ערך גיבוב (salt) שמשמש לחישוב גיבובים כדי לטשטש נתוני משתמשים לפני שהם נשלחים לניתוח ב-Apigee. אם לא מציינים ערך גיבוב, המערכת משתמשת ב-iloveapis123 כברירת מחדל. יוצרים את הסוד עם ערך ה-salt כקלט. אפשר להשתמש באותו ערך salt בכמה אשכולות כדי להבטיח תוצאות גיבוב עקביות בין האשכולות.

‫Apigee משתמשת ב-SHA512 כדי לגבב את הערך המקורי לפני שליחת הנתונים ממישור זמן הריצה למישור הבקרה.

איך מסתירים נתוני משתמשים לצורך ניתוח

contractProvider Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: https://apigee.googleapis.com

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

מגדיר את נתיב ה-API לכל ממשקי ה-API בהתקנה.

חובה אם ההתקנה ההיברידית משתמשת במיקום אחסון הנתונים בפורמט הבא:

contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com

‫CONTROL_PLANE_LOCATION הוא המיקום שבו מאוחסנים נתוני מישור הבקרה, כמו חבילות שרת proxy. רשימת האזורים הזמינים של מישור הבקרה של Apigee API

לדוגמה:

contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled בסיסי נוספה בגרסה: 1.14.0

ערך ברירת המחדל: true

תרשים: apigee-telemetry

הפעלת התאמה אוטומטית לעומס (autoscaling) מבוססת-מדדים של Apigee כשהערך מוגדר ל-true (ברירת המחדל). מגדירים את הערך false כדי להשבית את ההתאמה האישית של קנה המידה.

כדי להחיל שינויים על customAutoscaling.enabled, צריך לעדכן את התרשים apigee-telemetry.

enhanceProxyLimits Advanced נוספה בגרסה: 1.14.0

ערך ברירת המחדל: false

תרשים: apigee-org, apigee-virtualhost

חובה

ההרשאה enhanceProxyLimits נדרשת לתכונה "מגבלות משופרות לשרתי proxy לכל סביבה" של Apigee. צריך להגדיר את האפשרות הזו לערך enhanceProxyLimits: true אם הארגון ההיברידי שלך זכאי למגבלות משופרות של שרתי proxy לכל סביבה.

אפשר לעיין במאמרים הבאים:

ההגדרה enhanceProxyLimits: true נדרשת לשרשור שרתי proxy, לשרשור נקודות קצה ולשרשור ServiceCallout. למידע נוסף:

מחילים את השינויים על enhanceProxyLimits על ידי עדכון התרשים apigee-org והתרשים apigee-virtualhost לכל קבוצת סביבות.

gcpProjectID Advanced Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.projectID.

נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry, apigee-org

חובה

מזהה הפרויקט ב-Google Cloud. הוא פועל עם k8sClusterName (הוצא משימוש) ו-gcpRegion (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics ידחפו את הנתונים שלהם.

gcpRegion Advanced Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.region.

נוספה בגרסה: 1.0.0

ערך ברירת המחדל: us-central1

תרשים: apigee-telemetry, apigee-org

חובה

האזור או התחום (zone) הקרוב ביותר ב-Google Cloud לאשכול Kubernetes. הוא פועל עם gcpProjectID (הוצא משימוש) ועם k8sClusterName (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics דוחפים את הנתונים שלהם.

hub Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

כתובת ה-URL של מאגר פרטי של קונטיינרים של קובצי אימג', שמשמש לשליפת קובצי אימג' לכל רכיבי Apigee ממאגר פרטי.

‫hub מספק נתיב ברירת מחדל לכל הרכיבים של Apigee Hybrid. אם אתם משתמשים במאגר פרטי, השתמשו ב-hub כדי להגדיר את כתובת ה-URL של המאגר לכל הרכיבים, במקום להשתמש במאפיין image.url הנפרד לכל רכיב. צריך להגדיר כתובות URL נפרדות רק אם משתמשים במאגר נפרד לרכיב ספציפי.

נתיב התמונה של כל רכיב בנפרד יהיה הערך של hub בתוספת שם התמונה והתג של הרכיב.

לדוגמה, אם הערך של hub הוא private-docker-host.example.com, רכיבים ספציפיים יפתרו באופן אוטומטי את נתיב התמונה:

hub: private-docker-host.example.com

כ:

containers:
- name: apigee-udca
  image: private-docker-host.example.com/apigee-udca:1.17.4
  imagePullPolicy: IfNotPresent

הרכיבים האחרים יפעלו לפי דפוס דומה.

אפשר להשתמש ב-apigee-pull-push --list כדי לראות את כתובת ה-URL של המאגר הנוכחי של כל הרכיבים.

מידע נוסף זמין במאמר שימוש במאגר תמונות פרטי עם Apigee hybrid.

אפשר לשנות את כתובת ה-URL של התמונה ברכיבים ספציפיים באמצעות המאפיינים הבאים:

imagePullSecrets[].name Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, apigee-redis, apigee-org, apigee-env

שם הסוד של Kubernetes שמוגדר כסוג docker-registry; משמש לשליפת קובצי אימג' ממאגר פרטי.

instanceID בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

חובה

מזהה ייחודי של ההתקנה הזו.

מחרוזת ייחודית לזיהוי המופע הזה. השם יכול להיות כל שילוב של אותיות ומספרים באורך של עד 63 תווים.

kmsEncryptionKey Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: defaults.org.kmsEncryptionKey

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret.

הנתיב במערכת הקבצים המקומית למפתח ההצפנה של נתוני KMS ב-Apigee.

kmsEncryptionPath Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret.

הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים

kmsEncryptionSecret.key Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret.

המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

kmsEncryptionSecret.name Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret.

השם של סוד של Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

kvmEncryptionKey Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: defaults.org.kmsEncryptionKey

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret.

הנתיב במערכת הקבצים המקומית למפתח ההצפנה של נתוני ה-KVM של Apigee.

kvmEncryptionPath Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret.

הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים

kvmEncryptionSecret.key Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret.

המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

kvmEncryptionSecret.name Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret.

השם של סוד של Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

multiOrgCluster Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: false

תרשים: apigee-telemetry

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

namespace בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: apigee

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

מרחב השמות של אשכול Kubernetes שבו יותקנו רכיבי Apigee.

org בסיסי

נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-telemetry, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

חובה

הארגון שמופעלת בו הגרסה ההיברידית, שהוקצה לכם על ידי Apigee במהלך ההתקנה של הגרסה ההיברידית. ארגון הוא מאגר ברמה העליונה ב-Apigee. הוא מכיל את כל שרתי ה-proxy ל-API ומקורות מידע שקשורים לנושא. אם הערך ריק, צריך לעדכן אותו בשם הארגון אחרי שיוצרים אותו.

revision Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: "1174" (גרסת Apigee Hybrid ללא נקודות. לדוגמה, בגרסה 1.12.0, ערך ברירת המחדל הוא "1120".)

תרשים: apigee-operator

‫Apigee hybrid תומך בעדכוני Kubernetes מתגלגלים, שמאפשרים לעדכן את הפריסה בלי זמן השבתה, על ידי עדכון מצטבר של מכונות Pod עם מכונות חדשות.

כשמעדכנים שינויים מסוימים ב-YAML שגורמים לשינוי ב-Kubernetes PodTemplateSpec הבסיסי, צריך לשנות גם את מאפיין השינוי revision ב-override.yaml של הלקוח. הפעולה הזו נדרשת כדי שבקר ApigeeDeployment (AD)‎ של Kubernetes יוכל לבצע עדכון הדרגתי (rolling) בטוח מהגרסה הקודמת לגרסה החדשה. אפשר להשתמש בכל ערך טקסט באותיות קטנות, למשל: blue,‏ a,‏ 1.0.0

כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) של כל הרכיבים

שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision:

מידע נוסף זמין במאמר עדכונים בהדרגה (rolling).

serviceAccountSecretProviderClass Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-env, apigee-org, apigee-telemetry

השם של מחלקת ספק הסודות הספציפית לארגון (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault.

אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault

tolerations.effect Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

הגדרה של ברירת מחדל גלובלית לתכונה Taints and Tolerations של Kubernetes בכל הרכיבים של Apigee Hybrid.

השדה effect מציין את השפעת ה-taint על צומת שה-toleration הזו תואמת לו. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

tolerations.key Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

tolerations.operator Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: "Equal"

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

tolerations.value Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, ‏apigee-env, ‏apigee-ingress-manager, ‏apigee-operator, ‏apigee-org, ‏apigee-redis, ‏apigee-telemetry, ‏apigee-virtualhost

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ao

‫Apigee Operators‏ (AO) יוצר ומעדכן משאבים ברמה נמוכה של Kubernetes ו-Istio שנדרשים כדי לפרוס ולתחזק רכיב. לדוגמה, הבקר מבצע את ההשקה של מעבדי הבקשות.

בטבלה הבאה מתוארים המאפיינים של האובייקט apigee-operators ao:

מאפיין (property) סוג תיאור
ao.args.disableIstioConfigInAPIServer Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: true

תרשים: apigee-ingress-manager

הפסקת האספקה של הגדרות אישיות מ-Apigee ל-Cloud Service Mesh שהלקוח התקין.

  • צריך להגדיר את הערך true להתקנות היברידיות שמשתמשות בשער הכניסה של Apigee.
  • צריך להגדיר את הערך false להתקנות היברידיות באמצעות Cloud Service Mesh (גרסאות Apigee hybrid 1.8‎ וגרסאות קודמות).
ao.args.disableManagedClusterRoles Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: true

תרשים: apigee-operator

כשהערך הוא true (ברירת המחדל), Apigee Hybrid לא מנהל ישירות את ClusterRole ו-ClursterRoleBinding של Kubernetes. אם יש לכם תהליך שדורש ניהול של המשאבים האלה, התהליך צריך להתבצע על ידי משתמש עם ההרשאות המתאימות.

ao.args.valkeyBackend Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: false

תרשים: apigee-operator

מגדירים את הדגל --valkey-backend של מפעיל Apigee. כאשר true, זמן הריצה משתמש במשאב ApigeeValkey שצוין בשדה valkeyRef של ApigeeOrganization, אם valkeyRef מוגדר ולמשאב הזה יש את המצב running. אחרת, זמן הריצה משתמש במשאב ApigeeRedis שצוין ב-redisRef.

בגרסה 1.17.3, צריך להשאיר את המאפיין הזה מוגדר לערך false. שדרוג Apigee Hybrid

ao.image.pullPolicy Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-operator, apigee-ingress-manager

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

ao.image.tag Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-operator, apigee-ingress-manager

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

ao.image.url Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, apigee-ingress-manager

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

ao.resources.limits.cpu Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 250m

תרשים: apigee-operator, apigee-ingress-manager

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

ao.resources.limits.memory Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 256Mi

תרשים: apigee-operator, apigee-ingress-manager

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

ao.resources.requests.cpu Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 250m

תרשים: apigee-operator, apigee-ingress-manager

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

ao.resources.requests.memory Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 256Mi

תרשים: apigee-operator, apigee-ingress-manager

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

ao.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

ao.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ao.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ao.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ao.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway

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

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

החלת שינויים על apigeeIngressGateway נכסים באמצעות התרשים apigee-org.

בטבלה הבאה מתוארים המאפיינים של האובייקט apigeeIngressGateway:

מאפיין (property) סוג תיאור
apigeeIngressGateway.image.pullPolicy Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

apigeeIngressGateway.image.tag Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

apigeeIngressGateway.image.url Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

apigeeIngressGateway.nodeSelector.key Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

חובה

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

הגדרת מאגרי צמתים ייעודיים

apigeeIngressGateway.nodeSelector.value Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

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

ראו nodeSelector.

apigeeIngressGateway.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המינימלי של Pods של שער כניסה של Apigee שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לשער ספציפי, משתמשים ב-ingressGateways[].podDisruptionBudget.minAvailable.

לדוגמה, ב-overrides.yaml:

apigeeIngressGateway:
  podDisruptionBudget:
    minAvailable: "50%"
apigeeIngressGateway.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המקסימלי של Pods של שער כניסה של Apigee שלא יכולים להיות זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לשער ספציפי, משתמשים ב-ingressGateways[].podDisruptionBudget.maxUnavailable.

לדוגמה, ב-overrides.yaml:

apigeeIngressGateway:
  podDisruptionBudget:
    maxUnavailable: 1
apigeeIngressGateway.proxyProtocol.mode Advanced

נוסף בגרסה: 1.16.6

ערך ברירת המחדל: disable

תרשים: apigee-org

ההגדרה הזו קובעת את ברירת המחדל הגלובלית לניתוח פרוטוקול HAProxy PROXY בכל רכיבי שער הכניסה. הערכים המותרים הם strict,‏ permissive או disable.

אפשר לשנות את ברירת המחדל הגלובלית הזו לכל שער בנפרד באמצעות ingressGateways[].proxyProtocol.mode.

apigeeIngressGateway.replicaCountMax בסיסי נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 4

תרשים: apigee-org

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

apigeeIngressGateway.replicaCountMin בסיסי נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 2

תרשים: apigee-org

המספר המינימלי של Pods לשער הכניסה שזמינים להתאמה אוטומטית לעומס.

apigeeIngressGateway.targetCPUUtilizationPercentage Advanced הושקה בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1

ערך ברירת המחדל: 75

תרשים: apigee-org

סף השימוש במעבד (CPU) לשינוי מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים.

כשהשימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר ה-pods ב-ReplicaSet, עד ל-apigeeIngressGateway.replicaCountMax.

למידע נוסף על התאמה לעומס ב-Kubernetes, קראו את המאמר התאמה אופקית של קבוצות Pod לעומס במסמכי התיעוד של Kubernetes.

apigeeIngressGateway.tolerations.effect Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

apigeeIngressGateway.tolerations.key Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway.tolerations.operator Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway.tolerations.value Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של שער Ingress. אפשר גם לשנות את ההגדרה הזו לשער ספציפי באמצעות ingressGateways[].topologySpreadConstraints.disableHostnameConstraint.

topologySpreadConstraints

apigeeIngressGateway.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של שער הכניסה. אפשר גם לשנות את ההגדרה הזו לשער ספציפי באמצעות ingressGateways[].topologySpreadConstraints.disableZoneConstraint.

topologySpreadConstraints

apigeeIngressGateway.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של שער כניסה. אפשר גם לשנות את ההגדרה הזו לשער ספציפי באמצעות ingressGateways[].topologySpreadConstraints.enabled.

topologySpreadConstraints

apigeeIngressGateway.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי זמינות של פודים של שער כניסה. אפשר גם לשנות את ההגדרה הזו לשער ספציפי באמצעות ingressGateways[].topologySpreadConstraints.zoneKey.

topologySpreadConstraints

apigeeIngressGateway.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ פריסת הטופולוגיה של האזור בפודים של שער הכניסה. אפשר גם לשנות את ההגדרה הזו לשער ספציפי באמצעות ingressGateways[].topologySpreadConstraints.zoneRequiredForScheduling.

topologySpreadConstraints

cassandra

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

מידע נוסף זמין במאמר הגדרת StorageClass.

בטבלה הבאה מתוארים המאפיינים של האובייקט cassandra:

מאפיין (property) סוג תיאור
cassandra.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

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

cassandra.auth.admin.password בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

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

cassandra.auth.ddl.password בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

הסיסמה של המשתמש בשפת הגדרת הנתונים (DDL) של Cassandra. משמש את MART לכל אחת ממשימות הגדרת הנתונים, כמו יצירה, עדכון ומחיקה של מרחב מפתחות.

cassandra.auth.default.password בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

הסיסמה של משתמש ברירת המחדל של Cassandra שנוצר כשהאימות מופעל. צריך לאפס את הסיסמה הזו כשמגדירים אימות של Cassandra. מידע נוסף זמין במאמר הגדרת TLS ל-Cassandra.

cassandra.auth.dml.password בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

הסיסמה של המשתמש בשפת הטיפול בנתונים (DML) של Cassandra. משתמש ה-DML משמש את התקשורת של הלקוח כדי לקרוא נתונים מ-Cassandra ולכתוב אליה נתונים.

cassandra.auth.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-datastore, apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

cassandra.auth.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-datastore, apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.auth.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

cassandra.auth.jmx.password בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

הסיסמה של המשתמש בפעולות Cassandra JMX. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.

cassandra.auth.jmx.username בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: jmxuser

תרשים: apigee-datastore

חובה

שם המשתמש של המשתמש בפעולות Cassandra JMX. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.

cassandra.auth.jolokia.password בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-datastore

חובה

הסיסמה של המשתמש בפעולות Cassandra Jolokia JMX. משמש לאימות ולתקשורת עם Cassandra JMX API.

cassandra.auth.jolokia.username בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: apigee

תרשים: apigee-datastore

חובה

שם המשתמש של המשתמש בפעולות Cassandra Jolokia JMX. משמש לאימות ולתקשורת עם Cassandra JMX API.

cassandra.auth.secret בסיסי נוספה בגרסה: 1.3.3

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד.

מידע נוסף:

cassandra.auth.secretProviderClass Advanced נוספה בגרסה: 1.10.3

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-operator

מדיניות האחסון של הסודות של Cassandra. אם מגדירים את השדה, הוא צריך להתאים ל-SecretProviderClass שמפנה לספק הסודות החיצוני, כמו Hashicorp Vault. אם לא מגדירים את המאפיין, Apigee Hybrid משתמש בשמות המשתמשים ובסיסמאות שמאוחסנים באחד מהמקומות הבאים:

או הסוד של Kubernetes שמאוחסן ב:

במאמר אחסון סודות של Cassandra ב-Hashicorp Vault מוסבר איך ליצור את המדיניות.

cassandra.backup.cloudProvider Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: GCP

תרשים: apigee-datastore

השם של ספק הגיבוי. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך:

  • ‫GCP כדי לאחסן ארכיוני גיבוי ב-Google Cloud Storage.
  • ‫HYBRID כדי לאחסן ארכיוני גיבוי בשרת SSH מרוחק.
  • CSI (מומלץ) כדי להשתמש ב-Volume Snapshots של Kubernetes CSI לגיבוי. למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, קראו את המאמר גיבוי ושחזור של CSI.
cassandra.backup.dbStorageBucket Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP.

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

cassandra.backup.enabled Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: false

תרשים: apigee-datastore

גיבוי הנתונים לא מופעל כברירת מחדל. כדי להפעיל, צריך להגדיר את הערך true.

גיבוי ושחזור של Cassandra

cassandra.backup.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-cassandra Google IAM‏ (GSA) שצריך לשייך לחשבון השירות של Cassandra backup Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.backup.enabled לערך true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

איך מפעילים את איחוד שירותי אימות הזהות של עומסי עבודה ב-GKE

cassandra.backup.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-datastore

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

cassandra.backup.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-datastore

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.backup.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

cassandra.backup.keyfile Advanced נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID.

הנתיב במערכת הקבצים המקומית לקובץ של מפתח ה-SSH הפרטי.

cassandra.backup.schedule Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 0 2 * * *

תרשים: apigee-datastore

לוח הזמנים של משימת ה-cron לגיבוי.

גיבוי ושחזור של Cassandra

cassandra.backup.server Advanced נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID.

כתובת ה-IP של שרת הגיבוי המרוחק של SSH.

cassandra.backup.serviceAccountPath Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

הנתיב לקובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים ב-Cloud Storage‏ (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להעלאת ארכיוני גיבוי ל-cassandra.backup.dbStorageBucket שצוין.

אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage לצורך העלאת ארכיוני גיבוי:

cassandra.backup.serviceAccountRef Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים באחסון (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להעלאת ארכיוני גיבוי ל-cassandra.backup.dbStorageBucket שצוין.

אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage לצורך העלאת ארכיוני גיבוי:

cassandra.backup.storageDirectory Advanced נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID.

יכול להיות נתיב מוחלט או נתיב יחסי לספריית הבית של המשתמש ב-apigee.

השם של ספריית הגיבוי בשרת ה-SSH לגיבוי.

cassandra.clusterName בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: apigeecluster

תרשים: apigee-datastore

מציין את השם של אשכול Cassandra.

cassandra.datacenter בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: dc-1

תרשים: apigee-datastore

מציין את מרכז הנתונים של צומת Cassandra.

cassandra.dnsPolicy בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

כשמגדירים את hostNetwork כ-true, מדיניות ה-DNS מוגדרת כ-ClusterFirstWithHostNet.

cassandra.externalSeedHost בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

שם המארח או כתובת ה-IP של צומת באשכול Cassandra. אם לא מגדירים את המדיניות, המערכת משתמשת בשירות המקומי של Kubernetes.

cassandra.heapNewSize בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 100M

תרשים: apigee-datastore

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

cassandra.hostNetwork בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: false

תרשים: apigee-datastore

הפעלת התכונה hostNetwork של Kubernetes. ‫Apigee משתמשת בתכונה הזו בהתקנות במספר אזורים כדי לתקשר בין Pods אם למרחב השמות של רשת ה-Pod אין קישוריות בין אשכולות (האשכולות פועלים ב-"island network mode"), שזה המצב שמוגדר כברירת מחדל בהתקנות שהן לא GKE, כולל Google Distributed Cloud ב-VMware או ב-bare metal, ב-AKS, ב-EKS וב-OpenShift.

מגדירים את cassandra.hostNetwork לערך false בהתקנות באזור יחיד ובהתקנות במספר אזורים עם קישוריות בין Pods באשכולות שונים, למשל התקנות של GKE.

מגדירים את cassandra.hostNetwork לערך true בהתקנות במספר אזורים שאין בהן תקשורת בין pod-ים באשכולות שונים, למשל התקנות של Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. פריסה בכמה אזורים: דרישות מוקדמות

כשמגדירים את true, מדיניות ה-DNS מוגדרת אוטומטית ל-ClusterFirstWithHostNet.

cassandra.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-datastore

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

cassandra.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-datastore

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

cassandra.maxHeapSize Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 512M

תרשים: apigee-datastore

הגבול העליון של זיכרון המערכת של JVM שזמין לפעולות של Cassandra, במגה-בייט.

cassandra.multiRegionSeedHost בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

כתובת ה-IP של אשכול Cassandra קיים שמשמש להרחבת האשכול הקיים לאזור חדש. הגדרת מארח ה-seed במספר אזורים

cassandra.nodeSelector.key Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה

מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי נתונים של cassandra.

הגדרת מאגרי צמתים ייעודיים

cassandra.nodeSelector.value Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

ערך אופציונלי של תווית לבחירת צומת, שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי הנתונים של cassandra, ולעקיפת ההגדרות של nodeSelector.apigeeData.

ראו nodeSelector.

cassandra.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

המספר המינימלי של פודים של Cassandra שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

cassandra:
  podDisruptionBudget:
    minAvailable: "50%"
cassandra.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

המספר המקסימלי של פודים של Cassandra שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

cassandra:
  podDisruptionBudget:
    maxUnavailable: 1
cassandra.port Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 9042

תרשים: apigee-datastore

מספר היציאה שמשמשת לחיבור ל-Cassandra.

cassandra.properties.externalEndpointsSync.intervalSeconds Advanced נוסף בגרסה: 1.17.1

ערך ברירת המחדל: 30

תרשים: apigee-datastore

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

רלוונטי רק כשמוגדרת המדיניות cassandra.properties.externalEndpointsSync. אפשר לעיין במאפיין הזה כדי לראות איך פועל הסנכרון הדינמי של נקודות הקצה.

cassandra.properties.externalEndpointsSync.namespace Advanced נוסף בגרסה: 1.17.1

ערך ברירת המחדל: apigee

תרשים: apigee-datastore

מרחב השמות באשכול המרוחק שמכיל את השירות ללא ממשק משתמש של Cassandra ואת נקודות הקצה שלו.

רלוונטי רק כשמוגדרת המדיניות cassandra.properties.externalEndpointsSync.

cassandra.properties.externalEndpointsSync.secretRef Advanced נוסף בגרסה: 1.17.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

ההגדרה cassandra.properties.externalEndpointsSync מפעילה סנכרון דינמי של נקודות קצה למאגר נתונים חיצוני. ‫cassandra.properties.externalHost נדרש: ה-validating webhook מאפשר את replicaCount: 0 רק כשמוגדר externalHost, והאופרטור משתמש בכתובות האלה כנקודות הקצה הראשוניות אם הוא לא יכול לקרוא את נקודות הקצה המרוחקות לפני הסנכרון המוצלח הראשון שלו. כשהסנכרון הדינמי מופעל, המפעיל קורא באופן רציף את נקודות הקצה הפעילות והמוכנות של Cassandra מהאשכול המרוחק ומשקף אותן באשכול המקומי, כך שזמן הריצה ממשיך לעקוב אחרי אשכול Cassandra המרוחק כשהוא גדל או קטן. אם לא מגדירים את externalEndpointsSync, מאגר הנתונים משתמש בכתובות הסטטיות מ-cassandra.properties.externalHost ללא שינוי.

‫secretRef הוא השם של Kubernetes Secret במרחב השמות של מאגר הנתונים שמכיל מפתח kubeconfig שמעניק הרשאת קריאה בלבד ל-API של האשכול המרוחק. האופרטור משתמש בפרטי הכניסה האלה כדי לקרוא את נקודות הקצה המרוחקות. אם cassandra.properties.externalEndpointsSync מוגדר אבל secretRef ריק, כל קריאה מרחוק נכשלת, וההתנהגות של המשך פעילות במקרה שגיאה שמתוארת בהמשך חלה.

התנהגות של המשך פעילות במקרה שגיאה: אם האופרטור לא יכול לקרוא את נקודות הקצה המרוחקות (לדוגמה, אם אי אפשר להגיע לשרת ה-API המרוחק או שפג התוקף של פרטי הכניסה), הוא שומר את נקודות הקצה התקינות האחרונות שידועות במקום להסיר אותן, ולעולם לא כותב רשימה ריקה של נקודות קצה. כך נשמרת הקישוריות הקיימת, אבל זה גם אומר שכשל מתמשך נשאר מוסתר עד לשינוי הבא בטופולוגיה של Cassandra המרוחקת.

התראה מומלצת: מכיוון שהמשך פעילות במקרה שגיאה מסתיר כשל מתמשך, כדאי להגדיר התראה על תנאי הסטטוס EndpointSyncDegraded של המשאב ApigeeDatastore. האופרטור מגדיר את הערך True אחרי שלוש קריאות כושלות ברצף, עם הסיבה RemoteReadFailed או NoReadyRemoteEndpoints, ומגדיר את הערך False אחרי קריאה מוצלחת. האופרטור מאחסן את התנאי בסטטוס המשאב, כך שהוא נשאר מוגדר כשהאופרטור מופעל מחדש.

האופרטור גם מייצא שני מדדים בנקודת הקצה של המדדים שלו, שמסומנים בתווית עם namespace ו-name של ApigeeDatastore:

  • external_endpoint_sync_last_success_timestamp: זמן יוניקס, בשניות, של הקריאה האחרונה שהצליחה.
  • ‫external_endpoint_sync_failures_total: מספר פעולות הקריאה שנכשלו.

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

cassandra.properties.externalEndpointsSync.serviceName Advanced נוסף בגרסה: 1.17.1

ערך ברירת המחדל: apigee-cassandra-default

תרשים: apigee-datastore

שם השירות המרוחק ללא ממשק משתמש של Cassandra, שנקודות הקצה שלו נקראות על ידי המפעיל ומשוכפלות לאשכול המקומי.

רלוונטי רק כשמוגדרת המדיניות cassandra.properties.externalEndpointsSync.

cassandra.properties.externalHost בסיסי נוסף בגרסה: 1.17.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

כשהוא מוגדר, מאגר הנתונים הזה מסומן כחיצוני: אשכול Cassandra פועל מחוץ לאשכול Kubernetes הזה. הערך הוא רשימה מופרדת בפסיקים של כתובות IP מרוחקות של Cassandra (לדוגמה, 10.0.0.1,10.0.0.2). האופרטור מקבל רק כתובות IP. הוא מתעלם משמות מארחים ומשמות DNS, וכותב אזהרה ביומן שלו לכל רשומה שהמערכת התעלמה ממנה. לכתובת יכולה להיות סיומת :PORT, אבל האופרטור מתעלם מהיציאה ומשתמש תמיד ביציאה 9042.

כשהשדה externalHost לא ריק, האופרטור פועל במצב של מאגר נתונים חיצוני ולא יוצר StatefulSet או PersistentVolumes מקומיים של Cassandra, ולכן אפשר להגדיר את cassandra.replicaCount כ-0. אם משאירים את externalHost ריק, התנהגות ברירת המחדל של Cassandra באשכול לא משתנה.

למעקב דינמי אחרי נקודות הקצה של האשכול המרוחק בזמן שהוא משתנה, אפשר לעיין במאמר cassandra.properties.externalEndpointsSync. אל תתבלבלו בין externalHost לבין cassandra.externalSeedHost או cassandra.multiRegionSeedHost, שמגדירים את ההפצה של טבעת Cassandra במספר אזורים, שהוא מנגנון אחר.

cassandra.rack בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ra-1

תרשים: apigee-datastore

מציין את המדף של צומת Cassandra.

cassandra.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-datastore

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

cassandra.readinessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 0

תרשים: apigee-datastore

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

cassandra.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 10

תרשים: apigee-datastore

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

cassandra.readinessProbe.successThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-datastore

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

cassandra.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-datastore

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

cassandra.replicaCount בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-datastore

‫Cassandra הוא מסד נתונים משוכפל. המאפיין הזה מציין את מספר הצמתים של Cassandra שמועסקים כ-StatefulSet.

cassandra.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 500m

תרשים: apigee-datastore

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

cassandra.resources.requests.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-datastore

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

cassandra.restore.cloudProvider Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: GCP

תרשים: apigee-datastore

השם של ספק השחזור. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך:

  • ‫GCP כדי לשחזר נתונים מגיבוי שמאוחסן ב-Google Cloud Storage.
  • ‫HYBRID כדי לשחזר נתונים מגיבוי שמאוחסן בשרת SSH מרוחק.
  • CSI (מומלץ) כדי להשתמש ב-Volume Snapshots של Kubernetes CSI לשחזור. למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, קראו את המאמר גיבוי ושחזור של CSI.
cassandra.restore.dbStorageBucket Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם השחזור מופעל והערך של cassandra.restore.cloudProvider הוא GCP.

השם של קטגוריה ב-Google Cloud Storage שבה מאוחסנים קובצי הגיבוי שמשמשים לשחזור הנתונים.

cassandra.restore.enabled Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: false

תרשים: apigee-datastore, apigee-org

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

גיבוי ושחזור של Cassandra

cassandra.restore.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-cassandra Google IAM‏ (GSA) שצריך לשייך לחשבון השירות של Cassandra restore Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.restore.enabled לערך true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-cassandra@my-hybrid-project.iam.gserviceaccount.com

הפעלת Workload Identity Federation ב-GKE

cassandra.restore.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-datastore

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

cassandra.restore.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-datastore

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.restore.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

cassandra.restore.serviceAccountPath Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

הנתיב לקובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים ב-Cloud Storage‏ (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין.

אם השחזור מופעל והמאפיין cassandra.restore.cloudProvider מוגדר לערך GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להוריד את קובצי הארכיון של הגיבוי לשחזור:

cassandra.restore.serviceAccountRef Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים באחסון (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין.

אם השחזור מופעל והמאפיין cassandra.restore.cloudProvider מוגדר לערך GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להוריד את קובצי הארכיון של הגיבוי לשחזור:

cassandra.restore.snapshotTimestamp Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

חובה אם השחזור מופעל.

חותמת הזמן של הגיבוי שצריך לשחזר.

cassandra.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

cassandra.storage.capacity בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 10Gi

תרשים: apigee-datastore

חובה אם צוין storage.storageclass

מציינת את גודל הדיסק הנדרש, במגה-בייט (Mi) או בגיגה-בייט (Gi).

cassandra.storage.storageclass בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

מציין את סוג האחסון המקומי שבו משתמשים.

cassandra.storage.storageSize בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 10Gi

תרשים: apigee-datastore

חובה אם צוין storage.storageclass

מציינת את גודל הדיסק הנדרש, במגה-בייט (Mi) או בגיגה-בייט (Gi).

cassandra.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 300

תרשים: apigee-datastore

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

cassandra.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

cassandra.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

cassandra.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-datastore

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

cassandra.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

cassandra.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-datastore

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

certManager

‫Apigee משתמש ב-cert-manager לאימות אישורים.

בטבלה הבאה מתוארים המאפיינים של האובייקט certManager:

מאפיין (property) סוג תיאור
certManager.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

certManager.namespace Advanced נוספה בגרסה: 1.9.0

ערך ברירת המחדל: cert-manager

תרשים: apigee-operator

מרחב השמות של cert-manager.

הפעלת cert-manager במרחב שמות בהתאמה אישית

connectAgent

‫Apigee Connect מאפשר למישור הניהול של Apigee hybrid להתחבר בצורה מאובטחת לשירות MART במישור זמן הריצה, בלי לחשוף את נקודת הקצה של MART באינטרנט.

בטבלה הבאה מתוארים המאפיינים של האובייקט connectAgent:

מאפיין (property) סוג תיאור
connectAgent.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

connectAgent.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

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

connectAgent.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM‏ (GSA) ש-connectAgent ישייך לחשבון השירות התואם של Kubernetes, כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

connectAgent.logLevel Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: INFO

תרשים: apigee-org

רמת הדיווח ביומן. הערכים יכולים להיות:

  • ‫INFO: הודעות מידע בנוסף להודעות אזהרה, שגיאה וקריסה. האפשרות הזו שימושית בעיקר לניפוי באגים.
  • ‫WARNING: אזהרות לא קריטיות בנוסף להודעות שגיאה והודעות קריטיות.
  • ‫ERROR: שגיאות פנימיות ושגיאות שלא מוחזרות למשתמש, בנוסף להודעות על שגיאות חמורות.
  • ‫FATAL: שגיאות שבעקבותיהן אי אפשר לשחזר ואירועים שגורמים לקריסה של Apigee Connect.
connectAgent.image.pullPolicy Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

connectAgent.image.tag Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

connectAgent.image.url Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

connectAgent.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

מספר הפודים המינימלי של סוכן החיבורים ב-Apigee שצריכים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

connectAgent:
  podDisruptionBudget:
    minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המקסימלי של Pods של סוכני חיבורים ב-Apigee שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

connectAgent:
  podDisruptionBudget:
    maxUnavailable: 1
connectAgent.replicaCountMax בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 5

תרשים: apigee-org

המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

connectAgent.replicaCountMin בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 1

תרשים: apigee-org

המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

בסביבת הייצור, יכול להיות שתרצו להגדיל את הערך של replicaCountMin ל-1, כדי שיהיו יותר חיבורים למישור הבקרה לצורך אמינות וסקלביליות.

connectAgent.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 512m

תרשים: apigee-org

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

connectAgent.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-org

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

connectAgent.resources.requests.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 100m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

connectAgent.resources.requests.memory Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 30Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

connectAgent.server Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: apigeeconnect.googleapis.com:443

תרשים: apigee-org

המיקום של השרת והיציאה של השירות הזה.

connectAgent.serviceAccountPath בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את serviceAccountPath או את serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google, עבור חשבון השירות apigee-mart.

ברוב ההתקנות, הערך של connectAgent.serviceAccountPath צריך להיות זהה לערך של mart.serviceAccountPath.

connectAgent.serviceAccountRef בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את serviceAccountPath או את serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

ברוב ההתקנות, הערך של connectAgent.serviceAccountRef צריך להיות זהה לערך של mart.serviceAccountRef.

connectAgent.targetCPUUtilizationPercentage Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 75

תרשים: apigee-org

ניצול יעד של המעבד (CPU) לסוכן Apigee Connect ב-pod. הערך של השדה הזה מאפשר ל-Apigee Connect לבצע התאמה אוטומטית לעומס כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.

connectAgent.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 600

תרשים: apigee-org

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

connectAgent.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

connectAgent.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

connectAgent.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

connectAgent.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

connectAgent.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

connectAgent.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של connectAgent.

topologySpreadConstraints

connectAgent.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של connectAgent.

topologySpreadConstraints

connectAgent.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של connectAgent.

topologySpreadConstraints

connectAgent.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של connectAgent.

topologySpreadConstraints

connectAgent.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפריסה של טופולוגיית האזור בפודים של connectAgent.

topologySpreadConstraints

defaults

מפתחות ההצפנה שמוגדרים כברירת מחדל להתקנה של Apigee Hybrid.

בטבלה הבאה מתוארים המאפיינים של האובייקט defaults:

מאפיין (property) סוג תיאור
defaults.org.kmsEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw==

תרשים: apigee-org, apigee-env

מפתח הצפנה שמוגדר כברירת מחדל לארגון ב-KMS.

defaults.org.kvmEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw==

תרשים: apigee-org, apigee-env

מפתח ההצפנה שמוגדר כברירת מחדל לארגון ב-KVM.

defaults.env.kmsEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw==

תרשים: apigee-env

מפתח ההצפנה שמוגדר כברירת מחדל לסביבה (env) ב-KMS.

defaults.env.kvmEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw==

תרשים: apigee-env

מפתח ההצפנה שמוגדר כברירת מחדל לסביבה (env) ב-KVM.

defaults.env.cacheEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw==

תרשים: apigee-env

מפתח הצפנה שמוגדר כברירת מחדל למטמון של הסביבה (env).

envs

מגדיר מערך של סביבות שאפשר לפרוס בהן את שרתי ה-proxy ל-API. כל סביבה מספקת הקשר מבודד או ארגז חול (sandbox) להרצת שרתי proxy ל-API.

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

מידע נוסף זמין במאמר מידע על סביבות.

בטבלה הבאה מתוארים המאפיינים של האובייקט envs:

מאפיין (property) סוג תיאור
envs[].cacheEncryptionKey בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret.

מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים

envs[].cacheEncryptionPath בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret.

הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים

envs[].cacheEncryptionSecret.key בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret.

המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

envs[].cacheEncryptionSecret.name בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך לציין אחד מהערכים הבאים: cacheEncryptionKey,‏ cacheEncryptionPath או cacheEncryptionSecret.

השם של סוד של Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים

envs[].components.runtime.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

משנים את הערך של runtime.podDisruptionBudget.minAvailable כדי להגדיר את המספר המינימלי של פודים של זמן ריצה בסביבה הזו שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-runtime.podDisruptionBudget.minAvailable או ב-runtime.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

envs:
  - name: test
    components:
      runtime:
        podDisruptionBudget:
          minAvailable: "50%"
envs[].components.runtime.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

אפשר לשנות את הערך של runtime.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של פודים של סביבת זמן ריצה בסביבה הזו שלא יהיו זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-runtime.podDisruptionBudget.minAvailable או ב-runtime.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

envs:
  - name: test
    components:
      runtime:
        podDisruptionBudget:
          maxUnavailable: 1
envs[].components.runtime.replicaCountMax בסיסי נוספה בגרסה: 1.9.3

ערך ברירת המחדל: 4

תרשים: apigee-env

מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות runtime.replicaCountMax.

envs[].components.runtime.replicaCountMin בסיסי נוספה בגרסה: 1.9.3

ערך ברירת המחדל: 1

תרשים: apigee-env

המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות runtime.replicaCountMin.

envs[].components.runtime.resources.limits.memory Advanced נוספה בגרסה: 1.15.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi).

envs[].components.runtime.resources.requests.memory Advanced נוספה בגרסה: 1.15.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi).

envs[].components.runtime.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של runtime.topologySpreadConstraints.disableHostnameConstraint ושל topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint. כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של runtime בסביבה הזו.

topologySpreadConstraints

envs[].components.runtime.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של runtime.topologySpreadConstraints.disableZoneConstraint ושל topologySpreadConstraints.apigeeRuntime.disableZoneConstraint. כשהערך מוגדר כ-true, המערכת משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של runtime בסביבה הזו.

topologySpreadConstraints

envs[].components.runtime.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של runtime.topologySpreadConstraints.enabled ושל topologySpreadConstraints.enabled. הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של runtime בסביבה הזו.

בדוגמה הבאה, ההגדרה הזו מופעלת ב-overrides.yaml:

envs:
  - name: test
    components:
      runtime:
        topologySpreadConstraints:
          enabled: true

topologySpreadConstraints

envs[].components.runtime.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-env

שינוי אופציונלי של runtime.topologySpreadConstraints.zoneKey ושל topologySpreadConstraints.apigeeRuntime.zoneKey. מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של runtime בסביבה הזו.

topologySpreadConstraints

envs[].components.runtime.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של runtime.topologySpreadConstraints.zoneRequiredForScheduling ושל topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling. כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת הטופולוגיה של האזור בפודים של runtime בסביבה הזו.

topologySpreadConstraints

envs[].components.synchronizer.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

משנים את הערך של synchronizer.podDisruptionBudget.minAvailable כדי להגדיר את המספר המינימלי של pod של סנכרון בסביבה הזו שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-synchronizer.podDisruptionBudget.minAvailable או ב-synchronizer.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        podDisruptionBudget:
          minAvailable: "50%"
envs[].components.synchronizer.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

אפשר לשנות את הערך של synchronizer.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של pod לסנכרון בסביבה הזו, שלא יהיו זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-synchronizer.podDisruptionBudget.minAvailable או ב-synchronizer.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        podDisruptionBudget:
          maxUnavailable: 1
envs[].components.synchronizer.pollInterval Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-env

משנים את הערך של synchronizer.pollInterval כדי להגדיר את מספר השניות שהסנכרון ממתין בין פעולות הסקר בסביבה הזו. אם מגדירים ערך קטן מ-60, המערכת משתמשת ב-60.

אם לא מגדירים את המאפיין הזה, הסביבה משתמשת ב-envs[].pollInterval. אם לא מגדירים אף אחד מהמאפיינים, הסביבה הזו משתמשת ב-synchronizer.pollInterval, שמוגדר כברירת מחדל ל-60.

לדוגמה, ב-overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        pollInterval: 120
envs[].components.synchronizer.replicaCountMax בסיסי נוספה בגרסה: 1.9.3

ערך ברירת המחדל: 4

תרשים: apigee-env

מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות synchronizer.replicaCountMax.

envs[].components.synchronizer.replicaCountMin בסיסי נוספה בגרסה: 1.9.3

ערך ברירת המחדל: 1

תרשים: apigee-env

המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות synchronizer.replicaCountMin.

envs[].components.synchronizer.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של synchronizer.topologySpreadConstraints.disableHostnameConstraint ושל topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint. כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של synchronizer בסביבה הזו.

topologySpreadConstraints

envs[].components.synchronizer.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של synchronizer.topologySpreadConstraints.disableZoneConstraint ושל topologySpreadConstraints.apigeeRuntime.disableZoneConstraint. כשהערך מוגדר כ-true, המערכת משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של synchronizer בסביבה הזו.

topologySpreadConstraints

envs[].components.synchronizer.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של synchronizer.topologySpreadConstraints.enabled ושל topologySpreadConstraints.enabled. הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של synchronizer בסביבה הזו.

בדוגמה הבאה, ההגדרה הזו מופעלת ב-overrides.yaml:

envs:
  - name: test
    components:
      synchronizer:
        topologySpreadConstraints:
          enabled: true

topologySpreadConstraints

envs[].components.synchronizer.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-env

שינוי אופציונלי של synchronizer.topologySpreadConstraints.zoneKey ושל topologySpreadConstraints.apigeeRuntime.zoneKey. מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של פודים של synchronizer בסביבה הזו.

topologySpreadConstraints

envs[].components.synchronizer.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של synchronizer.topologySpreadConstraints.zoneRequiredForScheduling ושל topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling. כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת הטופולוגיה של האזור ב-Pod של synchronizer בסביבה הזו.

topologySpreadConstraints

envs[].gsa.runtime Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM בסביבת זמן הריצה, שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm.

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

envs[].gsa.synchronizer Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM לסנכרון, שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm.

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

envs[].httpProxy.host בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מציינת את שם המארח או את כתובת ה-IP שבהם פועל שרת ה-Proxy ל-HTTP.

מפרטים httpProxy מאפיינים בסדר הבא: scheme, host, port. לדוגמה:

envs:
  - name: test
    httpProxy:
      scheme: HTTP
      host: 10.12.0.47
      port: 3128
      ...

ראו גם: הגדרת העברת proxy לשרתי proxy ל-API.

envs[].httpProxy.port בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מציינת את היציאה שבה פועל ה-Proxy ל-HTTP. אם המאפיין הזה מושמט, כברירת מחדל נעשה שימוש ביציאה 80 ל-HTTP וביציאה 443 ל-HTTPS.

envs[].httpProxy.scheme בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: HTTPS

תרשים: apigee-env

מציינת את סוג ה-Proxy ל-HTTP, כלומר HTTP או HTTPS. כברירת מחדל, המערכת משתמשת ב-HTTPS.

envs[].httpProxy.username בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.

envs[].httpProxy.password בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.

envs[].managementCallsSkipProxy Advanced הושק בגרסה: 1.15.1

ערך ברירת המחדל: false

תרשים: apigee-env

אם מגדירים את הערך true לשרת proxy להעברה ברמת הסביבה, המעקב והניתוח (שמשתמשים ב-googleapis.com) והשיחות היוצאות שבוצעו על ידי המדיניות של Model Armor ושל המטמון הסמנטי (SanitizeUserPrompt,‏ SanitizeModelResponse,‏ SemanticCacheLookup ו-SemanticCachePopulate) ידלגו על שרת ה-proxy להעברה. יעדים בשרת ה-proxy (כולל googleapis.com) עדיין ינותבו דרך שרת ה-proxy להעברה. אי אפשר להשתמש בהגדרה הזו ביחד עם useForRuntimeManagement.

envs[].name בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

חובה

שם הסביבה ב-Apigee שצריך לסנכרן.

envs[].pollInterval Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מרווח הזמן שמשמש לדגימת שינויים בסנכרון של הארגון והסביבה, בשניות.

envs[].port Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מספר יציאת TCP לתנועת HTTPS.

envs[].securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

envs[].serviceAccountPaths.runtime בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד סוכן Cloud Trace, בדרך כלל חשבון השירות apigee-runtime. במאמר מידע על חשבונות שירות מפורטים שמות ברירת המחדל של חשבונות השירות והתפקידים שהוקצו להם.

envs[].serviceAccountPaths.synchronizer בסיסי נוספה בגרסה: 1.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד מנהל Apigee Synchronizer.

envs[].serviceAccountSecretProviderClass Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

השם של מחלקת ספק הסודות הספציפית לסביבה (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault.

אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault

envs[].serviceAccountSecretRefs.runtime בסיסי נוספה בגרסה: 1.4.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google, עם התפקיד סוכן Cloud Trace כקלט.

envs[].serviceAccountSecretRefs.synchronizer בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google, עם התפקיד מנהל סנכרון של Apigee כקלט.

gcp

מזהה את הפרויקט ב-Google Cloud (חובה בכל ההתקנות ההיברידיות), את ההגדרות של Workload Identity ושל איחוד שירותי אימות הזהות של עומסי עבודה, ואת האזור שאליו apigee-logger ו-apigee-metrics דוחפים את הנתונים שלהם.

בטבלה הבאה מתוארים המאפיינים של האובייקט gcp:

מאפיין (property) סוג תיאור
gcp.federatedWorkloadIdentity.audience בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

הקהל המורשה של ספק מאגרי הזהויות של עומסי העבודה בפלטפורמות שהן לא GKE. בשימוש כש-gcp.federatedWorkloadIdentity.type הוא kubernetes.

הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.credentialSourceFile בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

שם הקובץ והנתיב לקובץ המקור של פרטי הכניסה שמשמש את איחוד שירותי אימות הזהות של עומסי עבודה כדי לקבל את פרטי הכניסה לחשבונות השירות. זה הערך שצריך לספק ל-credential-source-file כשמגדירים את איחוד שירותי אימות הזהות של עומסי עבודה באמצעות הפקודה create-cred-config. בשימוש כש-gcp.federatedWorkloadIdentity.type הוא kubernetes.

הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.enabled בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: false

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

מאפשר איחוד זהויות של עומסי עבודה בפלטפורמות שאינן GKE. אסור להגדיר את true אם gcp.workloadIdentity.enabled מוגדר ל-true באותו אשכול.

הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.annotations Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

מפה של הערות שצריך להחיל על פודים היברידיים כש-gcp.federatedWorkloadIdentity.type הוא sidecar. אפשר להוסיף להן או לשנות אותן באמצעות הערות ברמת הרכיב, כמו runtime.annotations.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.container Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

מפה של מפרט קונטיינר של Kubernetes לקונטיינר המשני (sidecar), כמו image,‏ imagePullPolicy,‏ name וכו'. מידע נוסף זמין במסמכי התיעוד של קונטיינר Kubernetes. כאן צריך לציין את קובץ האימג' של הקונטיינר בהתאמה אישית. חובה כש-gcp.federatedWorkloadIdentity.type הוא sidecar.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.container.env Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

רשימה של משתני סביבה שצריך להגדיר לקונטיינר המשני (sidecar). מידע נוסף זמין במסמכי התיעוד של קונטיינר Kubernetes.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.container.startupProbe Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

מגדיר בדיקת הפעלה של Kubernetes לקונטיינר המשני (sidecar). מידע נוסף זמין במסמכי התיעוד של קונטיינר Kubernetes.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.container.volumeMounts Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

רשימה של נקודות טעינה נוספות של Kubernetes לקונטיינר המשני (sidecar) ב-Pod היברידי, כש-gcp.federatedWorkloadIdentity.type הוא sidecar.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.sidecarSpec.volumes Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

רשימה של אמצעי אחסון נוספים של Kubernetes שצריך לטעון לפודים היברידיים כש-gcp.federatedWorkloadIdentity.type הוא sidecar.

איך משתמשים באימות Sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.tokenExpiration בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 3600

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

משך החיים של האסימון בשניות. בשימוש כש-gcp.federatedWorkloadIdentity.type הוא kubernetes.

הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS

gcp.federatedWorkloadIdentity.type Advanced נוסף בגרסה: 1.16.2

ערך ברירת המחדל: kubernetes

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

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

gcp.projectID בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, apigee-telemetry, apigee-org

חובה

מזהה את הפרויקט ב-Google Cloud שאליו apigee-logger ו-apigee-metrics מעבירים את הנתונים שלהם.

gcp.region בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: us-central1

תרשים: apigee-env, apigee-org

חובה

האזור ב-Google Cloud שאליו נשלחים הנתונים של apigee-logger ושל apigee-metrics.

gcp.workloadIdentity.enabled בסיסי נוספה בגרסה: 1.10.0

ערך ברירת המחדל:false

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-org, ‏apigee-env

מאפשר להשתמש באיחוד זהויות של עומסי עבודה ל-GKE. כך עומסי העבודה באשכולות GKE יכולים להתחזות לחשבונות שירות של ניהול זהויות והרשאות גישה (IAM) כדי לגשת לשירותי Google Cloud.

אסור להגדיר את true אם gcp.federatedWorkloadIdentity.enabled מוגדר ל-true באותו אשכול.

כשהערך של enabled הוא false (ברירת המחדל), Apigee משתמש בשיטות אימות שונות של חשבונות שירות, כמו קובצי מפתחות של חשבונות שירות, סודות של Kubernetes,‏ Vault או איחוד שירותי אימות הזהות של עומסי עבודה בפלטפורמות אחרות. אפשר לקרוא מידע נוסף במאמר שיטות אימות של חשבון שירות ב-Apigee hybrid.

כשהערך של workloadIdentityEnabled הוא true, המערכת של Apigee משתמשת בחשבונות שירות של Kubernetes וממפה אותם לחשבונות השירות המתאימים ב-IAM לכל רכיב. מציינים את חשבונות השירות ב-IAM שרוצים למפות לחשבונות השירות ב-Kubernetes באמצעות:

gcp.workloadIdentity.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-datastore, apigee-telemetry, apigee-org, apigee-env

כתובת האימייל של חשבון השירות של Google IAM‏ (GSA) לכל הרכיבים שצריך לשייך לחשבון השירות התואם של Kubernetes, כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

‫gcp.workloadIdentity.gsa חלה על כל הרכיבים ההיברידיים. אם מציינים ערך ל-gcp.workloadIdentity.gsa, לא צריך לספק GSA לאף אחד מהרכיבים ההיברידיים הנפרדים. אם תספקו GSA לרכיב ספציפי, ה-GSA של הרכיב הזה יחליף את gcp.workloadIdentity.gsa רק ברכיב הזה.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-non-prod@my-hybrid-project.iam.gserviceaccount.com

Enabling Workload Identity on GKE.

guardrails

מזהה את חשבון השירות של Google‏ (GSA) ואת קובץ המפתח שמשמש את שירות Apigee Guardrails. שירות Apigee Guardrails מאפשר לפוד של מעקות הבטיחות בתרשים apigee-operator לבדוק אם ממשקי ה-API הנדרשים מופעלים בפרויקט כדי להתקין בהצלחה את Apigee hybrid, כפי שמתואר במאמרים אבחון בעיות באמצעות מעקות בטיחות והתקנה ושדרוג של סביבת זמן הריצה של Apigee hybrid.

בטבלה הבאה מתוארים המאפיינים של האובייקט guardrails:

מאפיין (property) סוג תיאור
guardrails.image.pullPolicy Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

guardrails.image.tag Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

guardrails.image.url Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

guardrails.gsa Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

כתובת האימייל של apigee-guardrails חשבון השירות של Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-guardrails@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

guardrails.serviceAccountPath בסיסי נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

אם לא משתמשים ב-Workload Identity, צריך להשתמש ב-serviceAccountPath או ב-serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד צפייה בשימוש בשירות.

guardrails.serviceAccountRef Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

אם לא משתמשים ב-Workload Identity, צריך להשתמש ב-serviceAccountPath או ב-serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

guardrails.tolerations.effect Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

guardrails.tolerations.key Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

guardrails.tolerations.operator Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: "Equal"

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

guardrails.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

guardrails.tolerations.value Advanced נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

httpProxy

המדיניות httpProxy מספקת פרמטרים להגדרת שרת proxy של HTTP. כשמגדירים את overrides.yaml, כל התקשורת באינטרנט של הרכיבים Apigee Connect,‏ Logger,‏ MART,‏ Metrics,‏ Synchronizer ו-UDCA עוברת דרך שרת ה-proxy.

ראו גם: connectAgent,‏ logger,‏ mart,‏ metrics ו-synchronizer.

בטבלה הבאה מתוארים המאפיינים של האובייקט httpProxy:

מאפיין (property) סוג תיאור
httpProxy.host בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

שם המארח של ה-Proxy ל-HTTP.

httpProxy.password בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.

httpProxy.port בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

היציאה של ה-Proxy ל-HTTP.

httpProxy.scheme בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: HTTPS

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

הסכימה שבה משתמש שרת ה-proxy. הערכים יכולים להיות HTTP או HTTPS. הערכים חייבים להיות באותיות רישיות בלבד.

httpProxy.useForRuntimeManagement Advanced הושק בגרסה: 1.15.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

אם המדיניות useForRuntimeManagement מוגדרת לערך true, נתוני ניפוי הבאגים או ניתוח הנתונים מנותבים על ידי זמן הריצה באמצעות שרת ה-proxy להעברה הזה. אפשר להגדיר את הדגל הזה גם אם לסביבת זמן הריצה יש הגדרת שרת proxy משלה לסביבה שלה. במקרה כזה, נתוני ניפוי הבאגים או הניתוח של זמן הריצה ישתמשו בשרת ה-proxy שמשותף ברמת הארגון, ואילו תנועת ה-proxy או הקצה העורפי תמשיך להשתמש בשרת ה-proxy ברמת הסביבה (כולל קריאות ל-googleapis.com).

httpProxy.username בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.

ingressGateways

מגדיר כל מכונה נפרדת של שער הכניסה של Apigee. אפשר להשתמש במאפיינים האלה כשרוצים לנהל מופעים ספציפיים בנפרד באמצעות ingressGateways[].name.

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

החלת שינויים על ingressGateways נכסים באמצעות התרשים apigee-org.

בטבלה הבאה מתוארים המאפיינים של האובייקט ingressGateways:

מאפיין (property) סוג תיאור
ingressGateways[].name בסיסי נוספה בגרסה: 1.8.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

חובה

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

  • להיות באורך של עד 17 תווים
  • להכיל רק תווים אלפאנומריים באותיות קטנות, "-" או "."
  • להתחיל בתו אלפאנומרי
  • להסתיים בתו אלפאנומרי

מידע נוסף זמין במאמר שמות של תת-דומיינים ב-DNS במסמכי התיעוד של Kubernetes.

ingressGateways[].podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

משנים את הערך של apigeeIngressGateway.podDisruptionBudget.minAvailable כדי להגדיר את המספר המינימלי של Pods בשער ה-Ingress שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, השער הזה משתמש ב-apigeeIngressGateway.podDisruptionBudget.minAvailable או ב-apigeeIngressGateway.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, שהיא maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

ingressGateways:
  - name: my-gateway
    podDisruptionBudget:
      minAvailable: "50%"
ingressGateways[].podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

משנים את הערך של apigeeIngressGateway.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של Pods בשער ה-Ingress הזה שיכולים להיות לא זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז צמתים. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, השער הזה משתמש ב-apigeeIngressGateway.podDisruptionBudget.minAvailable או ב-apigeeIngressGateway.podDisruptionBudget.maxUnavailable. אם אף אחד מהם לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, שהיא maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

ingressGateways:
  - name: my-gateway
    podDisruptionBudget:
      maxUnavailable: 1
ingressGateways[].proxyProtocol.mode Advanced

נוסף בגרסה: 1.16.6

ערך ברירת המחדל: disable

תרשים: apigee-org

הבעת הסכמה לניתוח של פרוטוקול HAProxy PROXY ברכיב שער הכניסה. הערכים המותרים הם strict,‏ permissive או disable.

כשהערך הזה מוגדר לכל שער, הוא מבטל את ברירת המחדל הגלובלית שמוגדרת ב-apigeeIngressGateway.proxyProtocol.mode.

ingressGateways[].replicaCountMax בסיסי נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 10

תרשים: apigee-org

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

ingressGateways[].replicaCountMin בסיסי נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 2

תרשים: apigee-org

המספר המינימלי של Pods לשער הכניסה שזמינים להתאמה אוטומטית לעומס.

ingressGateways[].resources.limits.cpu Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 2000m

תרשים: apigee-org

מגבלת המעבד (CPU) של המשאב, ב-millicores.

ingressGateways[].resources.limits.memory Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-org

מגבלת הזיכרון של המשאב, במגה-בייטים.

ingressGateways[].resources.requests.cpu Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 300m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של המשאב, ב-millicores.

ingressGateways[].resources.requests.memory Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 128Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה רגילה של המשאב, ב-mebibytes.

ingressGateways[].securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

ingressGateways[].svcAnnotations בסיסי נוספה בגרסה: 1.8.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מפה אופציונלית של מפתח/ערך שמשמשת להוספת הערות לשער הכניסה בפלטפורמות שתומכות בהוספת הערות. לדוגמה:

ingressGateways:
  svcAnnotations:
    networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP בסיסי נוספה בגרסה: 1.8.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

בפלטפורמות שבהן אפשר לציין את כתובת ה-IP של מאזן העומסים, מאזן העומסים ייווצר עם כתובת ה-IP הזו. בפלטפורמות שלא מאפשרות לציין את כתובת ה-IP של מאזן העומסים, המערכת מתעלמת מהמאפיין הזה.

ingressGateways[].svcType בסיסי נוספה בגרסה: 1.8.1

ערך ברירת המחדל: LoadBalancer

תרשים: apigee-org

משמש לשינוי הסוג של שירות ברירת המחדל של k8s לפריסת Ingress. כדי להשבית את היצירה של מאזן עומסים כברירת מחדל, מגדירים את הערך ClusterIP. ערכים אפשריים:

  • ClusterIP
  • LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage Advanced הושקה בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1

ערך ברירת המחדל: 75

תרשים: apigee-org

סף השימוש במעבד (CPU) לשינוי מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים.

כשהשימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר ה-pods ב-ReplicaSet, עד ל-ingressGateways[].replicaCountMax.

למידע נוסף על התאמה לעומס ב-Kubernetes, קראו את המאמר התאמה אופקית של קבוצות Pod לעומס במסמכי התיעוד של Kubernetes.

ingressGateways[].tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

ingressGateways[].tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ingressGateways[].tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-operator

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ingressGateways[].tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ingressGateways[].tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-operator

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

ingressGateways[].topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של apigeeIngressGateway.topologySpreadConstraints.disableHostnameConstraint ושל topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint. כשהערך הוא true, המערכת משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים בשער ה-Ingress הזה.

topologySpreadConstraints

ingressGateways[].topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של apigeeIngressGateway.topologySpreadConstraints.disableZoneConstraint ושל topologySpreadConstraints.apigeeRuntime.disableZoneConstraint. כשהערך הוא true, המדיניות משביתה את אילוץ הפריסה של טופולוגיית אזור הזמינות לפודים בשער הכניסה הזה.

topologySpreadConstraints

ingressGateways[].topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של apigeeIngressGateway.topologySpreadConstraints.enabled ושל topologySpreadConstraints.enabled. הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים בשער הכניסה הזה.

בדוגמה הבאה, ההגדרה הזו מופעלת ב-overrides.yaml:

ingressGateways:
  - name: my-gateway
    topologySpreadConstraints:
      enabled: true

topologySpreadConstraints

ingressGateways[].topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של apigeeIngressGateway.topologySpreadConstraints.zoneKey ושל topologySpreadConstraints.apigeeRuntime.zoneKey. מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של Pods בשער ה-Ingress הזה.

topologySpreadConstraints

ingressGateways[].topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של apigeeIngressGateway.topologySpreadConstraints.zoneRequiredForScheduling ושל topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling. כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת טופולוגיית האזור בפודים בשער ה-Ingress הזה.

topologySpreadConstraints

istiod

מגדירה את ה-ingress של Apigee.

בטבלה הבאה מתוארים המאפיינים של האובייקט istiod:

מאפיין (property) סוג תיאור
istiod.accessLogFile Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: /dev/stdout

תרשים: apigee-ingress-manager

כתובת הקובץ של יומן הגישה של Ingress, לדוגמה /dev/stdout.

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

istiod.accessLogFormat Advanced נוספה בגרסה: 1.8.0

תרשים: apigee-ingress-manager

הפורמט של יומן הגישה של Ingress.

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

פורמט ברירת המחדל של יומן הגישה:

'{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'

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

'{"start_time":"%START_TIME%",
  "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%",
  "user_agent":"%REQ(USER-AGENT)%",
  "host":"%REQ(:AUTHORITY)%",
  "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%",
  "request_time":"%DURATION%",
  "status":"%RESPONSE_CODE%",
  "status_details":"%RESPONSE_CODE_DETAILS%",
  "bytes_received":"%BYTES_RECEIVED%",
  "bytes_sent":"%BYTES_SENT%",
  "upstream_address":"%UPSTREAM_HOST%",
  "upstream_response_flags":"%RESPONSE_FLAGS%",
  "upstream_response_time":"%RESPONSE_DURATION%",
  "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%",
  "upstream_cluster":"%UPSTREAM_CLUSTER%",
  "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%",
  "request_method":"%REQ(:METHOD)%",
  "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%",
  "request_protocol":"%PROTOCOL%",
  "tls_protocol":"%DOWNSTREAM_TLS_VERSION%",
  "request_id":"%REQ(X-REQUEST-ID)%",
  "sni_host":"%REQUESTED_SERVER_NAME%",
  "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
istiod.forwardClientCertDetails Advanced נוספה בגרסה: 1.9.2

ערך ברירת המחדל: SANITIZE_SET

תרשים: apigee-ingress-manager

קובע איך שרת ה-proxy של Envoy (לשער הכניסה של Apigee) מטפל בכותרת ה-HTTP‏ x-forwarded-client-cert (XFCC).

הערכים שאפשר לבחור הם:

  • ‫SANITIZE_SET (ברירת מחדל) כשחיבור הלקוח הוא mTLS, מאפסים את כותרת ה-XFCC עם פרטי אישור הלקוח ושולחים אותה לצעד הבא.
  • FORWARD_ONLY כשהחיבור של הלקוח הוא mTLS (‏Mutual TLS), צריך להעביר את כותרת ה-XFCC בבקשה בלבד.
  • ‫APPEND_FORWARD אם חיבור הלקוח הוא mTLS, מוסיפים את פרטי אישור הלקוח לכותרת ה-XFCC של הבקשה ומעבירים אותה.
  • SANITIZE אל תעבירו את הכותרת של XFCC.
  • ‫ALWAYS_FORWARD_ONLY תמיד להעביר את כותרת ה-XFCC בבקשה, גם אם החיבור של הלקוח הוא mTLS וגם אם לא.

מידע נוסף על הערכים האלה זמין במסמכי התיעוד של Envoy בנושא Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails.

אם משנים את ההגדרה הזו אחרי שמתקינים את Hybrid, צריך להחיל אותה באמצעות apigeectl init ואז להפעיל מחדש את הפודים של שער הכניסה של Apigee.

istiod.healthCheckUserAgents Advanced נוספה בגרסה: 1.12.0

ערכי ברירת מחדל:

- "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)"
- "Edge Health Probe"

תרשים: apigee-ingress-manager

מאפשר למאזני עומסים שאינם שלGoogle Cloud לבדוק את נקודות הקצה של בדיקת התקינות של שער הכניסה (/healthz/ingress ו-/healthz) על ידי שינוי רשימת ההיתרים של סוכן המשתמש שמוגדרת כברירת מחדל ב-hybrid.

כדי לשנות את סוכני המשתמש שמוגדרים כברירת מחדל, משתמשים בתחביר הבא ומזינים את סוכני המשתמש בהתאמה אישית:

istiod:
  healthCheckUserAgents:
  - "CUSTOM_USER_AGENT_1"
  - "CUSTOM_USER_AGENT_2"

כדי להסיר את הדרישה לסוכן משתמש, משתמשים בקוד הבא:

istiod:
  healthCheckUserAgents: []

istiod.image.pullPolicy Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-ingress-manager

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

istiod.image.tag Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-ingress-manager

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

istiod.image.url Advanced נוספה בגרסה: 1.8.0

ערך ברירת המחדל: ללא

תרשים: apigee-ingress-manager

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

istiod.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-ingress-manager

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

istiod.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-ingress-manager

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

istiod.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-ingress-manager

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

istiod.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-ingress-manager

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

istiod.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-ingress-manager

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

istiod.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-ingress-manager

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של istiod.

topologySpreadConstraints

istiod.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-ingress-manager

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של istiod.

topologySpreadConstraints

istiod.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-ingress-manager

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של istiod.

topologySpreadConstraints

istiod.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-ingress-manager

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של istiod.

topologySpreadConstraints

istiod.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-ingress-manager

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפיזור של טופולוגיית האזור בפודים של istiod.

topologySpreadConstraints

k8sCluster

מזהה את אשכול Kubernetes שבו מותקנת סביבת זמן הריצה ההיברידית.

בטבלה הבאה מתוארים המאפיינים של האובייקט k8sCluster:

מאפיין (property) סוג תיאור
k8sCluster.name בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry, apigee-org

השם של אשכול Kubernetes שבו מותקן סביבת זמן הריצה ההיברידית.

k8sCluster.region בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry, apigee-org

האזור ב-Google Cloud שבו נוצר אשכול Kubernetes.

kubeRBACProxy

מזהה את המיקום שבו Apigee צריכה לחפש בקרת גישה המבוססת על תפקידים (RBAC) של Kubernetes.

בטבלה הבאה מתוארים המאפיינים של האובייקט kubeRBACProxy:

מאפיין (property) סוג תיאור
kubeRBACProxy.image.pullPolicy Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-operator, apigee-ingress-manager

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

kubeRBACProxy.image.tag Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-operator, apigee-ingress-manager

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

kubeRBACProxy.image.url Advanced נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator, apigee-ingress-manager

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

kubeRBACProxy.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 500m

תרשים: apigee-operator, apigee-ingress-manager

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

kubeRBACProxy.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 128Mi

תרשים: apigee-operator, apigee-ingress-manager

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

kubeRBACProxy.resources.requests.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 5m

תרשים: apigee-operator, apigee-ingress-manager

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

kubeRBACProxy.resources.requests.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 64Mi

תרשים: apigee-operator, apigee-ingress-manager

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

logger

מגדיר את השירות שמנהל את יומני הפעילות. כל השירותים של Apigee hybrid שפועלים באשכול Kubernetes פולטים את המידע הזה.

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

בטבלה הבאה מתוארים המאפיינים של האובייקט logger:

מאפיין (property) סוג תיאור
logger.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

logger.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

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

logger.bufferChunkSize Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 256k

תרשים: apigee-telemetry

גודל שטח האחסון הזמני הראשוני לקריאת קובצי יומן.

logger.bufferMaxSize Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 104857600

תרשים: apigee-telemetry

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

logger.bufferMemoryLimit Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 150MB

תרשים: apigee-telemetry

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

logger.enabled בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: false

תרשים: apigee-telemetry

הפעלה או השבתה של רישום ביומן באשכול. בסביבות שהן לא GKE, מגדירים את הערך true. ב-GKE ב- Google Cloud או ב-Google Distributed Cloud, מגדירים את הערך false.

logger.envVars בסיסי נוספה בגרסה: 1.8.5

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

מאפשרת לכלול את משתנה הסביבה NO_PROXY של Fluent Bit, שמציין כתובות URL שהתנועה אליהן לא מנותבת דרך שרת ה-proxy ל-HTTP. המשתנה NO_PROXY צריך להיות מוגדר כמחרוזת של שמות מארחים שמופרדים בפסיקים, בפורמט:

logger:
  ...
  envVars:
    NO_PROXY: '<comma-separated-values>'

לדוגמה:

  envVars:
    NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com'

אפשר להשתמש ב-envVars: NO_PROXY אם הפעלתם שרת proxy להעברת HTTP.

אפשר לקרוא מידע נוסף על NO_PROXY במסמכי התיעוד של Fluent Bit.

logger.flushInterval Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 1

תרשים: apigee-telemetry

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

logger.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-logger Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-logger@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

logger.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-telemetry

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

logger.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-telemetry

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

logger.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

logger.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 3

תרשים: apigee-telemetry

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

logger.livenessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 0

תרשים: apigee-telemetry

מספר השניות אחרי הפעלת קונטיינר לפני שמתחילה בדיקת תקינות.

logger.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 60

תרשים: apigee-telemetry

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

logger.livenessProbe.successThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-telemetry

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת החיוּת תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

logger.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-telemetry

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

logger.nodeSelector.key בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: apigee.cloud.google.com/apigee-logger-enabled

תרשים: apigee-telemetry

חובה

מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן ריצה של logger.

הגדרת מאגרי צמתים ייעודיים

logger.nodeSelector.value בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: true

תרשים: apigee-telemetry

חובה

ערך התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן הריצה של logger.

הגדרת מאגרי צמתים ייעודיים

logger.resources.limits.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 200m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

logger.resources.limits.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 500Mi

תרשים: apigee-telemetry

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

logger.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 100m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

logger.resources.requests.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 250Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

logger.serviceAccountPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כותב יומנים.

logger.serviceAccountRef בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

logger.storageMaxChunks Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 128

תרשים: apigee-telemetry

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

logger.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 30

תרשים: apigee-telemetry

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

logger.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

logger.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

logger.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

logger.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

logger.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart

מגדיר את שירות MART (Management API for RunTime data), שפועל כספק API לממשקי API ציבוריים של Apigee, כדי שתוכלו לגשת לישויות נתונים של זמן ריצה ולנהל אותן, כמו KMS (מפתחות API ואסימוני OAuth),‏ KVM, מכסות ומוצרי API.

בטבלה הבאה מתוארים המאפיינים של האובייקט mart:

מאפיין (property) סוג תיאור
mart.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

mart.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

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

mart.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-mart Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-mart@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

mart.hostAlias בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

הכינוי של המארח שמפנה לאובייקט MART. אפשר להגדיר את המאפיין הזה לערך * או לשם דומיין שמוגדר במלואו.

mart.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org, apigee-env

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

mart.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org, apigee-env

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

mart.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org, apigee-env

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

mart.initCheckCF.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 10m

תרשים: apigee-org

כמות משאבי המעבד (CPU) שהוקצו לבדיקת האתחול של תהליך Cloud Foundry.

mart.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 12

תרשים: apigee-org

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

mart.livenessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 15

תרשים: apigee-org

מספר השניות אחרי הפעלת קונטיינר לפני שמתחילה בדיקת תקינות.

mart.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-org

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

mart.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-org

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

mart.metricsURL בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: /v1/server/metrics

תרשים: apigee-org

mart.nodeSelector.key בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של mart. אם לא מציינים מפתח ל-mart.nodeselector, סביבת זמן הריצה משתמשת בצומת שצוין באובייקט nodeSelector.

הגדרת מאגרי צמתים ייעודיים

mart.nodeSelector.value בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

ערך אופציונלי של תווית בורר הצמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של mart. אפשר לעיין גם באובייקט nodeSelector.

הגדרת מאגרי צמתים ייעודיים

mart.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המינימלי של פודים של MART שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

mart:
  podDisruptionBudget:
    minAvailable: "50%"
mart.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המקסימלי של פודים של MART שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

mart:
  podDisruptionBudget:
    maxUnavailable: 1
mart.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-org

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

mart.readinessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 15

תרשים: apigee-org

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

mart.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-org

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

mart.readinessProbe.successThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-org

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

mart.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-org

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

mart.replicaCountMax בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-org

המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

mart.replicaCountMin בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-org

המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

mart.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 2000m

תרשים: apigee-org

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

mart.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 5Gi

תרשים: apigee-org

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

mart.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 500m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

mart.resources.requests.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

mart.serviceAccountPath בסיסי נוספה בגרסה: 1.1.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את serviceAccountPath או את serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google ללא תפקיד.

mart.serviceAccountRef בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את serviceAccountPath או את serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

mart.sslCertPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

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

mart.sslKeyPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

נתיב מערכת הקבצים המקומית לטעינה ולקידוד של מפתח ה-SSL ל-Secret.

mart.sslSecret בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את אישור ה-TLS והמפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח ואישור ה-TLS כקלט.

מידע נוסף:

mart.targetCPUUtilizationPercentage Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 75

תרשים: apigee-org

ניצול יעד של המעבד (CPU) לתהליך MART ב-pod. הערך של השדה הזה מאפשר ל-MART לבצע התאמה אוטומטית לעומס כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.

mart.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 30

תרשים: apigee-org

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

mart.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

mart.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך מוגדר כ-true, האילוץ של פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) מושבת לפודים של MART.

topologySpreadConstraints

mart.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ הפריסה של טופולוגיית אזור הזמינות לפודים של MART.

topologySpreadConstraints

mart.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של MART.

topologySpreadConstraints

mart.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי זמינות של pod של MART.

topologySpreadConstraints

mart.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת הטופולוגיה של האזור בפודים של MART.

topologySpreadConstraints

mcpServer

מגדיר את מישור הנתונים של MCP, הרכיב בתוך האשכול שמשרת קריאות API לכלי Model Context Protocol‏ (MCP) מתרמילי זמן הריצה של Apigee. כברירת מחדל, MCP מושבת. כדי להפעיל את MCP, מגדירים את המאפיין enableMcpServer ברמה העליונה לערך true. המאפיינים של mcpServer נכנסים לתוקף רק אם הערך של enableMcpServer הוא true.

מידע נוסף זמין במאמרים הפעלת Model Context Protocol‏ (MCP) ב-Apigee Hybrid וסקירה כללית על Model Context Protocol‏ (MCP) ב-Apigee.

בטבלה הבאה מתוארים המאפיין enableMcpServer והמאפיינים של האובייקט mcpServer:

מאפיין (property) סוג תיאור
enableMcpServer בסיסי נוספה בגרסה: 1.17.0

ערך ברירת המחדל: false

תרשים: apigee-org

‫enableMcpServer הוא נכס ברמה העליונה, ולא חלק מהאובייקט mcpServer. מגדירים את הערך true כדי להפעיל את Model Context Protocol‏ (MCP) באשכול הזה. כשהערך הוא true, האופרטור של Apigee יוצר את מישור הנתונים של MCP באשכול ומגדיר את Pods של סביבת זמן הריצה של Apigee לנתב אליו קריאות API לכלי MCP. כאשר false, התרשים מתעלם מכל המאפיינים של mcpServer.

לדוגמה, ברמה העליונה של overrides.yaml, באותה רמה כמו instanceID ו-org:

instanceID: "INSTANCE_ID"
org: ORGANIZATION_NAME
enableMcpServer: true

מידע נוסף זמין במאמר הפעלת Model Context Protocol‏ (MCP) ב-Apigee Hybrid.

mcpServer.annotations Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

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

mcpServer.gsa Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

‫Helm בלבד: כתובת האימייל של חשבון השירות ב-IAM‏ (GSA) של ה-sidecar של ה-MCP. התרשים משייך אותו לחשבון השירות של MCP Kubernetes כש-gcp.workloadIdentity.enabled הוא true.

אם לא מגדירים את mcpServer.gsa, פרוטוקול MCP משתמש ב-watcher.gsa ואז ב-gcp.workloadIdentity.gsa. לזהות apigee-watcher כבר יש את ההרשאות שנדרשות ל-MCP sidecar, לכן אל תגדירו את המאפיין הזה אלא אם הארגון שלכם דורש זהות נפרדת ל-MCP sidecar.

כתובות האימייל של GSA בדרך כלל נראות ככה:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

מידע נוסף זמין במאמר הפעלת Model Context Protocol‏ (MCP) ב-Apigee Hybrid.

mcpServer.image.pullPolicy Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

mcpServer.image.tag Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker של קונטיינר מישור הנתונים של MCP.

mcpServer.image.url Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker לקונטיינר של מישור הנתונים של MCP‏ (apigee-envoy-dataplane).

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

mcpServer.nodeSelector Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

לא חל בגרסה 1.17.0. המאפיין הזה מוגדר בתרשים apigee-org, אבל לא נעשה בו שימוש. הפודים של MCP פועלים במאגר הצמתים של זמן הריצה שנבחר על ידי nodeSelector.apigeeRuntime.key ו-nodeSelector.apigeeRuntime.value. כדי לקבוע איפה יפעלו פודים של MCP, צריך להגדיר את המאפיינים האלה.

הגדרת מאגרי צמתים ייעודיים

mcpServer.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המקסימלי של פודים של MCP שלא יכולים להיות זמינים במהלך שיבוש יזום, כמו במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable לא יכולים להתקיים בו-זמנית, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שני השדות בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

mcpServer:
  podDisruptionBudget:
    maxUnavailable: 1
mcpServer.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המינימלי של פודים של MCP שחייבים להישאר זמינים במהלך שיבוש יזום, כמו במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable לא יכולים להתקיים בו-זמנית, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שני השדות בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

mcpServer:
  podDisruptionBudget:
    minAvailable: "50%"
mcpServer.replicaCountMax בסיסי נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 10

תרשים: apigee-org

המספר המקסימלי של רפליקות של פודים של MCP שזמינות להתאמה אוטומטית לעומס. אם ה-Horizontal Pod Autoscaler נשאר במקסימום בזמן שיא התנועה ב-MCP, צריך להגדיל את הערך הזה.

mcpServer.replicaCountMin בסיסי נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 2

תרשים: apigee-org

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

mcpServer.resources.limits.cpu Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 2000m

תרשים: apigee-org

מגבלת המעבד (CPU) של מאגר מישור הנתונים של MCP, באלפיות ליבה.

mcpServer.resources.limits.memory Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-org

מגבלת הזיכרון של מאגר מישור הנתונים של MCP, במגה-בייטים או בגיגה-בייטים.

mcpServer.resources.requests.cpu Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 500m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של מאגר מישור הנתונים של MCP, באלפיות ליבה.

mcpServer.resources.requests.memory Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה תקינה של מאגר מישור הנתונים של MCP, ב-mebibytes.

mcpServer.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים ערך, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

mcpServer.serviceAccountPath Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

הנתיב לקובץ מפתח של חשבון שירות ב-Google בשביל ה-sidecar של MCP. משמש כשלא מופעל איחוד זהויות של עומסי עבודה ל-GKE.

אם לא מגדירים את mcpServer.serviceAccountPath, פרוטוקול MCP משתמש ב-watcher.serviceAccountPath. לזהות apigee-watcher כבר יש את ההרשאות שנדרשות ל-MCP sidecar, לכן אל תגדירו את המאפיין הזה אלא אם הארגון שלכם דורש זהות נפרדת ל-MCP sidecar.

אם לא הפעלתם את איחוד הזהויות של עומסי עבודה ל-GKE, ולא הגדרתם את mcpServer.serviceAccountRef או את serviceAccountSecretProviderClass, אתם צריכים להגדיר את mcpServer.serviceAccountPath או את watcher.serviceAccountPath.

mcpServer.serviceAccountRef Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

השם של סוד קיים ב-Kubernetes, במרחב השמות של Apigee, שמכיל מפתח של חשבון שירות ב-IAM ל-MCP sidecar. משתמשים במאפיין הזה רק אם מנהלים את הסודות של מפתחות חשבונות השירות מחוץ לתרשימי Apigee Helm. צריך להגדיר רק אחד מהערכים הבאים: mcpServer.gsa,‏ mcpServer.serviceAccountPath או mcpServer.serviceAccountRef.

אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

mcpServer.sidecar.image.pullPolicy Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

mcpServer.sidecar.image.tag Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker של הקונטיינר המשני (sidecar) של MCP.

mcpServer.sidecar.image.url Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker לקונטיינר המשני (sidecar) של MCP (apigee-watcher). הקונטיינר המשני של MCP מאחזר את הגדרות ה-MCP ממישור הבקרה של Apigee.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

mcpServer.sidecar.resources.limits.cpu Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 500m

תרשים: apigee-org

מגבלת המעבד (CPU) לקונטיינר המשני (sidecar) של MCP, באלפיות ליבה.

mcpServer.sidecar.resources.limits.memory Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-org

מגבלת הזיכרון של קונטיינר ה-sidecar של MCP, ב-mebibyte.

mcpServer.sidecar.resources.requests.cpu Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 200m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של קונטיינר משני (sidecar) של MCP, באלפיות ליבה.

mcpServer.sidecar.resources.requests.memory Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 128Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה רגילה של קונטיינר משני (sidecar) של MCP, במיבי-בייט.

mcpServer.targetCPUUtilizationPercentage Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 70

תרשים: apigee-org

יעד השימוש במעבד (CPU) לפודים של MCP. כשהשימוש ב-CPU מגיע לערך הזה, ה-Horizontal Pod Autoscaler מוסיף פודים של MCP, עד mcpServer.replicaCountMax.

mcpServer.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: 30

תרשים: apigee-org

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

mcpServer.tolerations.effect Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

mcpServer.tolerations.key Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mcpServer.tolerations.operator Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mcpServer.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mcpServer.tolerations.value Advanced נוספה בגרסה: 1.17.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mcpServer.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של MCP.

topologySpreadConstraints

mcpServer.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של MCP.

topologySpreadConstraints

mcpServer.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של MCP.

topologySpreadConstraints

mcpServer.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי זמינות של פודים של MCP.

topologySpreadConstraints

mcpServer.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת טופולוגיית האזור בפודים של MCP.

topologySpreadConstraints

metrics

מגדיר את השירות שאוסף מדדי פעולות. אתם יכולים להשתמש בנתוני המדדים כדי לעקוב אחרי התקינות של שירותי Hybrid, להגדיר התראות ועוד.

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

בטבלה הבאה מתוארים המאפיינים של האובייקט metrics:

מאפיין (property) סוג תיאור
metrics.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

metrics.adapter.image.pullPolicy Advanced נוספה בגרסה: 1.8.1

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-telemetry

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

metrics.adapter.image.tag Advanced נוספה בגרסה: 1.8.1

ערך ברירת המחדל: 1.17.4

תרשים: apigee-telemetry

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.adapter.image.url Advanced נוספה בגרסה: 1.8.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

metrics.adapter.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המינימלי של פודים של מתאם מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  adapter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המקסימלי של פודים של מתאם מדדים שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  adapter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.adapter.resources.limits.cpu Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב המתאם בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.adapter.resources.limits.memory Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 4Gi

תרשים: apigee-telemetry

מגבלת הזיכרון של משאב המתאם בקונטיינר של Kubernetes, בגיביבייט.

metrics.adapter.resources.requests.cpu Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 100m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של המתאם בקונטיינר של Kubernetes, ב-millicores.

metrics.adapter.resources.requests.memory Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 128Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של המתאם בקונטיינר של Kubernetes, ב-mebibyte.

metrics.aggregator.resources.requests.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של האגרגטור בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.aggregator.resources.requests.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של האגרגטור בקונטיינר של Kubernetes, ב-mebibytes.

metrics.aggregator.resources.limits.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) של משאב הצבירה בקונטיינר של Kubernetes, ב-millicores.

metrics.aggregator.resources.limits.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 3Gi

תרשים: apigee-telemetry

מגבלת הזיכרון של משאב האגרגטור בקונטיינר של Kubernetes, בגיביבייט.

metrics.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

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

metrics.app.resources.requests.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.

metrics.app.resources.requests.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, ב-mebibyte.

metrics.app.resources.limits.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.

metrics.app.resources.limits.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-telemetry

מגבלת הזיכרון של משאב האפליקציה בקונטיינר של Kubernetes, בגיביבייט.

metrics.appStackdriverExporter.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המינימלי של פודים מסוג appStackdriverExporter שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  appStackdriverExporter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.appStackdriverExporter.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המקסימלי של Pods מסוג appStackdriverExporter שיכולים להיות לא זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  appStackdriverExporter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.appStackdriverExporter.resources.limits.cpu Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.appStackdriverExporter.resources.limits.memory Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-telemetry

מגבלת הזיכרון למשאב stackdriverExporter בקונטיינר של Kubernetes, בגיביבייט.

metrics.appStackdriverExporter.resources.requests.cpu Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 128m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.appStackdriverExporter.resources.requests.memory Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, ב-mebibytes.

metrics.collector.envVars בסיסי נוספה בגרסה: 1.13

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

מאפשר להעביר משתני סביבה ב-OpenTelemetry ולשנות אותם. לדוגמה, אפשר להגדיר את HTTP_PROXY,‏ HTTPS_PROXY או NO_PROXY כך שהבקשות שלהם יעברו דרך שרת ה-proxy.

אפשר להגדיר את המשתנה HTTP_PROXY כמחרוזת שמכילה את שם המארח, בפורמט:

metrics:
...
  envVars:
    HTTP_PROXY: '<host-name>'

לדוגמה:

  envVars:
    HTTP_PROXY: 'http://1.1.1.1:80'

אפשר להגדיר את המשתנה HTTPS_PROXY כמחרוזת שמכילה את שם המארח, בפורמט:

metrics:
...
  envVars:
    HTTPS_PROXY: '<host-name>'

לדוגמה:

  envVars:
    HTTPS_PROXY: 'https://1.1.1.1:80'

המשתנה NO_PROXY צריך להיות מוגדר כמחרוזת של שמות מארחים שמופרדים בפסיקים, בפורמט:

metrics:
...
envVars:
  NO_PROXY: '<comma-separated-values>'

לדוגמה:

envVars:
  NO_PROXY: 'https://1.1.1.1:80, https://1.1.1.1:81'

אפשר להשתמש ב-envVars: HTTP_PROXY, ב-envVars: HTTPS_PROXY או ב-envVars: NO_PROXY אם מופעל שרת proxy להעברת HTTP.

תמיכה בשרת proxy במסמכי התיעוד של OpenTelemetry.

metrics.collector.imagePullPolicy Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-telemetry

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר שימוש במאגר אימג'ים פרטי עם Apigee hybrid.

metrics.collector.image.tag בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-telemetry

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.collector.image.url בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

metrics.collector.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המינימלי של פודים לאיסוף מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שהאוסף פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מהפודים של האוסף (מעוגלים כלפי מטה) במקום להשתמש ב-maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

metrics:
  collector:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המקסימלי של פודים לאיסוף מדדים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שהאוסף פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מהפודים של האוסף (מעוגלים כלפי מטה) במקום להשתמש ב-maxUnavailable: 1.

לדוגמה, ב-overrides.yaml:

metrics:
  collector:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.collector.resources.requests.cpu Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.

metrics.collector.resources.requests.memory Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, ב-mebibyte.

metrics.collector.resources.limits.cpu Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.

metrics.collector.resources.limits.memory Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-telemetry

מגבלת הזיכרון של משאב האפליקציה בקונטיינר של Kubernetes, בגיביבייט.

metrics.collector.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 5

תרשים: apigee-telemetry

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

metrics.collector.livenessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 30

תרשים: apigee-telemetry

מספר השניות אחרי הפעלת קונטיינר לפני שמתחילה בדיקת תקינות.

metrics.collector.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 10

תרשים: apigee-telemetry

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

metrics.collector.livenessProbe.successThreshold Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 1

תרשים: apigee-telemetry

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת תקינות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

metrics.collector.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 5

תרשים: apigee-telemetry

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

metrics.collector.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 3

תרשים: apigee-telemetry

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

metrics.collector.readinessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 30

תרשים: apigee-telemetry

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

metrics.collector.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 10

תרשים: apigee-telemetry

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

metrics.collector.readinessProbe.successThreshold Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 1

תרשים: apigee-telemetry

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

metrics.collector.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.12.0

ערך ברירת המחדל: 5

תרשים: apigee-telemetry

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

metrics.disablePrometheusPipeline בסיסי נוספה בגרסה: 1.12.0

ערך ברירת המחדל: true

תרשים: apigee-telemetry

מדדים של משאבים במעקב מסוג ProxyV2 ו-TargetV2 לא מופקים כשהערך מוגדר ל-true. במקום זאת, צריך להשתמש במדדים של המשאבים במעקב Proxy ו-Target.

metrics.enabled בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: true

תרשים: apigee-telemetry

הפעלת מדדי Apigee. כדי להפעיל את המדדים, מגדירים את הערך true. כדי להשבית את המדדים, מגדירים את הערך false.

metrics.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-metrics Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-metrics@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

metrics.nodeSelector.key בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

חובה

מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן ריצה של metrics.

הגדרת מאגרי צמתים ייעודיים

metrics.nodeSelector.value בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

חובה

ערך התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן הריצה של metrics.

הגדרת מאגרי צמתים ייעודיים

metrics.prometheus.containerPort Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 9090

תרשים: apigee-telemetry

היציאה לחיבור לשירות המדדים של Prometheus.

metrics.prometheus.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-telemetry

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

metrics.prometheus.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-telemetry

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.prometheus.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

metrics.prometheus.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 6

תרשים: apigee-telemetry

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

metrics.prometheus.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-telemetry

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

metrics.prometheus.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 3

תרשים: apigee-telemetry

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

metrics.prometheus.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 120

תרשים: apigee-telemetry

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

metrics.prometheus.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-telemetry

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

metrics.prometheus.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 3

תרשים: apigee-telemetry

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

metrics.prometheus.resources.limits.cpu Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב Prometheus בקונטיינר של Kubernetes, ב-millicores.

metrics.prometheus.resources.limits.memory Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 4Gi

תרשים: apigee-telemetry

מגבלת הזיכרון למשאב Prometheus בקונטיינר של Kubernetes, בגיביבייט.

metrics.prometheus.resources.requests.cpu Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 128m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של Prometheus בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.prometheus.resources.requests.memory Advanced נוספה בגרסה: 1.14.1

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של Prometheus בקונטיינר של Kubernetes, במגה-בייטים.

metrics.prometheus.sslCertPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

חובה

הנתיב לאישור ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים.

אפשר לעיין במאמרים הבאים:

metrics.prometheus.sslKeyPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

חובה

הנתיב למפתח ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים.

אפשר לעיין במאמרים הבאים:

metrics.proxy.resources.requests.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של שרת ה-proxy בקונטיינר של Kubernetes, ב-millicores.

metrics.proxy.resources.requests.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של שרת ה-proxy בקונטיינר של Kubernetes, במגה-בייטים.

metrics.proxy.resources.limits.cpu Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב ה-proxy בקונטיינר של Kubernetes, ב-millicores.

metrics.proxy.resources.limits.memory Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-telemetry

מגבלת הזיכרון למשאב ה-proxy בקונטיינר של Kubernetes, בגיביבייט.

metrics.proxyStackdriverExporter.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המינימלי של פודים מסוג proxyStackdriverExporter שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  proxyStackdriverExporter:
    podDisruptionBudget:
      minAvailable: "50%"
metrics.proxyStackdriverExporter.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המספר המקסימלי של Pods מסוג proxyStackdriverExporter שיכולים להיות לא זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

metrics:
  proxyStackdriverExporter:
    podDisruptionBudget:
      maxUnavailable: 1
metrics.proxyStackdriverExporter.resources.requests.cpu Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 128m

תרשים: apigee-telemetry

המעבד (CPU) שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.proxyStackdriverExporter.resources.requests.memory Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-telemetry

הזיכרון שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, ב-mebibytes.

metrics.proxyStackdriverExporter.resources.limits.cpu Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 500m

תרשים: apigee-telemetry

מגבלת המעבד (CPU) למשאב stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.

metrics.proxyStackdriverExporter.resources.limits.memory Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-telemetry

מגבלת הזיכרון למשאב stackdriverExporter בקונטיינר של Kubernetes, בגיביבייט.

metrics.proxyURL בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

כתובת ה-URL של קובץ העזר החיצוני של תהליך המדדים באשכול Kubernetes.

metrics.sdSidecar.containerPort Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 9091

תרשים: apigee-telemetry

היציאה לחיבור לשירות המדדים של Cloud Monitoring.

metrics.sdSidecar.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-telemetry

קובע מתי Kubelet שולף את קובץ האימג' של Docker של השירות הזה. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת
  • ‫Always: תמיד לשלוף את המדיניות, גם אם היא כבר קיימת

    מידע נוסף זמין במאמר עדכון תמונות.

metrics.sdSidecar.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-telemetry

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.sdSidecar.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

metrics.serviceAccountPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כתיבת מדדי מעקב.

metrics.serviceAccountRef בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

metrics.stackdriverExporter.resources.requests.cpu Advanced נוספה בגרסה: 1.4.0

תרשים: apigee-telemetry

‫Deprecated: החל מגרסה 1.8 של Hybrid, הוחלף metrics:stackdriverExporter ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים:

metrics.stackdriverExporter.resources.requests.memory Advanced נוספה בגרסה: 1.4.0

תרשים: apigee-telemetry

‫Deprecated: החל מגרסה 1.8 של Hybrid, הוחלף metrics:stackdriverExporter ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים:

metrics.stackdriverExporter.resources.limits.cpu Advanced נוספה בגרסה: 1.4.0

תרשים: apigee-telemetry

‫Deprecated: החל מגרסה 1.8 של Hybrid, הוחלף metrics:stackdriverExporter ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים:

metrics.stackdriverExporter.resources.limits.memory Advanced נוספה בגרסה: 1.4.0

תרשים: apigee-telemetry

‫Deprecated: החל מגרסה 1.8 של Hybrid, הוחלף metrics:stackdriverExporter ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים:

metrics.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 300

תרשים: apigee-telemetry

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

metrics.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

metrics.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

metrics.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-telemetry

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

metrics.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

metrics.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-telemetry

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mintTaskScheduler

‫mintTaskScheduler היא משימת ה-cron לתזמון משימות מונטיזציה, כמו חישוב עמלות חוזרות על בסיס תקופתי.

בטבלה הבאה מתוארים המאפיינים של האובייקט mintTaskScheduler:

מאפיין (property) סוג תיאור
mintTaskScheduler.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

mintTaskScheduler.gsa Advanced הושק בגרסה: 1.15.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

כתובת האימייל של חשבון השירות (GSA) ב-Google IAM שמשויך ל-apigee-mint-task-scheduler, שצריך לשייך לחשבון השירות התואם ב-Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה אם הגדרתם את gcp.workloadIdentity.enabled בתור true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-mint-task-scheduler@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

mintTaskScheduler.image.pullPolicy Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

mintTaskScheduler.image.tag Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

mintTaskScheduler.image.url Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

mintTaskScheduler.resources.limits.cpu Advanced נוספה בגרסה: 1.1.0

ערך ברירת המחדל: 2000m

תרשים: apigee-org

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

mintTaskScheduler.resources.limits.memory Advanced נוספה בגרסה: 1.1.0

ערך ברירת המחדל: 4Gi

תרשים: apigee-org

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

mintTaskScheduler.resources.requests.cpu Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 500m

תרשים: apigee-org

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

mintTaskScheduler.resources.requests.memory Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 512Mi

תרשים: apigee-org

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibytes.

mintTaskScheduler.serviceAccountPath בסיסי הושק בגרסה: 1.15.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google.

mintTaskScheduler.serviceAccountRef בסיסי הושק בגרסה: 1.15.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

mintTaskScheduler.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

mintTaskScheduler.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mintTaskScheduler.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mintTaskScheduler.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mintTaskScheduler.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

newDataPipeline

המאפיין newDataPipeline קובע אם Apigee Hybrid משתמש בפייפליין הנתונים של Pub/Sub כדי שרכיבי זמן הריצה יכתבו נתונים ישירות למישור הבקרה.

בטבלה הבאה מתוארים המאפיינים של האובייקט newDataPipeline:

מאפיין (property) סוג תיאור
newDataPipeline.debugSession Advanced נוספה בגרסה: 1.13.1

ערך ברירת המחדל: true

תרשים: apigee-env

ההגדרה קובעת אם צינור הנתונים של Pub/Sub מופעל.

newDataPipeline.analytics Advanced נוספה בגרסה: 1.13.1

ערך ברירת המחדל: true

תרשים: apigee-env

ההגדרה קובעת אם הניתוח משתמש בפייפליין של Pub/Sub.

nodeSelector

האובייקט nodeSelector מגדיר את הצומת של מכונת Apigee. מאחורי הקלעים, Apigee hybrid ממפה את מפתח/ערך התווית של apigeeRuntime ו-apigeeData לרכיבי Istio ו-MART הנפרדים כשמתקינים או משדרגים את התרשימים של apigee-org ו-apigee-ingress-manager. אפשר לשנות את ההגדרה הזו לאובייקטים ספציפיים במאפיין mart:nodeSelector.

בטבלה הבאה מתוארים המאפיינים של האובייקט nodeSelector:

מאפיין (property) סוג תיאור
nodeSelector.apigeeData.key Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: cloud.google.com/gke-nodepool

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

‫ApigeeData הוא הצומת של מסד הנתונים של Cassandra. מפתח תווית של בורר צמתים לטירגוט צומתי Kubernetes לעבודה עם נתוני שירותי Apigee.

הגדרת מאגרי צמתים ייעודיים

nodeSelector.apigeeData.value Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: apigee-data

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

‫apigee-data הוא הצומת של מסד הנתונים של Cassandra. ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לעבודה עם נתוני שירותי Apigee.

הגדרת מאגרי צמתים ייעודיים

nodeSelector.apigeeRuntime.key Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: cloud.google.com/gke-nodepool

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

‫Apigee Runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. מפתח תווית של בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן ריצה של Apigee.

הגדרת מאגרי צמתים ייעודיים

nodeSelector.apigeeRuntime.value Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: apigee-runtime

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

‫apigee-runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של Apigee.

הגדרת מאגרי צמתים ייעודיים

nodeSelector.requiredForScheduling Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: true

תרשים: apigee-operator, ‏apigee-datastore, ‏apigee-telemetry, ‏apigee-redis, ‏apigee-ingress-manager, ‏apigee-org, ‏apigee-env, ‏apigee-virtualhost

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

בגרסת הייצור, צריך להגדיר את nodeSelector.requiredForScheduling כ-true.

הגדרת מאגרי צמתים ייעודיים

redis

בטבלה הבאה מתוארים המאפיינים של האובייקט redis:

מאפיין (property) סוג תיאור
redis.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-redis

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

redis.auth.password בסיסי נוסף בגרסה: 1.6.0

ערך ברירת המחדל: iloveapis123

תרשים: apigee-redis

חובה

הסיסמה של האדמין ב-Redis. המשתמש עם הרשאת האדמין משמש לכל פעולות הניהול שמתבצעות באשכול Redis.

redis.auth.secret בסיסי נוספה בגרסה: 1.9.1

ערך ברירת המחדל: ללא

תרשים: apigee-redis

שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את הסיסמה של מנהל המערכת של Redis. קובץ הסוד צריך להכיל את המפתח:

data:
    redis.auth.password: encoded_value

מידע נוסף:

redis.envoy.image.pullPolicy Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-redis

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

redis.envoy.image.tag Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-redis

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

redis.envoy.image.url Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: ללא

תרשים: apigee-redis

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

redis.envoy.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-redis

המספר המינימלי של פודים של Redis Envoy שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

redis:
  envoy:
    podDisruptionBudget:
      minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-redis

המספר המקסימלי של פודים של Redis Envoy שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

redis:
  envoy:
    podDisruptionBudget:
      maxUnavailable: 1
redis.envoy.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . אם הערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של Redis Envoy.

topologySpreadConstraints

redis.envoy.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המערכת משביתה את אילוץ הפריסה של טופולוגיית אזור הזמינות לפודים של Redis Envoy.

topologySpreadConstraints

redis.envoy.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של Redis Envoy.

topologySpreadConstraints

redis.envoy.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי זמינות של pod של Redis Envoy.

topologySpreadConstraints

redis.envoy.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת כ-DoNotSchedule לאילוץ של פריסת הטופולוגיה של האזור בפודים של Redis Envoy.

topologySpreadConstraints

redis.image.pullPolicy Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-redis

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

redis.image.tag Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-redis

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

redis.image.url Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: ללא

תרשים: apigee-redis

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

redis.replicaCount בסיסי נוסף בגרסה: 1.6.0

ערך ברירת המחדל: 2

תרשים: apigee-redis

‫Redis הוא אחסון משוכפל. המאפיין הזה מציין את מספר צומתי Redis שמועסקים כ-StatefulSet.

redis.resources.requests.cpu Advanced נוסף בגרסה: 1.6.0

ערך ברירת המחדל: 500m

תרשים: apigee-redis

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

redis.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-redis

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

redis.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-redis

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

redis.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-redis

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

redis.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-redis

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

redis.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-redis

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

redis.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המערכת משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של Redis.

topologySpreadConstraints

redis.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ הפריסה של טופולוגיית אזור הזמינות של פודים של Redis.

topologySpreadConstraints

redis.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של Redis.

topologySpreadConstraints

redis.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של Redis.

topologySpreadConstraints

redis.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפיזור של טופולוגיית האזור בפודים של Redis.

topologySpreadConstraints

runtime

בטבלה הבאה מתוארים המאפיינים של האובייקט runtime:

מאפיין (property) סוג תיאור
runtime.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

runtime.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

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

runtime.envVars בסיסי נוספה בגרסה: 1.13.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

מאפשר לספק משתני סביבה נוספים לרכיב זמן הריצה בצמד מפתח/ערך:

runtime:
  envVars:
    KEY_1: VALUE_N
    ... ...
    KEY_N: VALUE_N

לדוגמה:

runtime:
  envVars:
    RUNTIME_ENV_VAR1: "value of runtime env-var 1"
    RUNTIME_ENV_VAR2: "value of runtime env-var 2"
runtime.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-env

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

runtime.hpaBehavior.scaleDown.percent.periodSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 60

תרשים: apigee-env

חלון הזמן שבו המדיניות צריכה להתקיים כשמצמצמים אנכית בהתאם לעומס (scale down) אחוז מסוים של מכונות בזמן ריצה.

runtime.hpaBehavior.scaleDown.percent.value Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 20

תרשים: apigee-env

השינוי המותר לפי המדיניות כשמצמצמים אנכית בהתאם לעומס (scale down) את אחוז המכונות בזמן הריצה.

runtime.hpaBehavior.scaleDown.pods.periodSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 60

תרשים: apigee-env

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

runtime.hpaBehavior.scaleDown.pods.value Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 20

תרשים: apigee-env

מידת השינוי שמותרת לפי המדיניות כשמצמצמים אנכית בהתאם לעומס (scale down) את מספר המכונות בזמן הריצה.

runtime.hpaBehavior.scaleDown.selectPolicy Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: דקה אחת

תרשים: apigee-env

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

runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 120

תרשים: apigee-env

מספר השניות שבהן המערכת צריכה להתחשב בהמלצות קודמות בזמן צמצום אנכי בהתאם לעומס (scale down).

runtime.hpaBehavior.scaleUp.percent.periodSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 60

תרשים: apigee-env

חלון הזמן שבו המדיניות צריכה להתקיים כשמגדילים את אחוז המכונות בזמן הריצה.

runtime.hpaBehavior.scaleUp.percent.value Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 20

תרשים: apigee-env

חלון הזמן שבו המדיניות צריכה להתקיים כשמגדילים את אחוז המכונות בזמן הריצה.

runtime.hpaBehavior.scaleUp.pods.periodSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 60

תרשים: apigee-env

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

runtime.hpaBehavior.scaleUp.pods.value Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 4

תרשים: apigee-env

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

runtime.hpaBehavior.scaleUp.selectPolicy Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: מקסימלי

תרשים: apigee-env

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

runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 30

תרשים: apigee-env

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

runtime.hpaMetrics.serverMainTaskWaitTime Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 400M

תרשים: apigee-env

זמן ההמתנה הממוצע הרצוי (באלפיות השנייה) של תור העיבוד במכונות בזמן ריצה לבקשות שרת proxy בשכבת ה-HTTP.

runtime.hpaMetrics.serverNioTaskWaitTime Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 400M

תרשים: apigee-env

זמן ההמתנה הממוצע הרצוי (באלפיות השנייה) של תור העיבוד במופעי זמן ריצה לבקשות של שרת proxy לעיבוד כללי מדיניות.

runtime.hpaMetrics.targetCPUUtilizationPercentage Advanced נוסף בגרסה: 1.7.0

ערך ברירת המחדל: 75

תרשים: apigee-env

אחוז הניצול הרצוי של המעבד (CPU) בכל המכונות של סביבת זמן הריצה.

runtime.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-env

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

runtime.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

runtime.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-env

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

runtime.livenessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 60

תרשים: apigee-env

מספר השניות אחרי הפעלת קונטיינר לפני שמתחילה בדיקת תקינות.

runtime.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-env

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

runtime.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

runtime.nodeSelector.key בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי runtime.

המאפיין nodeSelector

runtime.nodeSelector.value בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לשירותי runtime.

הגדרת מאגרי צמתים ייעודיים

runtime.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

המספר המינימלי של פודים של זמן ריצה שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של סביבת זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.minAvailable.

לדוגמה, ב-overrides.yaml:

runtime:
  podDisruptionBudget:
    minAvailable: "50%"
runtime.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

המספר המקסימלי של פודים של סביבת זמן ריצה שלא יכולים להיות זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

maxUnavailable ו-minAvailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של סביבת זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.maxUnavailable.

לדוגמה, ב-overrides.yaml:

runtime:
  podDisruptionBudget:
    maxUnavailable: 1
runtime.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-env

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

runtime.readinessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 60

תרשים: apigee-env

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

runtime.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-env

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

runtime.readinessProbe.successThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

runtime.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

runtime.release.strategy Advanced נוספה בגרסה: 1.16.8

ערך ברירת המחדל: rolling

תרשים: apigee-env

בוחרת את האסטרטגיה שמשמשת להשקת ReplicaSet חדש של סביבת זמן ריצה (מעבד בקשות) כששינוי בהגדרת הסביבה מפעיל גרסה. אפשר גם להגדיר את זה לכל סביבה באמצעות envs[].components.runtime.release.strategy.

ערכים מותרים:

  • ‫rolling (ברירת המחדל): יוצרת את ה-ReplicaSet החדש לצד הקיים ומעבירה אליו את התנועה בשלבים לפני שהיא מצמצמת אנכית בהתאם לעומס (scale down) את ה-ReplicaSet הישן. כך אפשר להעביר את התנועה בהדרגה, אבל באופן זמני נדרש נפח מחשוב נוסף (עד בערך פי שניים ממספר הפודים במצב יציב) במהלך ההשקה. מומלץ לרוב סביבות הייצור.
  • ‫scale-down-first: החלפת Pods אחד אחרי השני, על ידי ניקוז Pod קיים לפני יצירת Pod חלופי. מכיוון שכל החלפה היא אחד לאחד, הגרסה נשארת במסגרת מספר הפודים במצב יציב ולא נדרש מרווח נוסף לחישוב. האפשרות הזו מתאימה לאשכולות בלי התאמה אוטומטית לעומס של הצמתים, כמו התקנות עם מגבלות חומרה או התקנות על Bare Metal. הגרסאות מופצות לאט יותר ולא כוללות העברת תנועה הדרגתית.
  • ‫none: מעבר מיידי ל-ReplicaSet החדש בלי העברת תנועה בשלבים.
runtime.replicaCountMax בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 4

תרשים: apigee-env

המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

אם משתמשים במגבלות משופרות של שרתי proxy לכל סביבה, הן יחולו על כל קבוצות הרפליקות בסביבה. כל replicaset עדיין יתאים את הגודל באופן אוטומטי ובאופן עצמאי.

runtime.replicaCountMin בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.

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

runtime.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 4000m

תרשים: apigee-env

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

runtime.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 6Gi

תרשים: apigee-env

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi).

runtime.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 500m

תרשים: apigee-env

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

runtime.resources.requests.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 512Mi (ראו הערה בהמשך)

תרשים: apigee-env

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi).

runtime.service.type Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ClusterIP

תרשים: apigee-env

סוג השירות. אפשר להגדיר את זה לשירות אחר שהוא לא ClusterIP, לדוגמה LoadBalancer.

runtime.targetCPUUtilizationPercentage Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 75

תרשים: apigee-env

יעד ניצול המעבד (CPU) לתהליך זמן הריצה ב-pod. הערך של השדה הזה מאפשר לסביבת זמן הריצה לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.

runtime.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 3600

תרשים: apigee-env

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

runtime.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

runtime.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

runtime.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

runtime.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

runtime.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

runtime.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של runtime. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.runtime.topologySpreadConstraints.disableHostnameConstraint.

topologySpreadConstraints

runtime.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של runtime. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.runtime.topologySpreadConstraints.disableZoneConstraint.

topologySpreadConstraints

runtime.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של runtime. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.runtime.topologySpreadConstraints.enabled.

topologySpreadConstraints

runtime.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של runtime. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.runtime.topologySpreadConstraints.zoneKey.

topologySpreadConstraints

runtime.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפיזור של טופולוגיית האזור בפודים של runtime. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.runtime.topologySpreadConstraints.zoneRequiredForScheduling.

topologySpreadConstraints

securityContext

הגדרת אבטחה לפודים שאפשר להחיל ברמה הגלובלית, ברמת הסביבה או ברמת הרכיב.

מאפיין (property) סוג תיאור
securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-operator

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

synchronizer

מוודא שמעבדי הבקשות מעודכנים בחבילות ה-proxy ל-API האחרונות שנפרסו. כדי לעשות את זה, ה-Synchronizer דוגם את מישור הניהול. כשהוא מזהה חוזה חדש, הוא שולח אותו למישור זמן הריצה. כברירת מחדל, Synchronizer שומר את נתוני הגדרות הסביבה ב-Cassandra.

מידע נוסף זמין במאמר הגדרת הסנכרון.

בטבלה הבאה מתוארים המאפיינים של האובייקט synchronizer:

מאפיין (property) סוג תיאור
synchronizer.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

synchronizer.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

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

synchronizer.image.pullPolicy Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-env

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

synchronizer.image.tag Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-env

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

synchronizer.image.url Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

synchronizer.livenessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-env

מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.

synchronizer.livenessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 0

תרשים: apigee-env

מספר השניות אחרי הפעלת קונטיינר לפני שמתחילה בדיקת תקינות.

synchronizer.livenessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-env

ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.

synchronizer.livenessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

synchronizer.nodeSelector.key בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

חובה

מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של synchronizer.

ראו nodeSelector.

synchronizer.nodeSelector.value בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

ערך אופציונלי של תווית בורר הצמתים, שמשמש לטירגוט צומתי Kubernetes לשירותי זמן הריצה של synchronizer.

ראו nodeSelector.

synchronizer.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

המספר המינימלי של פודים של סנכרון שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%").

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.minAvailable.

לדוגמה, ב-overrides.yaml:

synchronizer:
  podDisruptionBudget:
    minAvailable: "50%"
synchronizer.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-env

המספר המקסימלי של pod של סנכרון שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.maxUnavailable.

לדוגמה, ב-overrides.yaml:

synchronizer:
  podDisruptionBudget:
    maxUnavailable: 1
synchronizer.pollInterval Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 60

תרשים: apigee-env

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

המאפיין הזה הוא ברירת המחדל לכל הסביבות. כדי להגדיר ערך שונה לסביבה אחת, משתמשים ב-envs[].components.synchronizer.pollInterval. ערך לכל סביבה מקבל קדימות על פני המאפיין הזה. אם מגדירים ערך קטן מ-60, הסנכרון משתמש ב-60.

synchronizer.readinessProbe.failureThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 2

תרשים: apigee-env

מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.

synchronizer.readinessProbe.initialDelaySeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 0

תרשים: apigee-env

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

synchronizer.readinessProbe.periodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 5

תרשים: apigee-env

קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.

synchronizer.readinessProbe.successThreshold Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.

synchronizer.readinessProbe.timeoutSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1

תרשים: apigee-env

מספר השניות שאחריהן פג הזמן הקצוב לבדיקת תקינות. הערך המינימלי הוא 1.

synchronizer.replicaCount בסיסי נוספה בגרסה: 1.0.0

תרשים: apigee-env

‫Deprecated: החל מגרסה 1.2 של Hybrid, אפשר לנהל את מספר הרפליקות של Synchronizer באמצעות: synchronizer.replicaCountMax ו-synchronizer.replicaCountMin

synchronizer.replicaCountMax בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 4

תרשים: apigee-env

מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling).

synchronizer.replicaCountMin בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: 1

תרשים: apigee-env

המספר המינימלי של רפליקות להתאמה אוטומטית לעומס.

synchronizer.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 2000m

תרשים: apigee-env

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

synchronizer.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 5Gi

תרשים: apigee-env

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

synchronizer.resources.requests.cpu Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 100m

תרשים: apigee-env

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

synchronizer.resources.requests.memory Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 1Gi

תרשים: apigee-env

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, בג'יגה-בייט.

synchronizer.serviceAccountPath בסיסי נוספה בגרסה: 1.0.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל Apigee Synchronizer.

synchronizer.serviceAccountRef בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

synchronizer.serviceAccountSecret בסיסי נוספה בגרסה: 1.1.0

ערך ברירת המחדל: ללא

תרשים: apigee-env

השם של סוד ב-Kubernetes. כדי ליצור את הסוד, צריך להשתמש במפתח של חשבון שירות ב-Google עם התפקיד מנהל Apigee Synchronizer כקלט.

synchronizer.targetCPUUtilizationPercentage Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 75

תרשים: apigee-env

ניצול יעד של המעבד (CPU) לתהליך הסנכרון ב-pod. הערך של השדה הזה מאפשר ל-Synchronizer לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.

synchronizer.terminationGracePeriodSeconds Advanced נוספה בגרסה: 1.0.0

ערך ברירת המחדל: 30

תרשים: apigee-env

משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-Pod יושבת באופן מיידי.

synchronizer.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

synchronizer.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

synchronizer.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-env

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

synchronizer.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

synchronizer.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-env

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

synchronizer.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של synchronizer. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.synchronizer.topologySpreadConstraints.disableHostnameConstraint.

topologySpreadConstraints

synchronizer.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של synchronizer. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.synchronizer.topologySpreadConstraints.disableZoneConstraint.

topologySpreadConstraints

synchronizer.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של synchronizer. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.synchronizer.topologySpreadConstraints.enabled.

topologySpreadConstraints

synchronizer.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של synchronizer. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.synchronizer.topologySpreadConstraints.zoneKey.

topologySpreadConstraints

synchronizer.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-env

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפריסה של טופולוגיית האזור בפודים של synchronizer. אפשר גם לשנות את ההגדרה הזו לסביבה ספציפית באמצעות envs[].components.synchronizer.topologySpreadConstraints.zoneRequiredForScheduling.

topologySpreadConstraints

topologySpreadConstraints

זמין ב-Apigee Hybrid מגרסה 1.17.4 ואילך.

האובייקט topologySpreadConstraints מגדיר את אילוצי הפריסה של טופולוגיית Pod ב-Kubernetes לרכיבי סביבת זמן הריצה של Apigee‏ (apigeeIngressGateway,‏ connectAgent,‏ ingressGateways,‏ istiod,‏ mart,‏ mcpServer,‏ redis,‏ redis.envoy,‏ runtime,‏ synchronizer ו-watcher). כשהאובייקט מופעל, המערכת ההיברידית מגדירה את Kubernetes כך שיפיץ Pods לרכיבי סביבת זמן הריצה באזורי זמינות ובצמתים (maxSkew: 1).

אפשר לשנות את ההגדרות ברמה העליונה של רכיבי זמן ריצה ספציפיים, כמו ב-runtime.topologySpreadConstraints או ב-mart.topologySpreadConstraints.

בטבלה הבאה מתוארים המאפיינים של האובייקט topologySpreadConstraints:

מאפיין (property) סוג תיאור
topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis, apigee-ingress-manager, apigee-org, apigee-env

מפעיל אילוצי פריסה של טופולוגיית pod של Kubernetes לרכיבי זמן ריצה של Apigee. כשהערך הוא true, המערכת של Apigee Hybrid מחילה שני אילוצי פריסה (עם maxSkew: 1) על Pods של רכיבי זמן ריצה: אחד על אזורי זמינות ואחד על צמתים (kubernetes.io/hostname).

בדוגמה הבאה מופעלים אילוצי פריסת טופולוגיה ב-overrides.yaml:

topologySpreadConstraints:
  enabled: true

ההגדרה הזו מקבילה להגדרה הבאה:

topologySpreadConstraints:
  enabled: true
  apigeeRuntime:
    disableHostnameConstraint: false
    disableZoneConstraint: false
    zoneKey: "topology.kubernetes.io/zone"
    zoneRequiredForScheduling: false

כשעוקפים את ההגדרות האלה לרכיב ספציפי (לדוגמה, runtime.topologySpreadConstraints), צריך להציב את המאפיינים ישירות מתחת ל-topologySpreadConstraints בלי apigeeRuntime:

runtime:
  topologySpreadConstraints:
    enabled: true
    disableHostnameConstraint: false
    disableZoneConstraint: false
    zoneKey: "topology.kubernetes.io/zone"
    zoneRequiredForScheduling: false
topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis, apigee-ingress-manager, apigee-org, apigee-env

כשהערך מוגדר כ-true, המערכת משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לרכיבי זמן הריצה של Apigee.

topologySpreadConstraints.apigeeRuntime.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis, apigee-ingress-manager, apigee-org, apigee-env

כשהערך הוא true, המדיניות משביתה את אילוץ הפריסה של טופולוגיית אזור הזמינות לרכיבי זמן הריצה של Apigee.

topologySpreadConstraints.apigeeRuntime.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-redis, apigee-ingress-manager, apigee-org, apigee-env

מציין את מפתח התווית של הצומת שמזהה את אזורי הזמינות של אילוץ פריסת הטופולוגיה.

topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-redis, apigee-ingress-manager, apigee-org, apigee-env

המדיניות קובעת את ההתנהגות של whenUnsatisfiable לאילוץ של פריסת הטופולוגיה באזורי זמינות. כשהמדיניות מוגדרת לערך false, המדיניות whenUnsatisfiable מוגדרת לערך ScheduleAnyway. כשהערך מוגדר כ-true, הערך של whenUnsatisfiable מוגדר כ-DoNotSchedule, והמתזמן של Kubernetes מקבל הוראה לא לתזמן פודים חדשים אם אי אפשר לעמוד באילוץ של אזור הזמינות. כשהאילוץ מופעל, הצומת (kubernetes.io/hostname) משתמש ב-ScheduleAnyway.

valkey

האובייקט valkey מגדיר את התרשים apigee-valkey, שיוצר את המשאב ApigeeValkey. ‫ApigeeValkey מחליף את ApigeeRedis, שאותו מגדיר האובייקט redis. בגרסה 1.17.3 נוסף האובייקט valkey. בגרסה 1.17.3, סביבת זמן הריצה ממשיכה להשתמש ב-ApigeeRedis. שדרוג Apigee Hybrid

בטבלה הבאה מתוארים המאפיינים של האובייקט valkey:

מאפיין (property) סוג תיאור
valkey.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

valkey.auth.password בסיסי נוספה בגרסה: 1.17.3

ערך ברירת המחדל: iloveapis123

תרשים: apigee-valkey

חובה

הסיסמה של האדמין ב-Valkey. ‫Apigee משתמשת במשתמש עם הרשאת אדמין לפעולות ניהול באשכול Valkey.

valkey.auth.secret בסיסי נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את הסיסמה של האדמין ב-Valkey. קובץ האובייקטים מסוג secret חייב להכיל את המפתח:

data:
    redis.auth.password: encoded_value

שם המפתח הוא redis.auth.password גם ל-ApigeeRedis וגם ל-ApigeeValkey.

מידע נוסף:

valkey.envoy.image.pullPolicy Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-valkey

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

valkey.envoy.image.tag Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: 1.17.4

תרשים: apigee-valkey

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

valkey.envoy.image.url Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

valkey.envoy.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

המספר המינימלי של פודים של Valkey Envoy שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

valkey:
  envoy:
    podDisruptionBudget:
      minAvailable: "50%"
valkey.envoy.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

המספר המקסימלי של פודים של Valkey Envoy שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

valkey:
  envoy:
    podDisruptionBudget:
      maxUnavailable: 1
valkey.image.pullPolicy Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-valkey

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

valkey.image.tag Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: 1.17.4

תרשים: apigee-valkey

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

valkey.image.url Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

valkey.replicaCount בסיסי נוספה בגרסה: 1.17.3

ערך ברירת המחדל: 2

תרשים: apigee-valkey

‫Valkey הוא אחסון משוכפל. המאפיין הזה מציין את מספר צומתי Valkey שנפרסו כ-StatefulSet.

valkey.resources.requests.cpu Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: 500m

תרשים: apigee-valkey

המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

valkey.tolerations.effect Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

valkey.tolerations.key Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

valkey.tolerations.operator Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: "Equal"

תרשים: apigee-valkey

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

valkey.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

valkey.tolerations.value Advanced נוספה בגרסה: 1.17.3

ערך ברירת המחדל: ללא

תרשים: apigee-valkey

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

virtualhosts

המאפיין virtualhosts הוא מאפיין הגדרה נדרש. מארחים וירטואליים מאפשרים ל-Apigee Hybrid לטפל בבקשות API לקבוצת סביבות מסוימת.

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

בטבלה הבאה מתוארים המאפיינים של האובייקט virtualhosts:

מאפיין (property) סוג תיאור
virtualhosts[].additionalGateways בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

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

virtualhosts[].cipherSuites[] Advanced נוספה בגרסה: 1.9.2

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

המאפיין הזה מגדיר את הצפנות ה-TLS שמשמשות בשער הכניסה.

הערכים של virtualhosts.cipherSuites צריכים להיות בפורמט OpenSSL.

בהמשך מופיעה רשימה של צפנים נתמכים בפורמט OpenSSL. מידע נוסף על הצפנים הנתמכים זמין במסמכי התיעוד של Boring FIPS build of Envoy. ערך ריק מוגדר כברירת מחדל לסט האלגוריתמים להצפנה שנתמכים על ידי גרסת Boring FIPS של Envoy.

TLS v1.3:

מופעל כברירת מחדל חבילות הצפנה נוספות
  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
אי אפשר לשנות את ה-ciphersuites של TLS 1.3
.

TLS v1.2:

מופעל כברירת מחדל חבילות הצפנה נוספות
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384
  • AES128-GCM-SHA256
  • AES128-SHA
  • AES256-GCM-SHA384
  • AES256-SHA
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-ECDSA-CHACHA20-POLY1305
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-SHA
  • ECDHE-RSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-SHA
  • ECDHE-RSA-CHACHA20-POLY1305

TLS v1.1:

מופעל כברירת מחדל חבילות הצפנה נוספות
‫TLS v1.1 לא מופעל כברירת מחדל.
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384
  • ECDHE-ECDSA-CHACHA20-POLY1305
  • ECDHE-RSA-CHACHA20-POLY1305
  • ECDHE-ECDSA-AES128-SHA
  • ECDHE-ECDSA-AES256-SHA
  • ECDHE-RSA-AES256-SHA

כדי להפעיל עוד חבילות צפנים, מוסיפים אותן למאפיין virtualhosts.cipherSuites יחד עם גרסת ה-TLS שרוצים להפעיל אותן עבורה במאפיין virtualhosts.minTLSProtocolVersion. לדוגמה, כדי להפעיל את כל חבילות ההצפנה המקובלות של TLS v.1.2, צריך להוסיף את הקוד הבא להגדרות של virtualhosts:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.2"
  cipherSuites:
  - "AES128-GCM-SHA256"
  - "AES128-SHA"
  - "AES256-GCM-SHA384"
  - "AES256-SHA"
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-SHA"
  - "ECDHE-RSA-CHACHA20-POLY1305"
...

אם רוצים להפעיל גרסאות ישנות יותר של TLS בפריסה של שער הכניסה של Apigee, משתמשים במאפיינים virtualhosts.minTLSProtocolVersion ו-virtualhosts.cipherSuites.

לדוגמה, כדי להפעיל את TLS v.1.1:

virtualhosts:
- name: ENV_GROUP_NAME
  minTLSProtocolVersion: "1.1"
  cipherSuites:
  - "ECDHE-ECDSA-AES128-GCM-SHA256"
  - "ECDHE-RSA-AES128-GCM-SHA256"
  - "ECDHE-ECDSA-AES256-GCM-SHA384"
  - "ECDHE-RSA-AES256-GCM-SHA384"
  - "ECDHE-ECDSA-CHACHA20-POLY1305"
  - "ECDHE-RSA-CHACHA20-POLY1305"
  - "ECDHE-ECDSA-AES128-SHA"
  - "ECDHE-RSA-AES128-SHA"
  - "ECDHE-ECDSA-AES256-SHA"
  - "ECDHE-RSA-AES256-SHA"
...
virtualhosts[].name בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

חובה

השם של המארח הווירטואלי.

virtualhosts[].maxTLSProtocolVersion בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הגרסה המקסימלית של פרוטוקול TLS ש-Envoy יכול לבחור. ‫Envoy משתמש באופן אוטומטי בגרסה האופטימלית של פרוטוקול TLS בין virtualhosts[].minTLSProtocolVersion ל-virtualhosts[].maxTLSProtocolVersion.

הערך חייב להיות מחרוזת שמייצגת את מספר הגרסה של TLS. לדוגמה:

virtualhosts:
- name: default
  maxTLSProtocolVersion: "1.3"

כאשר המחרוזת מייצגת את מספר הגרסה של TLS בפורמט "#.#". בדוגמה שלמעלה, "1.3" מייצג את גרסת Istio TLS‏ TLSV1_3.

אפשר גם לקרוא את המאמר ServerTLSSettings במסמכי התיעוד של Istio.

virtualhosts[].mcpMtls Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הפעלת Mutual TLS ‏(mTLS) בחיבור ממישור הנתונים של ה-MCP באשכול אל שער הכניסה של Apigee לקבוצת הסביבות הזו. כשהבלוק הזה קיים, מישור הנתונים של MCP מציג אישור לקוח לשער הכניסה ומאמת את האישור של שער הכניסה. כשהוא לא קיים, מישור הנתונים של MCP מתחבר לשער הכניסה דרך TLS חד-כיווני, כמו בגרסאות קודמות.

נדרש virtualhosts[].tlsMode: MUTUAL באותו רכיב (ראו הגדרת TLS ו-mTLS בשער הכניסה). התרשים דוחה את mcpMtls ברשומה שבה tlsMode הוא לא MUTUAL, כי שער כניסה שלא נמצא במצב MUTUAL אף פעם לא מבקש אישור לקוח.

צריך לספק את אישור הלקוח באחת משתי דרכים, אף פעם לא בשתיהן:

  • ‫sslCertPath, sslKeyPath ו-caCertPath: קבצים במכונה שבה פועל helm. התרשים יוצר את הסודות לגיבוי באופן אוטומטי.
  • ‫sslSecret: השם של סוד Kubernetes שאתם יוצרים במרחב השמות של Apigee עם המפתחות cert ו-key. רשות האישורים שחתמה על האישור של שער הכניסה נכנסת ל-Secret שני בשם MCP_CLIENT_SECRET_NAME-cacert עם המפתח cacert. הסיומת היא מוסכמה למתן שמות, ולא שדה שניתן להגדרה.

לדוגמה:

virtualhosts:
- name: ENV_GROUP_NAME
  tlsMode: MUTUAL
  sslSecret: INGRESS_SECRET_NAME
  mcpMtls:
    sslSecret: MCP_CLIENT_SECRET_NAME

ההליך מפורט במאמר הגדרת mTLS בין מישור הנתונים של MCP לבין שער הכניסה.

virtualhosts[].mcpMtls.caCertPath Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הנתיב, ביחס לספריית התרשים של apigee-virtualhost, לקובץ PEM שמכיל את אישור ה-CA (או השרשרת) שחתם על אישור ה-TLS של שער הכניסה. מישור הנתונים של MCP מאמת את האישור של שער הכניסה.

נדרש כשמשתמשים ב-mcpMtls.sslCertPath וב-mcpMtls.sslKeyPath, אלא אם mcpMtls.disableChainValidation הוא true, ובמקרה כזה התרשים דוחה אותו כי לא ייעשה בו שימוש. אין לשלב עם mcpMtls.sslSecret.

virtualhosts[].mcpMtls.disableChainValidation Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-virtualhost

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

כשמגדירים את true, לא צריך לציין את caCertPath ולא צריך להגדיר את disableSanValidation: false באופן מפורש. התרשים דוחה את שני השילובים.

virtualhosts[].mcpMtls.disableSanValidation Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-virtualhost

כש-false, מישור הנתונים של MCP בודק גם שבאישור של שער הכניסה מופיע הכינוי של המארח שנקרא בשמות החלופיים של הבעלים (SAN). צריך להגדיר את הערך true רק אם האישור של שער הכניסה לא מכסה את הכינויים של המארחים בקבוצת הסביבות.

ההגדרה חלה רק כשאימות השרשרת מופעל. אם הערך של disableChainValidation הוא true, צריך להשאיר את השדה הזה ריק.

virtualhosts[].mcpMtls.sslCertPath Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הנתיב, ביחס לספריית התרשים של apigee-virtualhost, לקובץ PEM שמכיל את אישור הלקוח שמישור הנתונים של MCP מציג לשער הכניסה. האישור חייב לכלול את השימוש המורחב במפתח clientAuth, וחייב להיות חתום על ידי רשות אישורים (CA) ששער הכניסה סומך עליה (רשות האישורים בסוד INGRESS_SECRET_NAME-cacert או virtualhosts[].caCertPath לאותו רכיב).

צריך להגדיר אותו יחד עם mcpMtls.sslKeyPath. אין לשלב עם mcpMtls.sslSecret.

virtualhosts[].mcpMtls.sslKeyPath Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הנתיב, ביחס לספריית התרשים של apigee-virtualhost, לקובץ PEM שמכיל את המפתח הפרטי של mcpMtls.sslCertPath. צריך להגדיר אותו יחד עם mcpMtls.sslCertPath. אין לשלב עם mcpMtls.sslSecret.

virtualhosts[].mcpMtls.sslSecret Advanced נוספה בגרסה: 1.17.4

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

השם של סוד Kubernetes במרחב השמות של Apigee שמכיל את אישור הלקוח (מפתח cert) ואת המפתח הפרטי (מפתח key) שמישור הנתונים של MCP מציג לשער הכניסה. האישור חייב לכלול את השימוש המורחב במפתח clientAuth.

אם mcpMtls.disableChainValidation הוא לא true, צריך להיות גם סוד שני. השם שלו הוא השם של הסוד הזה בתוספת -cacert, והמפתח שלו הוא cacert. הוא מכיל את רשות האישורים (CA) שחתמה על האישור של שער הכניסה. ‫helm install ו-helm upgrade ייכשלו אם אחד מהסודות חסר או שאין לו מפתחות נתונים. הבדיקות האלה קוראות את האשכול, ולכן helm template מדלג עליהן.

אל תשלבו אותם עם mcpMtls.sslCertPath, mcpMtls.sslKeyPath או mcpMtls.caCertPath.

כשמחליפים את האישור בסודות האלה, מישור הנתונים של MCP מקבל את החומר החדש באופן אוטומטי, בלי להפעיל מחדש את ה-Pod או את helm upgrade.

virtualhosts[].minTLSProtocolVersion בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

הגרסה המינימלית של פרוטוקול TLS ש-Envoy יכול לבחור. ‫Envoy משתמש באופן אוטומטי בגרסה האופטימלית של פרוטוקול TLS בין virtualhosts[].minTLSProtocolVersion ל-virtualhosts[].maxTLSProtocolVersion.

הערך חייב להיות מחרוזת שמייצגת את מספר הגרסה של TLS. לדוגמה:

virtualhosts:
- name: default
  minTLSProtocolVersion: "1.2"

כאשר המחרוזת מייצגת את מספר הגרסה של TLS בפורמט "#.#". בדוגמה שלמעלה, "1.2" מייצג את גרסת Istio TLS‏ TLSV1_2.

אפשר גם לקרוא את המאמר ServerTLSSettings במסמכי התיעוד של Istio.

virtualhosts[].requestTimeout בסיסי נוספה בגרסה: 1.10.0

ערך ברירת המחדל: 300

תרשים: apigee-virtualhost

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

virtualhosts[].selector בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: app: apigee-ingressgateway

תרשים: apigee-virtualhost

חובה

צמד מפתח/ערך של סלקטור/ערך להפניה לסלקטורים שונים של Ingress.

  • ‫apigee-ingressgateway: להתקנות של Apigee Hybrid באמצעות שער הכניסה של Apigee.
  • ‫istio-ingressgateway: להתקנות של Apigee Hybrid באמצעות Cloud Service Mesh (גרסאות Apigee Hybrid 1.8‎ וגרסאות קודמות).

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

virtualhosts[].sslCertPath בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

הנתיב במערכת לקובץ של אישור TLS.

virtualhosts[].sslKeyPath בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

הנתיב במערכת לקובץ המפתח הפרטי של TLS.

virtualhosts[].sslSecret בסיסי נוספה בגרסה: 1.2.0

ערך ברירת המחדל: ללא

תרשים: apigee-virtualhost

צריך לציין את sslCertPath/sslKeyPath או את sslSecret.

שם הקובץ שמאוחסן בסוד של Kubernetes שמכיל את המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד.

מידע נוסף:

watcher

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

בטבלה הבאה מתוארים המאפיינים של האובייקט watcher:

מאפיין (property) סוג תיאור
watcher.securityContext.seccompProfile.type Advanced

נוספה בגרסה: 1.16.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-Pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל.

הגדרת פרופילי Seccomp לאבטחת Pod

watcher.annotations Advanced נוספה בגרסה: 1.5.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.

watcher.args.enableIssueScanning Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: true

תרשים: apigee-org

הפעלה או השבתה של הצגת בעיות אוטומטית. כשמפעילים את true, Watcher סורק באופן אוטומטי את מישור הבקרה ואת מצב שרת ה-API של Kubernetes כדי לבדוק אם יש בעיות בהגדרות.

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

watcher.args.enableLeaderElect Advanced נוספה בגרסה: 1.13.0

ערך ברירת המחדל: true

תרשים: apigee-org

כשהערך הוא true (ברירת המחדל), watcher.args.enableLeaderElect בוחר pod אחד של watcher כדי לנהל את פרטי הניתוב ולדווח עליהם. כדי למנוע זמן השבתה במהלך שדרוגים או חזרה לגרסה קודמת, צריך להגביל את זה ל-pod אחד. במהלך האירועים האלה, יכול להיות שכמה גרסאות של watcher יפעלו בו-זמנית. לכל מופע של Watcher יכול להיות לוגיקה שונה ליצירת נתיבים, מה שעלול לגרום לזמן השבתה.watcher.replicaCountMax.

watcher.args.issueScanInterval Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: 60

תרשים: apigee-org

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

watcher.gsa Advanced נוספה בגרסה: 1.10.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

Helm בלבד: כתובת האימייל של חשבון השירות של apigee-watcher Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true.

כתובות האימייל של GSA בדרך כלל נראות כך:

GSA_NAME@PROJECT_ID.iam.gserviceaccount.com

לדוגמה:

apigee-watcher@my-hybrid-project.iam.gserviceaccount.com

אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.

watcher.image.pullPolicy Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: IfNotPresent

תרשים: apigee-org

קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים.

מידע נוסף זמין במאמר עדכון תמונות.

watcher.image.tag Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: 1.17.4

תרשים: apigee-org

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

watcher.image.url Advanced נוספה בגרסה: 1.4.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list.

watcher.podDisruptionBudget.minAvailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המינימלי של פודים של צופים שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods (0) או מחרוזת של אחוזים ("50%"). מכיוון ש-Apigee Hybrid מריץ Pod אחד של Watcher (watcher.replicaCountMax: 1), הגדרת minAvailable ל-1 או לאחוז שאינו אפס מונעת פינוי Pods מרצון במהלך ניקוז צמתים.

minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

watcher:
  podDisruptionBudget:
    minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable Advanced

נוספה בגרסה: 1.17.2

ערך ברירת המחדל: ללא

תרשים: apigee-org

המספר המקסימלי של פודים של צופים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי מפעיל Apigee. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל.

לדוגמה, ב-overrides.yaml:

watcher:
  podDisruptionBudget:
    maxUnavailable: 1
watcher.replicaCountMax בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: 1

תרשים: apigee-org

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

ב-Apigee Hybrid נעשה שימוש ב-watcher pod אחד לכל התקנה. בבחירת Leader, המערכת בוחרת באופן אוטומטי pod אחד של watcher. עותקים נוספים של pod של watcher ייאלצו לעבור למצב לא יציב. מידע נוסף זמין במאמר watcher.args.enableLeaderElect.

watcher.replicaCountMin בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: 1

תרשים: apigee-org

המספר המינימלי של רפליקות של צופים.

watcher.resources.limits.cpu Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 1000m

תרשים: apigee-org

מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.

watcher.resources.limits.memory Advanced נוספה בגרסה: 1.11.0

ערך ברירת המחדל: 2Gi

תרשים: apigee-org

מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.

watcher.serviceAccountPath בסיסי נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

חובה.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד סוכן זמן הריצה של Apigee.

watcher.serviceAccountRef Advanced נוסף בגרסה: 1.3.0

ערך ברירת המחדל: ללא

תרשים: apigee-org

צריך לציין את serviceAccountPath או את serviceAccountRef.

הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes

watcher.tolerations.effect Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

לפרטים נוספים, ראו Taints and Tolerations: Concepts.

watcher.tolerations.key Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

watcher.tolerations.operator Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: "Equal"

תרשים: apigee-org

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות:

  • ‫Equal תואם לערך שמוגדר ב-value.
  • המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

watcher.tolerations.tolerationSeconds Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

watcher.tolerations.value Advanced נוספה בגרסה: 1.10.1

ערך ברירת המחדל: ללא

תרשים: apigee-org

משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes.

‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal.

לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

watcher.topologySpreadConstraints.disableHostnameConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableHostnameConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של הצומת (kubernetes.io/hostname) לפודים של watcher.

topologySpreadConstraints

watcher.topologySpreadConstraints.disableZoneConstraint Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.disableZoneConstraint . כשהערך הוא true, המדיניות משביתה את אילוץ פריסת הטופולוגיה של אזור הזמינות לפודים של watcher.

topologySpreadConstraints

watcher.topologySpreadConstraints.enabled Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.enabled . הפעלה או השבתה של אילוצי פריסת טופולוגיה של Kubernetes לפודים של watcher.

topologySpreadConstraints

watcher.topologySpreadConstraints.zoneKey Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: topology.kubernetes.io/zone

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneKey . מציין את מפתח התווית של הצומת שמשמש לזיהוי אזורי הזמינות של pod של watcher.

topologySpreadConstraints

watcher.topologySpreadConstraints.zoneRequiredForScheduling Advanced

נוספה בגרסה: 1.17.4

ערך ברירת המחדל: false

תרשים: apigee-org

שינוי אופציונלי של ההגדרה topologySpreadConstraints.apigeeRuntime.zoneRequiredForScheduling . כשהערך הוא true, המדיניות whenUnsatisfiable מוגדרת ל-DoNotSchedule עבור אילוץ הפיזור של טופולוגיית האזור בפודים של watcher.

topologySpreadConstraints