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

Version 1.17 (latest)

   גרסאות נתמכות:

• v1.16 (הגרסה העדכנית)                        
• v1.15                         
• v1.14                        
• רשימת הגרסאות הנתמכות

   גרסאות שלא נתמכות:

• v1.13                         
• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

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

הערה: במאמר הערות בהתאמה אישית מוסבר איך מוסיפים הערות בהתאמה אישית, שהן מפות של מפתחות/ערכים שמשמשות לצירוף מטא-נתונים לקבוצות Pod של Kubernetes ב-Apigee Hybrid.

מידע על מאפייני הגדרות אישיות

אם צריך, אפשר לשנות הרבה מאפייני הגדרות אישיות על ידי הוספה שלהם ל-HYBRID_ROOT_DIR/overrides.yaml.

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

לדוגמה, כדי לשנות את מספר הרפליקות המינימלי והמקסימלי של שירות MART, אפשר להוסיף את הבית הזה ל-overrides.yaml:

mart:
    replicaCountMin: 3
    replicaCountMax: 6

אפשר גם למצוא את מאפייני ההגדרות האלה ואת הגדרות ברירת המחדל שלהם בקובץ HYBRID_ROOT_INSTALL/1.0.0/values.yaml

מידע נוסף זמין במאמר Manage runtime plane components.

בנוסף, אם אתם מגדירים פריסה מחוץ ל- Google Cloud , עיינו ב שלב 7: יצירת ההגדרות להחלפה כדי לקבל מידע על הגדרת המאפיינים האלה.

סינון הדף הזה

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

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

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

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

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

מאפיין (property)	סוג	תיאור
axHashSalt	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: iloveapis123 תרשים: apigee-org אופציונלי השם של סוד Kubernetes שמכיל ערך גיבוב (salt) שמשמש לחישוב גיבובים כדי לטשטש נתוני משתמשים לפני שהם נשלחים לניתוח ב-Apigee. אם לא מציינים ערך salt, המערכת משתמשת ב-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 הפעלת התאמה אוטומטית לעומס (automatic scaling) מבוססת-מדדים של Apigee כשהערך מוגדר ל-true (ברירת המחדל). מגדירים את הערך false כדי להשבית את ההתאמה האישית של הגודל. כדי להחיל שינויים על customAutoscaling.enabled, צריך לעדכן את התרשים של apigee-telemetry.
enhanceProxyLimits	Advanced	נוספה בגרסה: 1.14.0 ערך ברירת המחדל: false תרשים: apigee-org, apigee-virtualhost חובה ההרשאה enhanceProxyLimits נדרשת לתכונה "מגבלות משופרות לשרתי proxy לכל סביבה" של Apigee. צריך להגדיר את האפשרות הזו ל-enhanceProxyLimits: true אם הארגון ההיברידי שלך זכאי למגבלות משופרות של שרתי proxy לכל סביבה. הערה: התכונה הזו זמינה כחלק מתוכנית המינויים של 2024. אפשר לעיין במאמרים הבאים: מגבלות על שרתי proxy ל-API מגבלות משופרות על שרתי proxy לכל סביבה. הרשאות מינוי. ההגדרה enhanceProxyLimits: true נדרשת לשרשור שרתי proxy, לשרשור נקודות קצה ולשרשור ServiceCallout. למידע נוסף: שרשור של שרתי proxy ל-API מדיניות ServiceCallout התראה: אל תגדירו את הערך הזה ל-false אחרי שהגדרתם אותו ל-true. מחילים את השינויים על 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.3 imagePullPolicy: IfNotPresent הערה: בגרסאות של Apigee Hybrid שקדמו ל-1.14.2, לרכיבים של צד שלישי היה מזהה ייחודי לגרסת קובץ האימג' של הספק החיצוני. לדוגמה: ## an example of internal component vs 3rd party containers: - name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.17.3 imagePullPolicy: IfNotPresent containers: - name: apigee-ingressgateway image: private-docker-host.example.com/apigee-asm-ingress:1.22.6-asm.2-distroless imagePullPolicy: IfNotPresent הרכיבים האחרים יפעלו לפי דפוס דומה. אפשר להשתמש ב-apigee-pull-push --list כדי לראות את כתובת ה-URL של המאגר הנוכחי לכל הרכיבים. מידע נוסף זמין במאמר שימוש במאגר אימג'ים פרטי עם Apigee Hybrid. אפשר לשנות את כתובת ה-URL של התמונה ברכיבים ספציפיים באמצעות המאפיינים הבאים: ao.image.url apigeeIngressGateway.image.url cassandra.image.url cassandra.auth.image.url cassandra.backup.image.url cassandra.restore.image.url connectAgent.image.url guardrails.image.url ingressGateways[].image.url istiod.image.url kubeRBACProxy.image.url logger.image.url mart.image.url mcpServer.image.url mcpServer.sidecar.image.url metrics.adapter.image.url metrics.prometheus.image.url metrics.sdSidecar.image.url mintTaskScheduler.image.url redis.image.url redis.envoy.image.url runtime.image.url synchronizer.image.url udca.image.url udca.fluentd.image.url watcher.image.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 תווים. אפשר ליצור כמה ארגונים באותו אשכול, אבל הערך של instanceID חייב להיות זהה בכל הארגונים באותו אשכול Kubernetes. בהתקנות במספר אזורים, לכל אזור נדרש אשכול משלו (אשכולות נפרדים לא משתרעים על פני אזורים).
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 ערך ברירת המחדל: "1173" (גרסת 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 יכול לקבל רק אותיות קטנות, מספרים וסימני פיסוק. כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) של כל הרכיבים שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision: nodeSelector envs imagePullSecrets gcpProjectID k8sClusterName contractProvider org מידע נוסף זמין במאמר עדכונים בהדרגה (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. הערה: tolerations ברמה העליונה הוא ברירת מחדל גלובלית, ולא ברירת מחדל מצטברת. הוא חל על רכיב רק אם המאפיין tolerations של הרכיב עצמו לא מוגדר. הגדרת tolerations ברמת הרכיב מחליפה את הערך ברמה העליונה, במקום להתמזג איתו. 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 שנדרשים כדי לפרוס ולתחזק רכיב. לדוגמה, הבקר מבצע את ההשקה של מעבדי הבקשות.

הערה: בגרסה 1.2.0, ‏ Apigee Operators מחליף את Apigee Deployment Admissionhook‏ (ADAH) ואת Apigee Deployment Controller‏ (ADC).

בטבלה הבאה מתוארים המאפיינים של האובייקט 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.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.3 תרשים: apigee-operator, apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
ao.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-operator, apigee-ingress-manager המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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, ב-mebibyte.
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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
apigeeIngressGateway.image.url	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: apigee-org מספר הפודים המינימלי של שער הכניסה של 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.0 ערך ברירת המחדל: ללא תרשים: 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 מספר ה-pods המקסימלי שההיברידי יכול להוסיף באופן אוטומטי לשער הכניסה שזמין להתאמה אוטומטית לעומס.
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) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר הפודים ב-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.

cassandra

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

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

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

הערה: המאפיין ‎ #cassandra-storage-capacity הוצא משימוש החל מגרסה 1.12.0.במקומו צריך להשתמש ב-cassandra.storage.storageSize.

מאפיין (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.3 תרשים: apigee-datastore, apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.auth.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore, apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
cassandra.auth.secretProviderClass	Advanced	נוסף בגרסה: 1.10.3 ערך ברירת המחדל: ללא תרשים: apigee-datastore, apigee-operator מדיניות האחסון הסודית של Cassandra. אם מגדירים את השדה, הוא צריך להתאים ל-SecretProviderClass שמפנה לספק הסודות החיצוני, כמו Hashicorp Vault. אם לא מגדירים את המאפיין, Apigee hybrid משתמש בשמות המשתמשים ובסיסמאות שמאוחסנים באחד מהמקומות הבאים: cassandra.auth.admin.password cassandra.auth.ddl.password cassandra.auth.default.password cassandra.auth.dml.password cassandra.auth.jmx.password cassandra.auth.jmx.username cassandra.auth.jolokia.password cassandra.auth.jolokia.username או הסוד של Kubernetes שמאוחסן ב: cassandra.auth.secret במאמר אחסון סודות של 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 שתשמש לאחסון ארכיוני הגיבוי. אם אתם צריכים ליצור קטגוריה, תוכלו להיעזר במאמר יצירת קטגוריות. הערה: החל מגרסה 1.13 של Hybrid, לא צריך להוסיף את הקידומת gs:// לשם הקטגוריה. התמיכה בקידומת הזו הוצאה משימוש ותוסר בגרסאות עתידיות.
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" איך מפעילים את איחוד שירותי אימות הזהות של עומסי עבודה ב-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.3 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.backup.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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 עם התפקיד אדמין של אובייקטים ב-Storage (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להעלאת ארכיוני גיבוי אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider מוגדר כ-GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להעלות ארכיוני גיבוי: הערך שצוין: cassandra.backup.serviceAccountPath. הערך שצוין: cassandra.backup.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
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.serviceAccountPath. הערך שצוין: cassandra.backup.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.backup.storageDirectory	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID. יכול להיות נתיב מוחלט או נתיב יחסי לספריית הבית של המשתמש ב-apigee. השם של ספריית הגיבוי בשרת ה-SSH לגיבוי.
cassandra.clusterName	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigeecluster תרשים: apigee-datastore מציין את השם של אשכול Cassandra. הערה: בהתקנות במספר אזורים, הערך של clusterName צריך להיות זהה בכל האזורים.
cassandra.datacenter	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: dc-1 תרשים: apigee-datastore מציין את מרכז הנתונים של צומת Cassandra.
cassandra.dnsPolicy	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא תרשים: apigee-datastore הערה: ב-Apigee hybrid v1.3, המאפיין הזה כבר לא נתמך. כשמגדירים את 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 משתמשת בתכונה הזו בהתקנות במספר אזורים כדי לתקשר בין פודים אם למרחב השמות של רשת הפודים אין קישוריות בין אשכולות (האשכולות פועלים ב-"island network mode"), שזה המצב שמוגדר כברירת מחדל בהתקנות שהן לא GKE, כולל Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. מגדירים את cassandra.hostNetwork לערך false בהתקנות באזור יחיד ובהתקנות במספר אזורים עם קישוריות בין Pods באשכולות שונים, למשל התקנות של GKE. מגדירים את cassandra.hostNetwork לערך true בהתקנות במספר אזורים שאין בהן תקשורת בין Pods באשכולות שונים, למשל התקנות של 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.3 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore המספר המינימלי של פודים של Cassandra שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: cassandra: podDisruptionBudget: minAvailable: "50%"
cassandra.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore המספר המקסימלי של פודים של Cassandra שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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.storage.storageSize תקין (לדוגמה, 10Gi) במצב של מאגר נתונים חיצוני, גם עם replicaCount: 0. ה-validating webhook של ApigeeDatastore תמיד מאמת את storageSize, למרות שהאופרטור לא יוצר PersistentVolume כש-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. הערה: ערך ברירת המחדל של 1 מתאים רק להתקנות של הדגמה או בדיקה. בהתקנות בסביבת ייצור, הערך של replicaCount חייב להיות כפולה של 3. כדי לקבוע את הערך הרצוי של replicaCount, צריך להביא בחשבון את הדברים הבאים: מעריכים את נפח התנועה הנדרש לשרתי ה-Proxy. מבצעים בדיקת עומסים ומבצעים חיזויים סבירים של ניצול המעבד (CPU). אפשר לציין ערכים שונים של replicaCount באזורים שונים. אפשר להרחיב את replicaCount בעתיד בקובץ השינויים.
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, ב-mebibyte.
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 שבה מאוחסנים קובצי הגיבוי שמשמשים לשחזור הנתונים. הערה: החל מגרסה 1.13 של Hybrid, לא צריך להוסיף את הקידומת gs:// לשם הקטגוריה. התמיכה בקידומת הזו הוצאה משימוש ותוסר בגרסאות עתידיות.
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 לשחזור ב-Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.restore.enabled לערך true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" איך מפעילים את Workload Identity ב-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.3 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.restore.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
cassandra.restore.serviceAccountPath	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-datastore הנתיב לקובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים ב-Storage (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין. אם השחזור מופעל והערך של cassandra.restore.cloudProvider הוא GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להוריד את קובצי הגיבוי לשחזור: הערך שצוין: cassandra.restore.serviceAccountPath. הערך שצוין: cassandra.restore.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
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.serviceAccountPath. הערך שצוין: cassandra.restore.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
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 לאבטחת פודים
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. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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 לאבטחת פודים
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 לאבטחת פודים
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. הערה: connectAgent משתמש בחשבון השירות apigee-mart. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
connectAgent.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
connectAgent.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של Pods של סוכן חיבורים ב-Apigee שצריכים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של Pods של סוכני Apigee Connect שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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, ב-mebibyte.
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 לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
connectAgent.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 600 תרשים: apigee-org משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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 משמש את התכונה "דחיות וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. למידע נוסף, קראו את המאמר Taints and Tolerations: Concepts.

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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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). חשוב: אם מגדירים את המאפיין הזה לסביבה הזו, Apigee לא משתמש בערכים של: runtime.resources.limits.memory runtime.resources.requests.memory אם מגדירים את המאפיין הזה, צריך להגדיר גם את envs[].components.runtime.resources.requests.memory לסביבה הזו. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB בסביבה הזו, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את envs[].components.runtime.resources.limits.memory ל-‎6Gi. מגדילים את envs[].components.runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
envs[].components.runtime.resources.requests.memory	Advanced	הושק בגרסה: 1.15.0 ערך ברירת המחדל: ללא תרשים: apigee-env הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). חשוב: אם מגדירים את המאפיין הזה לסביבה הזו, Apigee לא משתמש בערכים של: runtime.resources.limits.memory runtime.resources.requests.memory אם מגדירים את המאפיין הזה, צריך להגדיר גם את envs[].components.runtime.resources.limits.memory לסביבה הזו. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB בסביבה הזו, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את envs[].components.runtime.resources.limits.memory ל-‎6Gi. מגדילים את envs[].components.runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
envs[].components.synchronizer.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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.replicaCountMax	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 4 תרשים: apigee-env מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). המדיניות הזו מבטלת את המדיניות synchronizer.replicaCountMax אם היא מוגדרת.
envs[].components.synchronizer.replicaCountMin	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 1 תרשים: apigee-env המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. המדיניות הזו מבטלת את המדיניות synchronizer.replicaCountMin אם היא מוגדרת.
envs[].gsa.runtime	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא תרשים: apigee-env Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM בסביבת זמן הריצה, שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
envs[].gsa.synchronizer	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא תרשים: apigee-env Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM לסנכרון, שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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 ל-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 לאבטחת פודים
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 Synchronizer Manager כקלט.

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 שצריך לטעון לקבוצות Pod היברידיות כש-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 השיטה שמשמשת לקבלת אסימונים של איחוד שירותי אימות הזהות של עומסי עבודה. הערכים הנתמכים הם: ‫kubernetes: שימוש ב-Kubernetes Projected Service Account Tokens. הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS sidecar: שימוש בקונטיינר משני (sidecar) כדי לאחזר אסימונים מספק זהויות. איך משתמשים באימות sidecar לאיחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS
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 connectAgent.gsa envs.gsa.runtime envs.gsa.synchronizer envs.gsa.udca logger.gsa mart.gsa mcpServer.gsa metrics.gsa mintTaskScheduler.gsa udca.gsa watcher.gsa
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Enabling Workload Identity on GKE.

guardrails

מזהה את חשבון השירות של Google‏ (GSA) ואת קובץ המפתח שמשמש את שירות Apigee Guardrails. שירות Apigee Guardrails מאפשר לפוד של מעקות הבטיחות בתרשים apigee-operator לבדוק אם ממשקי ה-API הנדרשים מופעלים בפרויקט כדי להתקין בהצלחה את 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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
guardrails.image.url	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
guardrails.gsa	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-operator כתובת האימייל של חשבון השירות (GSA) ב-apigee-guardrails Google IAM שצריך לשייך לחשבון השירות התואם ב-Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.

הערה: אתם יכולים גם להגדיר העברה של שרת proxy ל-HTTP ברמת הסביבה לשרתי proxy ל-API. איך מגדירים העברה לשרת proxy ל-proxies ל-API

ראו גם: 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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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 מספר ה-pods המקסימלי שההיברידי יכול להוסיף באופן אוטומטי לשער הכניסה שזמין להתאמה אוטומטית לעומס.
ingressGateways[].replicaCountMin	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 2 תרשים: apigee-org המספר המינימלי של Pods לשער הכניסה שזמינים להתאמה אוטומטית לעומס.
ingressGateways[].resources.limits.cpu	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 2000m תרשים: apigee-org מגבלת המעבד (CPU) של המשאב, באלפיות ליבה.
ingressGateways[].resources.limits.memory	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 1Gi תרשים: apigee-org מגבלת הזיכרון של המשאב, ב-mebibyte.
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 לאבטחת פודים
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) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר הפודים ב-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.

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. הערה: השימוש במאפיין ההגדרה הזה נתמך רק בהתקנות היברידיות באמצעות תרשימי Helm. אין תמיכה בשימוש בו עם apigeectl. כדי לשנות את סוכני המשתמש שצוינו כברירת מחדל, משתמשים בתחביר הבא ומזינים את סוכני המשתמש בהתאמה אישית: istiod: healthCheckUserAgents: - "CUSTOM_USER_AGENT_1" - "CUSTOM_USER_AGENT_2" כדי להסיר את הדרישה לסוכן משתמש, משתמשים בקוד הבא: istiod: healthCheckUserAgents: [] הערה: כדי שהשינוי ייכנס לתוקף, צריך להפעיל מחדש את ה-pods. משתמשים ב-kubectl rollout restart deployment -n apigee apigee-ingressgateway-manager כדי להפעיל מחדש את ה-pods וב-kubectl rollout status deployment -n apigee apigee-ingressgateway-manager כדי לבדוק את סטטוס ההשקה.
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.3 תרשים: apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
istiod.image.url	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: ללא תרשים: apigee-ingress-manager המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.

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 צריכה לחפש אמצעי בקרת גישה מבוססי-תפקיד של 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.3 תרשים: apigee-operator, apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
kubeRBACProxy.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-operator, apigee-ingress-manager המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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, ב-mebibyte.

logger

מגדיר את השירות שמנהל את יומני הפעילות. כל השירותים של Apigee hybrid שפועלים באשכול Kubernetes שלכם פולטים את המידע הזה.

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

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

מאפיין (property)	סוג	תיאור
logger.securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים
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
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
logger.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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, ב-mebibyte.
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. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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 לנתוני RunTime), שפועל כספק 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 לאבטחת פודים
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-org, apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mart.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-org, apigee-env המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של MART שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: minAvailable: "50%"
mart.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של MART שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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, ב-mebibyte.
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 כקלט. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
mart.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 75 תרשים: apigee-org ניצול יעד של המעבד (CPU) לתהליך MART ב-pod. הערך של השדה הזה מאפשר ל-MART לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
mart.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 30 תרשים: apigee-org משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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.

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 באשכול ומגדיר את הפודים של סביבת זמן הריצה של Apigee לנתב אליו קריאות API לכלי MCP. כאשר false, התרשים מתעלם מכל המאפיינים של mcpServer. לדוגמה, ברמה העליונה של overrides.yaml, באותה רמה כמו instanceID ו-org: instanceID: "INSTANCE_ID" org: ORGANIZATION_NAME enableMcpServer: true זהירות: שינוי הערך הזה מפעיל גרסה איטרטיבית לקהל מצומצם (canary release) של Pods בסביבת זמן הריצה של Apigee. צריך לשנות אותו רק בחלון זמן לתחזוקה, ולהמתין עד שהגרסה תסתיים לפני שממשיכים. איך מפעילים את 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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker של קונטיינר מישור הנתונים של MCP.
mcpServer.image.url	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker לקונטיינר של מישור הנתונים של MCP‏ (apigee-envoy-dataplane). כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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 שזמינות להתאמה אוטומטית לעומס (scaling). אם ה-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 לאבטחת פודים
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 ל-sidecar של ה-MCP. משתמשים במאפיין הזה רק אם מנהלים את הסודות של מפתחות חשבונות השירות מחוץ לתרשימי 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.3 תרשים: 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. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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 מגבלת הזיכרון של קונטיינר ה-MCP המשני (sidecar), במיבי-בייט.
mcpServer.sidecar.resources.requests.cpu	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: 200m תרשים: apigee-org המעבד (CPU) שנדרש לפעולה רגילה של הקונטיינר המשני (sidecar) של MCP, ב-millicores.
mcpServer.sidecar.resources.requests.memory	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: 128Mi תרשים: apigee-org הזיכרון שנדרש לפעולה רגילה של קונטיינר משני (sidecar) של MCP, ב-mebibyte.
mcpServer.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: 70 תרשים: apigee-org יעד ניצול המעבד (CPU) של ה-MCP pods. כשהניצול של המעבד (CPU) מגיע לערך הזה, הכלי Horizontal Pod Autoscaler מוסיף פודים של MCP, עד mcpServer.replicaCountMax.
mcpServer.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: 30 תרשים: apigee-org משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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.

metrics

מגדיר את השירות שאוסף מדדי תפעול. אתם יכולים להשתמש בנתוני המדדים כדי לעקוב אחרי התקינות של שירותי Hybrid, להגדיר התראות ועוד.

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

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

מאפיין (property)	סוג	תיאור
metrics.securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים
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.3 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.adapter.image.url	Advanced	נוספה בגרסה: 1.8.1 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.adapter.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים של מתאם מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של מתאם מדדים שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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, באלפיות ליבה.
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, ב-mebibytes.
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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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.3 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.collector.image.url	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.collector.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים לאיסוף מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שה-collector פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מה-pods של ה-collector (מעוגל כלפי מטה) במקום להשתמש ב-maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של pod לאיסוף מדדים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שה-collector פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מה-pods של ה-collector (מעוגל כלפי מטה) במקום להשתמש ב-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, ב-mebibytes.
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.prometheus.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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, ב-mebibyte.
metrics.prometheus.sslCertPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry חובה הנתיב לאישור ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים. אפשר לעיין במאמרים הבאים: מדדים למידע כללי, האתר של Prometheus
metrics.prometheus.sslKeyPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry חובה הנתיב למפתח ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים. אפשר לעיין במאמרים הבאים: מדדים למידע כללי, האתר של Prometheus
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, ב-mebibytes.
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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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.3 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.sdSidecar.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.appStackdriverExporter.resources.requests.cpu metrics.proxyStackdriverExporter.resources.requests.cpu
metrics.stackdriverExporter.resources.requests.memory	Advanced	נוספה בגרסה: 1.4.0 תרשים: apigee-telemetry ‫Deprecated: החל מגרסה 1.8 של Hybrid,‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים: metrics.appStackdriverExporter.resources.requests.memory metrics.proxyStackdriverExporter.resources.requests.memory
metrics.stackdriverExporter.resources.limits.cpu	Advanced	נוספה בגרסה: 1.4.0 תרשים: apigee-telemetry ‫Deprecated: החל מגרסה 1.8 של Hybrid,‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים: metrics.appStackdriverExporter.resources.limits.cpu metrics.proxyStackdriverExporter.resources.limits.cpu
metrics.stackdriverExporter.resources.limits.memory	Advanced	נוספה בגרסה: 1.4.0 תרשים: apigee-telemetry ‫Deprecated: החל מגרסה 1.8 של Hybrid,‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. אפשר לעיין במאמרים הבאים: metrics.appStackdriverExporter.resources.limits.memory metrics.proxyStackdriverExporter.resources.limits.memory
metrics.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 300 תרשים: apigee-telemetry משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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 לאבטחת פודים
mintTaskScheduler.gsa	Advanced	הושק בגרסה: 1.15.1 ערך ברירת המחדל: ללא תרשים: apigee-org כתובת האימייל של חשבון השירות (GSA) של apigee-mint-task-scheduler Google IAM שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mintTaskScheduler.image.url	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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, ב-mebibyte.
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 מופעל. זהירות: אל תשנו את המאפיין הזה בהתקנות שבהן פועלת גרסה 1.14.1 או גרסה חדשה יותר של Apigee Hybrid.
newDataPipeline.analytics	Advanced	נוספה בגרסה: 1.13.1 ערך ברירת המחדל: true תרשים: apigee-env ההגדרה קובעת אם הניתוח משתמש בפייפליין של Pub/Sub. זהירות: אל תשנו את המאפיין הזה בהתקנות שבהן פועלת גרסה 1.14.1 או גרסה חדשה יותר של Apigee Hybrid.

nodeSelector

האובייקט nodeSelector מגדיר את הצומת של מכונת Apigee. מאחורי הקלעים, כשמתקינים או משדרגים את התרשימים של apigee-org ו-apigee-ingress-manager, Apigee hybrid ממפה את המפתח/הערך של התווית של apigeeRuntime ו-apigeeData לרכיבים הנפרדים של Istio ו-MART. אפשר לשנות את ההגדרה הזו לאובייקטים ספציפיים במאפיין 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 הבסיסיות לא יתוזמנו בצמתים של ה-VM. בגרסת הייצור, צריך להגדיר את nodeSelector.requiredForScheduling כ-true. הגדרת מאגרי צמתים ייעודיים

redis

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

מאפיין (property)	סוג	תיאור
redis.securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-redis מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים
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.auth.password אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
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.3 תרשים: apigee-redis תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.envoy.image.url	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: ללא תרשים: apigee-redis המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
redis.envoy.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-redis המספר המינימלי של פודים של Redis Envoy שצריכים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-redis המספר המקסימלי של פודים של Redis Envoy שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: maxUnavailable: 1
redis.image.pullPolicy	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: IfNotPresent תרשים: apigee-redis קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
redis.image.tag	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 1.17.3 תרשים: apigee-redis תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.image.url	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: ללא תרשים: apigee-redis המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
redis.replicaCount	בסיסי	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 2 תרשים: apigee-redis ‫Redis הוא אחסון משוכפל. המאפיין הזה מציין את מספר צומתי Redis שמועסקים כ-StatefulSet.
redis.resources.requests.cpu	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 500m תרשים: apigee-redis המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה. ‫Apigee ממליצה על ערך בין 500m ל-1000m. עם 0.5 ליבות, צומת Redis יכול בדרך כלל לטפל ב-10,000 שאילתות לשנייה. עם ליבה אחת, בדרך כלל אפשר לטפל ב-20,000 שאילתות לשנייה. ברוב המקרים, בקשות למשאבי מעבד (CPU) מעל 1,000m לא עוזרות.
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.

runtime

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

מאפיין (property)	סוג	תיאור
runtime.securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-env מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים
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 מידת השינוי שמותרת לפי המדיניות כשמצמצמים את מספר המכונות בזמן הריצה.
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.3 תרשים: apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
runtime.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-env המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: 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.0 ערך ברירת המחדל: ללא תרשים: 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 לכל סביבה, הן יחולו על כל קבוצות הרפליקות בסביבה. כל קבוצת רפליקות עדיין תתאים את הגודל שלה באופן אוטומטי ובנפרד.
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). הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את runtime.resources.limits.memory ל-‎6Gi. מגדילים את runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
runtime.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500m תרשים: apigee-env המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה. הערה: כדי לבצע התאמה אוטומטית לעומס (automatic scaling) חלקה של מעבדי בקשות לעלייה בתעבורת נתונים, מומלץ לא לחרוג משתי ליבות (2,000 מילי-ליבות) אם מחליטים לשנות את ברירת המחדל. רכיבי סביבת זמן הריצה של Apigee מוגבלים על ידי קלט/פלט, והוספת קיבולת CPU לא תמיד עוזרת להתמודד עם עומסי תנועה. כשיש בקשות רבות למעבד (CPU), יכול להיות שמעבדי הבקשות לא יבצעו התאמה אוטומטית לעומס, ובדיקות החיוּת ייכשלו בגלל תנועה רבה.
runtime.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi (ראו הערה בהמשך) תרשים: apigee-env הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). חשוב: בסביבות ייצור, צריך לאפס את הערך של runtime.resources.requests.memory ל-1Gi לפחות ב-overrides.yaml. ערך ברירת המחדל של 512Mi מספיק להפעלה ולהגדרה הראשונית, אבל צריך להגדיל אותו בסביבת הייצור. כדי להשיג התאמה אוטומטית לעומס (automatic scaling) חלקה של מעבדי בקשות לעלייה בתעבורת נתונים, מומלץ לא לחרוג מ-2.5Gi‏ (2560Mi) אם מחליטים לשנות את ברירת המחדל. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את runtime.resources.limits.memory ל-‎6Gi. מגדילים את runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
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. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי. הערה: הערך הזה מוגדר על ידי בקר Apigee ואי אפשר לשנות אותו.
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.

securityContext

הגדרת אבטחה לפודים שאפשר להחיל ברמה הגלובלית, ברמת הסביבה או ברמת הרכיב.

מאפיין (property)	סוג	תיאור
securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-operator מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים

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 לאבטחת פודים
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.3 תרשים: apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
synchronizer.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא תרשים: apigee-env המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
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.0 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המינימלי של pod של סנכרון שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה 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.0 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המקסימלי של pod של סנכרון שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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 משך הזמן שהסנכרון ממתין בין פעולות דגימה. הסנכרון דוגם את שירותי מישור הבקרה של Apigee כדי לזהות ולמשוך חוזים חדשים של סביבת זמן הריצה.
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) לתהליך של Synchronizer ב-pod. הערך של השדה הזה מאפשר ל-Synchronizer לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
synchronizer.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 30 תרשים: apigee-env משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-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.

virtualhosts

המאפיין virtualhosts הוא מאפיין הגדרה נדרש. מארחים וירטואליים מאפשרים ל-Apigee Hybrid לטפל בבקשות API לקבוצת סביבות מסוימת.

מידע נוסף זמין במאמר הגדרת מארחים וירטואליים.

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

מאפיין (property)	סוג	תיאור
virtualhosts[].additionalGateways	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-virtualhost רשימה של שערי Istio שאליהם תנותב התנועה.
virtualhosts[].cipherSuites[]	Advanced	נוסף בגרסה: 1.9.2 ערך ברירת המחדל: ללא תרשים: apigee-virtualhost המאפיין הזה מגדיר את הצפנות ה-TLS שמשמשות בשער הכניסה. הערה: המאפיין הזה מחליף את רשימת ה-cipher suites שמופעלים, ולא מוסיף לה. הערכים של virtualhosts.cipherSuites צריכים להיות בפורמט OpenSSL. בהמשך מופיעה רשימה של צפנים נתמכים בפורמט OpenSSL. מידע נוסף על הצפנים הנתמכים זמין במסמכי התיעוד של Boring FIPS build of Envoy. ערך ריק מוגדר כברירת מחדל לסטים של אלגוריתמים להצפנה (cipher suite) שנתמכים על ידי גרסת Boring FIPS של Envoy. TLS v1.3: מופעלת כברירת מחדל חבילות הצפנה נוספות TLS_AES_128_GCM_SHA256 TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 אי אפשר לשנות את ההגדרות של סט אלגוריתמים להצפנה (cipher suite) של 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" ... הערה: המאפיין הזה מבטל את רשימת ה-cipher suites שנתמכים על ידי Envoy, ולא מוסיף לה. טיפ: המאפיין virtualhosts.cipherSuites משתמש בפורמט של סט אלגוריתמים להצפנה (cipher suite) של OpenSSL. רשימה של הצפנות עם השמות שלהן בפורמט OpenSSL וגם בפורמט IANA מופיעה במאמר Translating OpenSSL cipher suite names to IANA במסמכי התיעוד של SSL.org.
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[].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. הערה: בכל סביבה שהוגדרה, השם הנפוץ (CN) באישור חייב להיות תואם לדומיין במאפיין hostAliases[]. לדוגמה, אם ה-CN הוא *.example.com, ה-hostAliases[] יכול להיות foo.example.com או bar.example.com.
virtualhosts[].sslKeyPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-virtualhost צריך לציין sslCertPath/sslKeyPath או sslSecret. הנתיב במערכת לקובץ המפתח הפרטי של TLS.
virtualhosts[].sslSecret	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא תרשים: apigee-virtualhost צריך לציין את sslCertPath/sslKeyPath או את sslSecret. שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את שמות המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes

watcher

המאפיין watcher הוא מאפיין הגדרה נדרש. ה-watcher הוא תהליך שצופה בשינויים בהגדרות ומפעיל את היישום שלהם במישור זמן הריצה.

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

מאפיין (property)	סוג	תיאור
watcher.securityContext.seccompProfile.type	Advanced	נוספה בגרסה: 1.16.0 ערך ברירת המחדל: ללא תרשים: apigee-org מציין את סוג הפרופיל של Seccomp שצריך להחיל על הקשר האבטחה של ה-pod. הערכים המותרים הם RuntimeDefault (כדי להשתמש בפרופיל ברירת המחדל של סביבת זמן הריצה של הקונטיינר) או Unconfined (כדי לא להחיל הגבלות Seccomp). אם לא מציינים פרופיל, Apigee לא מחילה פרופיל. הגדרת פרופילי Seccomp לאבטחת פודים
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 לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת 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.3 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
watcher.image.url	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
watcher.podDisruptionBudget.minAvailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של צופים שחייבים להישאר זמינים במהלך שיבוש יזום, כמו שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של pod-ים (0) או מחרוזת של אחוזים ("50%"). מכיוון ש-Apigee hybrid מריץ pod אחד של watcher (watcher.replicaCountMax: 1), הגדרת minAvailable ל-1 או לאחוז שאינו אפס מונעת פינוי pod-ים מרצון במהלך ניקוז צמתים. minAvailable ו-maxUnavailable מוציאים זה את זה, לכן צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable	Advanced	נוספה בגרסה: 1.17.0 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של צופים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (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 אחד לכל התקנה. בבחירת מנהיג, המערכת בוחרת באופן אוטומטי pod אחד של צופה. עותקים נוספים של pod של watcher ייאלצו לעבור למצב לא יציב. מידע נוסף זמין במאמר watcher.args.enableLeaderElect. אזהרה: הערך של watcher.replicaCountMax לא יכול להיות גדול מ-1.
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.