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

הגרסה שמוצגת כרגע היא 1.16 של מסמכי Apigee Hybrid. מידע נוסף זמין במאמר בנושא גרסאות נתמכות.

Version 1.16 

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

• 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, אפשר להוסיף את ה-stanza הבאה אל overrides.yaml:

mart:
    replicaCountMin: 3
    replicaCountMax: 6

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

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

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

סינון הדף

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

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

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

נכסים ברמה העליונה

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

מאפיין (property)	סוג	תיאור
axHashSalt	Advanced	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: iloveapis123 תרשים: apigee-org אופציונלי השם של סוד ב-Kubernetes שמכיל מלח שמשמש לחישוב גיבובים כדי להסתיר נתוני משתמשים לפני שהם נשלחים ל-Apigee Analytics. אם לא מציינים ערך של salt, המערכת משתמשת ב-iloveapis123 כברירת מחדל. יוצרים את הסוד עם ערך ה-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 הוא המיקום שבו מאוחסנים נתונים של מישור הבקרה, כמו חבילות פרוקסי. רשימה של האזורים הזמינים של מישור הבקרה של Apigee API זמינה כאן. לדוגמה: contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled	בסיסי	הוצג בגרסה: 1.14.0 ערך ברירת מחדל: true תרשים: apigee-telemetry אם המדיניות הזו מוגדרת לערך true (ברירת המחדל), מופעלת התאמת קנה מידה אוטומטית מבוססת-מדדים של Apigee. מגדירים את הערך false כדי להשבית את ההתאמה האוטומטית של קנה המידה בהתאמה אישית. כדי להחיל שינויים על customAutoscaling.enabled, צריך לעדכן את התרשים apigee-telemetry.
enhanceProxyLimits	Advanced	הוצג בגרסה: 1.14.0 ערך ברירת מחדל: false מצעד: apigee-org, apigee-virtualhost חובה נדרש enhanceProxyLimits כדי להשתמש בתכונה 'מכסות משופרות של שרתי proxy לכל סביבה' ב-Apigee. מגדירים את הערך הזה ל-enhanceProxyLimits: true אם הארגון ההיברידי שלכם זכאי למגבלות משופרות של שרת proxy לכל סביבה. הערה: התכונה הזו זמינה כחלק מתוכנית המינוי של 2024. מידע נוסף: מגבלות על שרתי proxy ל-API. מגבלות משופרות של פרוקסי לכל סביבה. זכויות שימוש במינוי. ההגדרה enhanceProxyLimits: true נדרשת עבור שרשור של שרתי proxy, שרשור של נקודות קצה ושרשור של ServiceCallout. מידע נוסף זמין במאמרים הבאים: שרשור של שרתי proxy ל-API מדיניות ServiceCallout התראה: אחרי שמגדירים את הערך הזה ל-true, אסור להגדיר אותו ל-false. כדי להחיל שינויים על 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.16.10 imagePullPolicy: IfNotPresent הערה: לפני גרסה 1.14.2 של Apigee Hybrid, לרכיבי צד שלישי היה מזהה ייחודי לגרסת התמונה מספק הצד השלישי. לדוגמה: ## an example of internal component vs 3rd party containers: - name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.16.10 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 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 חובה הארגון עם התכונה Hybrid שהוקצה לכם על ידי Apigee במהלך ההתקנה של Hybrid. ארגון הוא מאגר ברמה העליונה ב-Apigee. הוא מכיל את כל פרוקסי ה-API והמשאבים הקשורים. אם הערך ריק, צריך לעדכן אותו בשם הארגון אחרי שיוצרים אותו.
revision	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: "11610" (גרסת Apigee Hybrid בלי נקודות. לדוגמה, בגרסה 1.12.0, ערך ברירת המחדל הוא "1120".) תרשים: apigee-operator ‫Apigee hybrid תומך בעדכוני Kubernetes מתגלגלים, שמאפשרים לבצע עדכוני פריסה ללא זמן השבתה, על ידי עדכון מצטבר של מופעי Pod במופעים חדשים. כשמעדכנים חלק מהחלפות ברירת המחדל של YAML שגורמות לשינוי ב-KubernetesPodTemplateSpec הבסיסי, צריך לשנות גם את revisionמאפיין החלפת ברירת המחדל ב-override.yaml של הלקוח. הדבר נדרש כדי שהבקר הבסיסי של Kubernetes ApigeeDeployment (AD) יבצע עדכון בהדרגה (rolling) בטוח מהגרסה הקודמת לגרסה החדשה. אפשר להשתמש בכל ערך טקסט באותיות קטנות, למשל: blue, a, 1.0.0 הערה: revision יכול לקבל רק אותיות קטנות, ספרות וסימני פיסוק. כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) לכל הרכיבים שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision: nodeSelector envs imagePullSecrets gcpProjectID k8sClusterName contractProvider org מידע נוסף זמין במאמר בנושא עדכון בהדרגה.
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 ו-Tolerations של Kubernetes ברכיבים של Apigee Hybrid. הערה: tolerations ברמה העליונה הוא ברירת מחדל גלובלית, ולא ברירת מחדל מצטברת. ההגדרה חלה על רכיב רק אם המאפיין tolerations של הרכיב לא מוגדר. הגדרה של tolerations ברמת הרכיב מחליפה את הערך ברמה העליונה, ולא מתמזגת איתו. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
tolerations.tolerationSeconds	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. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
tolerations.value	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. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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 לא מנהל את Kubernetes ClusterRole ואת ClursterRoleBinding ישירות. אם יש לכם תהליך שדורש ניהול של המשאבים האלה, התהליך צריך להתבצע על ידי משתמש עם ההרשאות המתאימות.
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.16.10 מצעד: apigee-operator, apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
ao.image.url	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא מצעד: apigee-operator, apigee-ingress-manager המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
ao.resources.requests.memory	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: 256Mi מצעד: apigee-operator, apigee-ingress-manager הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-operator נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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.16.10 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
apigeeIngressGateway.image.url	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org מספר הפודים המינימלי של שער הכניסה של Apigee שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. בשדה הזה מוגדר השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable מוציאים זה את זה. צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לשער ספציפי, משתמשים ב-ingressGateways[].podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: apigeeIngressGateway: podDisruptionBudget: minAvailable: "50%"
apigeeIngressGateway.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של שער כניסה ל-Apigee שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מוגדר השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 המקסימלי ש-hybrid יכול להוסיף אוטומטית עבור שער הכניסה שזמין להתאמה אוטומטית לעומס.
apigeeIngressGateway.replicaCountMin	בסיסי	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 2 תרשים: apigee-org מספר הפודים המינימלי של שער הכניסה שזמין להרחבה אוטומטית.
apigeeIngressGateway.targetCPUUtilizationPercentage	Advanced	הושק בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1 ערך ברירת מחדל: 75 תרשים: apigee-org סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז ממשאבי המעבד הכוללים שזמינים. אם השימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר ה-pods ב-ReplicaSet, עד ל-apigeeIngressGateway.replicaCountMax. מידע נוסף על שינוי קנה מידה ב-Kubernetes זמין במאמר בנושא התאמה אופקית של קבוצות Pod לעומס במאמרי העזרה של Kubernetes.
apigeeIngressGateway.tolerations.effect	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
apigeeIngressGateway.tolerations.key	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
apigeeIngressGateway.tolerations.operator	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: "Equal" תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
apigeeIngressGateway.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
apigeeIngressGateway.tolerations.value	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

cassandra

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

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

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

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

מאפיין (property)	סוג	תיאור
cassandra.annotations	Advanced	הוצג בגרסה: 1.5.0 ערך ברירת מחדל: ללא תרשים: apigee-datastore מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
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.16.10 מצעד: apigee-datastore, apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.auth.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא מצעד: apigee-datastore, apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 Secrets in the Kubernetes documentation יצירת סוד באמצעות 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 (מומלץ) להשתמש ב-Kubernetes CSI Volume Snapshots לגיבוי. מידע על 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) שיש לשייך לחשבון השירות של Kubernetes לגיבוי של Cassandra כשמפעילים 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.16.10 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.backup.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להעלאת ארכיונים של גיבויים אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider מוגדר כ-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-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 יכול לגשת לקטגוריה של Cloud Storage ב-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 גרסה 1.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 הפעלת התכונה Kubernetes hostNetwork. ‫Apigee משתמש בתכונה הזו בהתקנות מרובות אזורים כדי ליצור תקשורת בין פודים אם למרחב השמות של רשת הפודים אין קישוריות בין אשכולות (האשכולות פועלים ב'מצב רשת איים'), וזהו המצב שמוגדר כברירת מחדל בהתקנות שאינן GKE, כולל Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. מגדירים את cassandra.hostNetwork לערך false להתקנות באזור יחיד ולהתקנות במספר אזורים עם קישוריות בין פודים באשכולות שונים, למשל התקנות GKE. מגדירים את cassandra.hostNetwork ל-true להתקנות בכמה אזורים ללא תקשורת בין פודים באשכולות שונים, למשל התקנות של 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.16.10 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-datastore המספר המינימלי של פודים של Cassandra שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: cassandra: podDisruptionBudget: minAvailable: "50%"
cassandra.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-datastore המספר המקסימלי של פודים של Cassandra שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: cassandra: podDisruptionBudget: maxUnavailable: 1
cassandra.port	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 9042 תרשים: apigee-datastore מספר היציאה שמשמש להתחברות ל-Cassandra.
cassandra.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. מבצעים בדיקת עומס ומפיקים תחזיות סבירות לגבי ניצול המעבד. אפשר לציין ערכי replicaCount שונים באזורים שונים. תוכלו להרחיב את replicaCount בעתיד בקובץ ההחלפות.
cassandra.resources.requests.cpu	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 500m תרשים: apigee-datastore המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
cassandra.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1Gi תרשים: apigee-datastore הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
cassandra.restore.cloudProvider	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: GCP תרשים: apigee-datastore השם של ספק השחזור. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך: GCP כדי לשחזר נתונים מגיבוי שמאוחסן ב-Google Cloud Storage. ‫HYBRID כדי לשחזר נתונים מגיבוי שמאוחסן בשרת SSH מרוחק. ‫CSI (מומלץ) להשתמש ב-Kubernetes CSI Volume Snapshots לשחזור. מידע על 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: כתובת האימייל של חשבון השירות (GSA) של Google IAM‏ apigee-cassandra שאותו רוצים לשייך לחשבון השירות של Kubernetes לשחזור Cassandra כשמפעילים 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.16.10 תרשים: apigee-datastore תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.restore.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-datastore המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
cassandra.restore.serviceAccountPath	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-datastore נתיב לקובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין. אם ההגדרה של השחזור מופעלת ו-cassandra.restore.cloudProvider מוגדר ל-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-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 יכול לגשת לקטגוריה של Cloud Storage ב-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 הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
cassandra.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-datastore נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
cassandra.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-datastore נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-datastore נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-datastore התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-datastore התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
connectAgent.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא תרשים: apigee-org רק ב-Helm: כתובת האימייל של חשבון השירות של Google IAM ‏ (GSA) שאליו connectAgent ישויך כשמפעילים 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.16.10 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
connectAgent.image.url	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
connectAgent.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org מספר המינימלי של פודים של סוכן Apigee Connect שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז צמתים. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של סוכני Apigee Connect שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: maxUnavailable: 1
connectAgent.replicaCountMax	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: 5 תרשים: apigee-org המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.
connectAgent.replicaCountMin	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: 1 תרשים: apigee-org מספר הרפליקות המינימלי שזמין להתאמה אוטומטית לעומס. בסביבת ייצור, מומלץ להגדיל את הערך של replicaCountMin ל-1, כדי להגדיל את מספר החיבורים למישור הבקרה לצורך אמינות ומדרגיות.
connectAgent.resources.limits.cpu	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 512m תרשים: apigee-org מגבלת המעבד (CPU) למשאב בקונטיינר Kubernetes, במילי-ליבות.
connectAgent.resources.limits.memory	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 512Mi תרשים: apigee-org מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במביבייט.
connectAgent.resources.requests.cpu	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 100m תרשים: apigee-org המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
connectAgent.resources.requests.memory	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: 30Mi תרשים: apigee-org הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 לבצע התאמה אוטומטית לעומס כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
connectAgent.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: 600 תרשים: apigee-org הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
connectAgent.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
connectAgent.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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. כל סביבה מספקת הקשר מבודד או ארגז חול להרצת 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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env מספר הפודים המינימלי של זמן הריצה בסביבה הזו שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים runtime.podDisruptionBudget.minAvailable. בשדה הזה מוגדר השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של זמן ריצה בסביבה הזו שיכולים להיות לא זמינים במהלך שיבוש מרצון, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים runtime.podDisruptionBudget.maxUnavailable. בשדה הזה מוגדר השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 מספר הרפליקות המקסימלי להרחבה אוטומטית. אם מציינים ערך, הוא מבטל את הערך של 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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env מספר המינימלי של פודים של מסנכרנים בסביבה הזו שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים synchronizer.podDisruptionBudget.minAvailable. בשדה הזה מוגדר השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של מסנכרן בסביבה הזו שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים synchronizer.podDisruptionBudget.maxUnavailable. בשדה הזה מוגדר השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 מספר הרפליקות המקסימלי להרחבה אוטומטית. אם מציינים ערך, הוא מבטל את הערך של 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 עבור פרוקסי קדימה ברמת הסביבה, מעקב וניתוח (שמשתמשים ב-googleapis.com) ידלגו על פרוקסי קדימה. היעדים בפרוקסי (כולל googleapis.com) ינותבו דרך הפרוקסי הקדמי. אי אפשר להשתמש בהגדרה הזו ביחד עם 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 Agent, בדרך כלל חשבון השירות apigee-runtime. במאמר מידע על חשבונות שירות מפורטים שמות ברירת המחדל של חשבונות השירות והתפקידים שהוקצו להם.
envs[].serviceAccountPaths.synchronizer	בסיסי	הוצג בגרסה: 1.0 ערך ברירת מחדל: ללא תרשים: apigee-env הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Apigee Synchronizer Manager.
envs[].serviceAccountSecretProviderClass	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: ללא תרשים: apigee-env השם של מחלקת ספק הסודות הספציפית לסביבה (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault. מידע נוסף מופיע במאמר אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault.
envs[].serviceAccountSecretRefs.runtime	בסיסי	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: ללא תרשים: apigee-env השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google עם התפקיד Cloud Trace Agent כקלט.
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 הגדרת בדיקת מוכנות להפעלה (startup probe) של 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. מידע נוסף זמין במאמר הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-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 metrics.gsa mintTaskScheduler.gsa udca.gsa watcher.gsa
gcp.workloadIdentity.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא מצעד: apigee-datastore, apigee-telemetry, apigee-org, apigee-env כתובת האימייל של חשבון השירות (GSA) של Google IAM לכל הרכיבים שצריך לשייך לחשבון השירות התואם של 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 מאפשר ל-pod של אמצעי הבקרה בתרשים 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.16.10 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
guardrails.image.url	Advanced	הוצג בגרסה: 1.16.0 ערך ברירת מחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
guardrails.gsa	Advanced	הוצג בגרסה: 1.16.0 ערך ברירת מחדל: ללא תרשים: apigee-operator כתובת האימייל של apigee-guardrails חשבון השירות (GSA) של 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 עם התפקיד Service Usage Viewer.
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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
guardrails.tolerations.operator	Advanced	הוצג בגרסה: 1.16.0 ערך ברירת מחדל: "Equal" תרשים: apigee-operator נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
guardrails.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.16.0 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
guardrails.tolerations.value	Advanced	הוצג בגרסה: 1.16.0 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

httpProxy

‫httpProxy מספק פרמטרים להגדרת שרת proxy להעברת HTTP. כש מגדירים את overrides.yaml ב-, כל התקשורת באינטרנט של הרכיבים Apigee Connect,‏ Logger,‏ MART,‏ Metrics,‏ Synchronizer ו-UDCA עוברת דרך שרת ה-Proxy.

הערה: אפשר גם להגדיר העברה של שרת proxy מסוג HTTP בהיקף סביבה עבור שרתי proxy של API. מידע נוסף זמין במאמר בנושא הגדרת העברה ליציאה אחרת ל-proxy ל-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 משלה. במקרה כזה, נתוני ניתוח או ניפוי באגים של זמן הריצה ישתמשו בפרוקסי ששותף ברמת הארגון, בעוד שתנועת הגולשים בבקשות עורף או בפרוקסי תמשיך להשתמש בפרוקסי ברמת הסביבה (כולל קריאות ל-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.

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

החלת שינויים במאפייני ingressGateways באמצעות התרשים apigee-org.

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

מאפיין (property)	סוג	תיאור
ingressGateways[].name	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: ללא תרשים: apigee-org חובה השם של שער הכניסה. שירותים אחרים ישתמשו בשם הזה כדי להפנות תנועה לשער. השם צריך לעמוד בדרישות הבאות: האורך המקסימלי הוא 17 תווים יכול להכיל רק תווים אלפאנומריים באותיות קטנות, '-' או '.' להתחיל בתו אלפאנומרי להסתיים בתו אלפאנומרי מידע נוסף זמין במאמר DNS Subdomain Names במסמכי התיעוד של Kubernetes.
ingressGateways[].podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org מספר המינימלי של פודים של שער הכניסה הזה שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים apigeeIngressGateway.podDisruptionBudget.minAvailable. בשדה הזה מוגדר השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים בשער הכניסה הזה שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. שינויים apigeeIngressGateway.podDisruptionBudget.maxUnavailable. בשדה הזה מוגדר השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 הבעת הסכמה לניתוח של פרוטוקול ה-PROXY של HAProxy ברכיב של שער הכניסה. הערכים המותרים הם strict,‏ permissive או disable. אם מגדירים ערך כזה, הוא מחליף את ברירת המחדל הגלובלית שהוגדרה ב-apigeeIngressGateway.proxyProtocol.mode.
ingressGateways[].replicaCountMax	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 10 תרשים: apigee-org מספר ה-Pods המקסימלי ש-hybrid יכול להוסיף אוטומטית עבור שער הכניסה שזמין להתאמה אוטומטית לעומס.
ingressGateways[].replicaCountMin	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 2 תרשים: apigee-org מספר הפודים המינימלי של שער הכניסה שזמין להרחבה אוטומטית.
ingressGateways[].resources.limits.cpu	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 2000m תרשים: apigee-org מגבלת המעבד (CPU) למשאב, במיליליבות.
ingressGateways[].resources.limits.memory	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 1Gi תרשים: apigee-org מגבלת הזיכרון של המשאב, במביבייט.
ingressGateways[].resources.requests.cpu	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 300m תרשים: apigee-org השימוש במעבד שנדרש לפעולה רגילה של המשאב, במיליליבות.
ingressGateways[].resources.requests.memory	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: 128Mi תרשים: apigee-org הזיכרון שנדרש לפעולה רגילה של המשאב, במביבייט.
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 לפריסת כניסה. מגדירים את הערך ל-ClusterIP אם רוצים להשבית את היצירה של מאזן עומסים שמוגדר כברירת מחדל. ערכים אפשריים: ClusterIP LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage	Advanced	הושק בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1 ערך ברירת מחדל: 75 תרשים: apigee-org סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז ממשאבי המעבד הכוללים שזמינים. אם השימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר ה-pods ב-ReplicaSet, עד ל-ingressGateways[].replicaCountMax. מידע נוסף על שינוי קנה מידה ב-Kubernetes זמין במאמר בנושא התאמה אופקית של קבוצות Pod לעומס במאמרי העזרה של Kubernetes.
ingressGateways[].tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
ingressGateways[].tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-operator נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-operator התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

istiod

הגדרת ה-ingress של Apigee.

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

מאפיין (property)	סוג	תיאור
istiod.accessLogFile	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: /dev/stdout תרשים: apigee-ingress-manager כתובת הקובץ של יומן הגישה לתעבורה הנכנסת, לדוגמה /dev/stdout. אם לא מגדירים את הערך הזה, רישום הגישה מושבת.
istiod.accessLogFormat	Advanced	הוצג בגרסה: 1.8.0 תרשים: apigee-ingress-manager הפורמט של יומן הגישה לתנועה נכנסת. אם לא מגדירים את הערך הזה, המערכת משתמשת בפורמט ברירת המחדל של יומן הגישה של ה-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 (פרוטוקול 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) על ידי ביטול רשימת ההיתרים של סוכן המשתמש שמוגדרת כברירת מחדל בהגדרה היברידית. הערה: השימוש במאפיין ההגדרה הזה נתמך רק בהתקנות היברידיות באמצעות תרשימי 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.16.10 תרשים: apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
istiod.image.url	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: ללא תרשים: apigee-ingress-manager המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-ingress-manager נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-ingress-manager התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-ingress-manager התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

k8sCluster

מזהה את אשכול Kubernetes שבו מותקנת סביבת זמן הריצה ההיברידית.

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

מאפיין (property)	סוג	תיאור
k8sCluster.name	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא מצעד: apigee-telemetry, apigee-org השם של אשכול Kubernetes שבו מותקן זמן הריצה ההיברידי.
k8sCluster.region	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא מצעד: apigee-telemetry, apigee-org מזהה את האזור ב-Google Cloud שבו נוצר אשכול Kubernetes.

kubeRBACProxy

מציין איפה Apigee צריך לחפש בקרת גישה המבוססת על תפקידים (RBAC) ב-Kubernetes.

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

מאפיין (property)	סוג	תיאור
kubeRBACProxy.image.pullPolicy	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: IfNotPresent מצעד: apigee-operator, apigee-ingress-manager קובעת מתי kubelet מושך את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: התמונה תמיד תימשך, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
kubeRBACProxy.image.tag	Advanced	הוספנו בגרסה: 1.2.0 ערך ברירת מחדל: 1.16.10 מצעד: apigee-operator, apigee-ingress-manager תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
kubeRBACProxy.image.url	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא מצעד: apigee-operator, apigee-ingress-manager המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
kubeRBACProxy.resources.requests.memory	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 64Mi מצעד: apigee-operator, apigee-ingress-manager הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.

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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
logger.bufferChunkSize	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת המחדל: 256k תרשים: apigee-telemetry גודל מאגר הנתונים הזמני הראשוני לקריאת קובצי יומן.
logger.bufferMaxSize	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת המחדל: 104857600 תרשים: apigee-telemetry המגבלה של גודל שטח האחסון הזמני לכל קובץ שנמצא במעקב. קבצים שחורגים מהמגבלה הזו מוסרים מרשימת הקבצים שבמעקב.
logger.bufferMemoryLimit	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: 150MB תרשים: apigee-telemetry מגבלת הזיכרון שהכלי לרישום יכול לצרוך. אם תגיעו למגבלה, רישום היומן יושהה לרגע עד שהנתונים הקיימים יימחקו מהזיכרון.
logger.enabled	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: false תרשים: apigee-telemetry המתג מפעיל או משבית את הרישום ביומן של האשכול. לסביבות שאינן GKE, צריך להגדיר את הערך true. לסביבות GKE ב- Google Cloud או Google Distributed Cloud, צריך להגדיר את הערך false.
logger.envVars	בסיסי	הוצג בגרסה: 1.8.5 ערך ברירת מחדל: ללא תרשים: apigee-telemetry ההגדרה הזו מאפשרת לכם לכלול את משתנה הסביבה NO_PROXY Fluent Bit, שמציין כתובות URL שהתעבורה אליהן לא מנותבת דרך Proxy ל-HTTP. המשתנה NO_PROXY צריך להיות מוגדר כמחרוזת של שמות מארחים מופרדים בפסיקים, בפורמט: logger: ... envVars: NO_PROXY: '<comma-separated-values>' לדוגמה: envVars: NO_PROXY: 'kubernetes.default.svc,oauth2.googleapis.com,logging.googleapis.com' אפשר להשתמש ב-envVars: NO_PROXY אם הפעלתם שרת proxy להעברת HTTP. מידע נוסף מופיע במאמר בנושא NO_PROXY במסמכי התיעוד של Fluent Bit.
logger.flushInterval	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: 1 תרשים: apigee-telemetry מרווח הזמן להמתנה לפני הפעלת הניקוי הבא של המאגר, בשניות.
logger.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-logger 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.
logger.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: IfNotPresent תרשים: apigee-telemetry קובעת מתי kubelet מושך את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: התמונה תמיד תימשך, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
logger.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1.16.10 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
logger.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
logger.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 250Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
logger.serviceAccountPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry חובה לציין את serviceAccountPath או את serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Logs Writer.
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 הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
logger.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
logger.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

mart

השירות MART (ממשק API לניהול נתוני זמן ריצה) מוגדר כספק API של ממשקי Apigee ציבוריים, כדי שתוכלו לגשת לישויות של נתוני זמן ריצה ולנהל אותן, כמו KMS (מפתחות API ואסימוני OAuth),‏ KVM, ‏ Quota ומוצרי 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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
mart.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא תרשים: apigee-org Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-mart 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.
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.16.10 מצעד: apigee-org, apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mart.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא מצעד: apigee-org, apigee-env המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org מספר המינימלי של פודים של MART שצריכים להישאר זמינים במהלך שיבוש מרצון, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: minAvailable: "50%"
mart.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של MART שלא יכולים להיות זמינים במהלך שיבוש מרצון, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: maxUnavailable: 1
mart.readinessProbe.failureThreshold	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 2 תרשים: apigee-org מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
mart.readinessProbe.initialDelaySeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 15 תרשים: apigee-org מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
mart.readinessProbe.periodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 5 תרשים: apigee-org ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
mart.readinessProbe.successThreshold	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1 תרשים: apigee-org מספר ההצלחות המינימלי ברצף שדרוש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
mart.readinessProbe.timeoutSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1 תרשים: apigee-org מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
mart.replicaCountMax	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 5 תרשים: apigee-org המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.
mart.replicaCountMin	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1 תרשים: apigee-org מספר הרפליקות המינימלי שזמין להתאמה אוטומטית לעומס.
mart.resources.limits.cpu	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 2000m תרשים: apigee-org מגבלת המעבד (CPU) למשאב בקונטיינר Kubernetes, במילי-ליבות.
mart.resources.limits.memory	Advanced	הוצג בגרסה: 1.11.0 ערך ברירת מחדל: 5Gi תרשים: apigee-org מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במביבייט.
mart.resources.requests.cpu	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 500m תרשים: apigee-org המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
mart.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 512Mi תרשים: apigee-org הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 ל-Secret.
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 Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
mart.targetCPUUtilizationPercentage	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 75 תרשים: apigee-org ניצול המעבד (CPU) שמוגדר כטירגוט לתהליך MART בפוד. הערך של השדה הזה מאפשר ל-MART לבצע שינוי גודל אוטומטי כשהשימוש ב-CPU מגיע לערך הזה, עד replicaCountMax.
mart.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 30 תרשים: apigee-org הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
mart.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
mart.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

metrics

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

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

בטבלה הבאה מפורטות המאפיינים של אובייקט 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.16.10 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.adapter.image.url	Advanced	הוצג בגרסה: 1.8.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.adapter.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של פודים של מתאם מדדים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של מתאם מדדים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: maxUnavailable: 1
metrics.adapter.resources.limits.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 500m תרשים: apigee-telemetry מגבלת המעבד (CPU) למשאב המתאם בקונטיינר Kubernetes, במילי-ליבות.
metrics.adapter.resources.limits.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 4Gi תרשים: apigee-telemetry מגבלת הזיכרון של משאב המתאם בקונטיינר Kubernetes, בגיביבייט.
metrics.adapter.resources.requests.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 100m תרשים: apigee-telemetry המעבד שנדרש לפעולה רגילה של המתאם במאגר Kubernetes, במילי-ליבות.
metrics.adapter.resources.requests.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 128Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של המתאם במאגר Kubernetes, במביבייט.
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, במביבייט.
metrics.aggregator.resources.limits.cpu	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 500m תרשים: apigee-telemetry מגבלת המעבד (CPU) למשאב המצטבר בקונטיינר Kubernetes, במילי-ליבות.
metrics.aggregator.resources.limits.memory	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 3Gi תרשים: apigee-telemetry מגבלת הזיכרון של משאב המצטבר בקונטיינר Kubernetes, בגיביבייט.
metrics.annotations	Advanced	הוצג בגרסה: 1.5.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
metrics.app.resources.requests.cpu	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 500m תרשים: apigee-telemetry השימוש במעבד שנדרש לפעולה רגילה של האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.app.resources.requests.memory	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של האפליקציה במאגר Kubernetes, במביבייט.
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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של appStackdriverExporter פודים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable מוציאים זה את זה. צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: appStackdriverExporter: podDisruptionBudget: minAvailable: "50%"
metrics.appStackdriverExporter.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של appStackdriverExporter פודים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 השימוש במעבד שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, באלפיות ליבה.
metrics.appStackdriverExporter.resources.requests.memory	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, במביבייט.
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.16.10 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.collector.image.url	בסיסי	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.collector.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של פודים של איסוף מדדים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה. מכיוון שהאיסוף פועל כ-DaemonSet, ברירת המחדל היא שהמאפיין minAvailable מוגדר ל-80% מהפודים של האיסוף (מעוגל כלפי מטה) במקום להשתמש במאפיין maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של אוספי מדדים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה. מכיוון שהאיסוף פועל כ-DaemonSet, ברירת המחדל היא שהמאפיין minAvailable מוגדר ל-80% מהפודים של האיסוף (מעוגל כלפי מטה) במקום להשתמש במאפיין maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: maxUnavailable: 1
metrics.collector.resources.requests.cpu	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: 500m תרשים: apigee-telemetry השימוש במעבד שנדרש לפעולה רגילה של האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.collector.resources.requests.memory	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של האפליקציה במאגר Kubernetes, במביבייט.
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 בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-metrics 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.
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.16.10 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.prometheus.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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, במיליליבות.
metrics.prometheus.resources.limits.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 4Gi תרשים: apigee-telemetry מגבלת הזיכרון של משאב Prometheus במאגר Kubernetes, בגיביבייט.
metrics.prometheus.resources.requests.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 128m תרשים: apigee-telemetry המעבד (CPU) שנדרש לפעולה רגילה של Prometheus במאגר Kubernetes, במילי-ליבות.
metrics.prometheus.resources.requests.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של Prometheus במאגר Kubernetes, במביבייט.
metrics.prometheus.sslCertPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry חובה הנתיב לאישור ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים. מידע נוסף: metrics למידע נוסף, אפשר לעיין באתר של Prometheus
metrics.prometheus.sslKeyPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry חובה הנתיב למפתח ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים. מידע נוסף: metrics למידע נוסף, אפשר לעיין באתר של Prometheus
metrics.proxy.resources.requests.cpu	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 500m תרשים: apigee-telemetry המעבד שנדרש לפעולה רגילה של ה-proxy במאגר Kubernetes, במילי-ליבות.
metrics.proxy.resources.requests.memory	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה תקינה של ה-proxy במאגר Kubernetes, במביבייט.
metrics.proxy.resources.limits.cpu	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 500m תרשים: apigee-telemetry מגבלת המעבד (CPU) למשאב ה-proxy בקונטיינר Kubernetes, במילי-ליבות.
metrics.proxy.resources.limits.memory	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 1Gi תרשים: apigee-telemetry מגבלת הזיכרון של משאב ה-proxy בקונטיינר Kubernetes, בגיביבייט.
metrics.proxyStackdriverExporter.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של proxyStackdriverExporter פודים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable מוציאים זה את זה. צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה את ההגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: proxyStackdriverExporter: podDisruptionBudget: minAvailable: "50%"
metrics.proxyStackdriverExporter.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של proxyStackdriverExporter פודים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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 השימוש במעבד שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, באלפיות ליבה.
metrics.proxyStackdriverExporter.resources.requests.memory	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת מחדל: 512Mi תרשים: apigee-telemetry הזיכרון שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, במביבייט.
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 של פרוקסי ה-sidecar של תהליך המדדים באשכול 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.16.10 תרשים: apigee-telemetry תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.sdSidecar.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.serviceAccountPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-telemetry חובה לציין את serviceAccountPath או את serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כתיבת מדדים ב-Monitoring.
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 הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
metrics.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
metrics.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-telemetry נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-telemetry התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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 כתובת האימייל של apigee-mint-task-scheduler חשבון השירות (GSA) של 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.16.10 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mintTaskScheduler.image.url	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת מחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
mintTaskScheduler.resources.requests.memory	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת מחדל: 512Mi תרשים: apigee-org הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

newDataPipeline

המאפיין newDataPipeline קובע אם רכיבי זמן הריצה של Apigee hybrid משתמשים בצינור הנתונים של Pub/Sub כדי לכתוב נתונים ישירות למישור הבקרה.

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

מאפיין (property)	סוג	תיאור
newDataPipeline.debugSession	Advanced	הוצג בגרסה: 1.13.1 ערך ברירת מחדל: true תרשים: apigee-env המדיניות הזו קובעת אם צינור הנתונים של Pub/Sub מופעל. זהירות: אל תשנו את המאפיין הזה בהתקנות של Apigee hybrid בגרסה 1.14.1 ואילך.
newDataPipeline.analytics	Advanced	הוצג בגרסה: 1.13.1 ערך ברירת מחדל: true תרשים: apigee-env קובעת אם מערכת Analytics משתמשת בצינור עיבוד הנתונים של Pub/Sub. זהירות: אל תשנו את המאפיין הזה בהתקנות של Apigee hybrid בגרסה 1.14.1 ואילך.

nodeSelector

אובייקט nodeSelector מגדיר את הצומת של מופע Apigee. מאחורי הקלעים ‫Apigee hybrid ממפה את המפתח/הערך של התווית עבור ‫apigeeRuntime ו-apigeeData לרכיבי Istio ו-MART הנפרדים כשמתקינים או משדרגים את תרשימי apigee-org ו-apigee-ingress-manager. אפשר לבטל את ההגדרה הזו לאובייקטים ספציפיים באמצעות המאפיין mart:nodeSelector.

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

מאפיין (property)	סוג	תיאור
nodeSelector.apigeeData.key	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: cloud.google.com/gke-nodepool תרשים: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost ‫ApigeeData הוא הצומת של מסד הנתונים Cassandra. מפתח התווית של בורר הצומת לטירגוט צמתי Kubernetes לעבודה עם נתונים של שירותי Apigee. איך מגדירים מאגרי צמתים ייעודיים
nodeSelector.apigeeData.value	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: apigee-data תרשים: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost ‫apigee-data הוא הצומת של מסד הנתונים Cassandra. ערך התווית של בורר הצמתים לטירגוט צמתי Kubernetes לעבודה עם נתונים של שירותי Apigee. איך מגדירים מאגרי צמתים ייעודיים
nodeSelector.apigeeRuntime.key	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: cloud.google.com/gke-nodepool תרשים: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost ‫Apigee Runtime הוא הצומת של סביבת זמן הריצה בפרויקט. מפתח התווית של בורר הצמתים לטירגוט צמתי Kubernetes לשירותי זמן ריצה של Apigee. איך מגדירים מאגרי צמתים ייעודיים
nodeSelector.apigeeRuntime.value	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: apigee-runtime תרשים: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost ‫apigee-runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. תווית של בורר צמתים ערך לטירגוט צמתי Kubernetes לשירותי זמן ריצה של Apigee. איך מגדירים מאגרי צמתים ייעודיים
nodeSelector.requiredForScheduling	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: true תרשים: apigee-operator, apigee-datastore, apigee-telemetry, apigee-redis, apigee-ingress-manager, apigee-org, apigee-env, apigee-virtualhost ערך ברירת המחדל של המאפיין requiredForScheduling הוא true. כשמגדירים את התווית true, המשמעות היא שאם Kubernetes לא יכול למצוא צמתים עם מפתח/ערך התווית שהוגדרו , לא תתבצע הקצאה של קבוצות ה-Pod הבסיסיות לצמתים של מכונות וירטואליות מסוג worker. בגרסת הייצור, צריך להגדיר את 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 Secrets in the Kubernetes documentation יצירת סוד באמצעות 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.16.10 תרשים: apigee-redis תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.envoy.image.url	Advanced	הוצג בגרסה: 1.6.0 ערך ברירת מחדל: ללא תרשים: apigee-redis המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
redis.envoy.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-redis מספר המינימום של פודים של Redis Envoy שצריכים להישאר זמינים במהלך שיבוש מרצון, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-redis המספר המקסימלי של פודים של Redis Envoy שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (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.16.10 תרשים: apigee-redis תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.image.url	Advanced	הוצג בגרסה: 1.6.0 ערך ברירת מחדל: ללא תרשים: apigee-redis המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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 QPS. עם ליבה 1.0, בדרך כלל אפשר לטפל ב-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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-redis נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-redis התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-redis התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
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 חלון הזמן שבו המדיניות צריכה להיות בתוקף כשמצמצמים את אחוז המופעים של זמן הריצה.
runtime.hpaBehavior.scaleDown.percent.value	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת המחדל: 20 תרשים: apigee-env השינוי המותר על ידי המדיניות כשמצמצמים את מספר המופעים של זמן הריצה באחוז מסוים.
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 ערך ברירת מחדל: Min תרשים: apigee-env ההחלטה שמתקבלת על ידי הכלי לשינוי גודל אוטומטי בין כמה כללי מדיניות לשינוי גודל אוטומטי. הגדרת הערך ל-Min מאפשרת את השינוי הקטן ביותר בהקטנת מספר המופעים בזמן הריצה. הגדרת הערך ל-Max מאפשרת את השינוי הגדול ביותר בהקטנת מספר המופעים בזמן הריצה.
runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds	Advanced	הוצג בגרסה: 1.7.0 ערך ברירת המחדל: 120 תרשים: apigee-env מספר השניות שבהן המלצות קודמות צריכות להילקח בחשבון במהלך צמצום אנכי בהתאם לעומס.
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 אחוז הניצול הרצוי של המעבד בכל מופעי זמן הריצה.
runtime.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1.16.10 תרשים: apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
runtime.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-env המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המינימלי של פודים של זמן ריצה שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה ל-pods של זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: runtime: podDisruptionBudget: minAvailable: "50%"
runtime.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של זמן ריצה שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה ל-pods של זמן הריצה בסביבה ספציפית, משתמשים ב-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 החדש לצד הקיים ומעביר אליו את תנועת הגולשים בשלבים לפני הקטנת ה-ReplicaSet הישן. השיטה הזו מאפשרת העברת תנועה בשלבים, אבל באופן זמני נדרש מרווח נוסף לחישוב (עד פי שניים בערך ממספר הפודים במצב יציב) במהלך ההפצה. מומלץ לרוב סביבות הייצור. ‫scale-down-first: מחליף פודים אחד בכל פעם, ומרוקן פוד קיים לפני שהוא יוצר את הפוד שיחליף אותו. מכיוון שכל החלפה היא אחת לאחת, מספר הפודים בגרסה נשאר קבוע ולא נדרש עודף קיבולת חישובית. אפשר להשתמש בזה לאשכולות ללא שינוי גודל אוטומטי של הצמתים, כמו התקנות עם מגבלות חומרה או התקנות Bare-metal. ההשקות איטיות יותר ולא כוללות העברת תנועה מדורגת. ‫none: מעבר מיידי ל-ReplicaSet החדש ללא העברת תנועה מדורגת.
runtime.replicaCountMax	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 4 תרשים: apigee-env המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס. אם משתמשים במגבלות משופרות של שרת proxy לכל סביבה, המגבלה הזו תחול על כל ערכות השכפול בסביבה. כל קבוצת עותקים עדיין תתבצע באופן אוטומטי בנפרד.
runtime.replicaCountMin	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1 תרשים: apigee-env מספר הרפליקות המינימלי שזמין להתאמה אוטומטית לעומס. אם משתמשים במגבלות משופרות של שרת proxy לכל סביבה, המגבלה הזו תחול על כל ערכות השכפול בסביבה. כל קבוצת שכפולים עדיין תבצע שינוי גודל אוטומטי באופן עצמאי.
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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-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 המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות. הערה: כדי להשיג שינוי גודל אוטומטי חלק של מעבדי ההודעות כדי להתאים לעלייה בתנועה, מומלץ לא לחרוג משני ליבות (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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-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) שרוצים להשיג בתהליך של זמן הריצה בתא. הערך של השדה הזה מאפשר לסביבת זמן הריצה לבצע התאמה אוטומטית לעומס כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
runtime.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 3600 תרשים: apigee-env הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-env נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

securityContext

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

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

synchronizer

הכלי מוודא שמעבדי ההודעות מתעדכנים בחבילות העדכניות ביותר של proxy ל-API שנפרסו. לשם כך, הכלי לסנכרון שולח שאילתות למישור הניהול. כשמזוהה חוזה חדש, הכלי לסנכרון שולח אותו למישור זמן הריצה. כברירת מחדל, 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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
synchronizer.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: IfNotPresent תרשים: apigee-env קובעת מתי kubelet מושך את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: התמונה תמיד תימשך, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
synchronizer.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 1.16.10 תרשים: apigee-env תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
synchronizer.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא תרשים: apigee-env המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-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.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env מספר המינימלי של פודים של מסנכרן שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה ל-pods של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: synchronizer: podDisruptionBudget: minAvailable: "50%"
synchronizer.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של סנכרון שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה ל-pods של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.maxUnavailable. לדוגמה, ב-overrides.yaml: synchronizer: podDisruptionBudget: maxUnavailable: 1
synchronizer.pollInterval	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 60 תרשים: apigee-env פרק הזמן שהכלי Synchronizer ממתין בין פעולות של דגימה. ה-Synchronizer מבצע בדיקות בשירותי מישור הבקרה של 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 מספר הרפליקות המקסימלי להרחבה אוטומטית.
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 המעבד שנדרש לפעולה רגילה של המשאב במאגר 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 Manager.
synchronizer.serviceAccountRef	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא תרשים: apigee-env חובה לציין את serviceAccountPath או את serviceAccountRef. הפניה לסוד ב-Kubernetes לקובץ מפתח של חשבון שירות ב-Google. מידע נוסף זמין במאמר בנושא אחסון מפתחות של חשבונות שירות בסודות של Kubernetes.
synchronizer.serviceAccountSecret	בסיסי	הוצג בגרסה: 1.1.0 ערך ברירת מחדל: ללא תרשים: apigee-env השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google עם התפקיד Apigee Synchronizer Manager כקלט.
synchronizer.targetCPUUtilizationPercentage	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 75 תרשים: apigee-env שיעור הניצול של המעבד (CPU) שמוגדר לטרגוט בתהליך Synchronizer ב-pod. הערך בשדה הזה מאפשר ל-Synchronizer לבצע התאמה אוטומטית לעומס כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
synchronizer.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: 30 תרשים: apigee-env הזמן המקסימלי שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל תהליך פעיל יסתיים בצורה תקינה. ה-pod יושבת כשכל התהליכים הפועלים יסתיימו או בסוף תקופת החסד, לפי המוקדם מביניהם. אם אין תהליכים פעילים, ה-Pod יושבת באופן מיידי.
synchronizer.tolerations.effect	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts.
synchronizer.tolerations.key	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
synchronizer.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-env נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
synchronizer.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
synchronizer.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-env התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

virtualhosts

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

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

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

מאפיין (property)	סוג	תיאור
virtualhosts[].additionalGateways	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא תרשים: apigee-virtualhost רשימה של שערים (Gateways) של Istio להפניית תעבורה אליהם.
virtualhosts[].cipherSuites[]	Advanced	הוצג בגרסה: 1.9.2 ערך ברירת מחדל: ללא תרשים: apigee-virtualhost המאפיין הזה מגדיר את קודי ההצפנה של TLS שמשמשים בשער הכניסה. הערה: המאפיין הזה מבטל את רשימת חבילות ההצפנה המופעלות, ולא מוסיף לה. הערכים של virtualhosts.cipherSuites צריכים להיות בפורמט OpenSSL. בהמשך מופיעה רשימה של צפנים נתמכים בפורמט OpenSSL. מידע נוסף על הצפנות הנתמכות זמין במסמכי התיעוד של Boring FIPS build of Envoy. ערך ריק יוגדר כברירת מחדל לסוויטות ההצפנה שנתמכות על ידי גרסת ה-FIPS של Envoy. ‫TLS v1.3: מופעל כברירת מחדל חבילות הצפנה נוספות TLS_AES_128_GCM_SHA256 TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 אי אפשר לשנות את הגדרות TLS 1.3 ciperhsuites. ‫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" ... הערה: הנכס הזה מבטל את רשימת חבילות ההצפנה שנתמכות על ידי Envoy, ולא מוסיף לה. הערה: המאפיין virtualhosts.cipherSuites משתמש בפורמט של סט האלגוריתמים להצפנה (cipher suite) של OpenSSL. רשימת הצפנות עם השמות שלהן בפורמט OpenSSL ובפורמט IANA מופיעה במאמר Translating OpenSSL cipher suite names to IANA (תרגום שמות של חבילות הצפנה של OpenSSL ל-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" מייצג את גרסת ה-TLS של Istio‏ 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" מייצג את גרסת ה-TLS של Istio‏ TLSV1_2. מידע נוסף זמין ב ServerTLSSettings במאמרי העזרה של Istio.
virtualhosts[].requestTimeout	בסיסי	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: 300 תרשים: apigee-virtualhost מספר השניות שאחריהן הבקשה תפוג. הערך המינימלי הוא 1.
virtualhosts[].selector	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: app: apigee-ingressgateway תרשים: apigee-virtualhost חובה צמד של מפתח-ערך של סלקטור כדי להפנות לסלקטורים שונים של תעבורת כניסה. ‫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 Secrets in the Kubernetes documentation יצירת סוד באמצעות 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 מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-Pods. מידע נוסף מופיע במאמר בנושא הערות מותאמות אישית.
watcher.args.enableIssueScanning	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: true תרשים: apigee-org הפעלה או השבתה של חשיפת בעיות אוטומטית. כש-true מופעל, הוא סורק באופן אוטומטי את מצב מישור הבקרה ואת שרת ה-API של Kubernetes כדי לקבוע אם יש בעיות בהגדרות. מגדירים את הערך false כדי להשבית את התכונה 'הצגת בעיות באופן אוטומטי'. מידע נוסף מופיע במאמר בנושא חשיפת בעיות באופן אוטומטי.
watcher.args.enableLeaderElect	Advanced	הוצג בגרסה: 1.13.0 ערך ברירת מחדל: true תרשים: apigee-org כשבוחרים באפשרות true (ברירת המחדל) watcher.args.enableLeaderElect נבחר פוד צופה יחיד לניהול ולדיווח של פרטי הניתוב. כדי למנוע השבתה במהלך שדרוגים או חזרה לגרסה קודמת, צריך להגביל את זה לפוד אחד. במהלך האירועים האלה, יכולות לפעול כמה גרסאות של watcher בו-זמנית. לכל מופע של Watcher יכולה להיות לוגיקה שונה ליצירת מסלולים, מה שיכול לגרום להשבתה.watcher.replicaCountMax.
watcher.args.issueScanInterval	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: 60 תרשים: apigee-org המרווח בשניות שקובע את התדירות שבה Watcher סורק את מישור זמן הריצה כדי לזהות בעיות באופן אוטומטי. מידע נוסף מופיע במאמר בנושא חשיפת בעיות באופן אוטומטי.
watcher.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא תרשים: apigee-org ב-Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-watcher 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.
watcher.image.pullPolicy	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: IfNotPresent תרשים: apigee-org קובעת מתי kubelet מושך את קובץ האימג' של Docker של ה-Pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: התמונה תמיד תימשך, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
watcher.image.tag	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: 1.16.10 תרשים: apigee-org תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
watcher.image.url	Advanced	הוצג בגרסה: 1.4.0 ערך ברירת מחדל: ללא תרשים: apigee-org המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר של הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
watcher.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של watcher שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את minAvailable ואת maxUnavailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.16.10 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של צופים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הערך יכול להיות מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להגדיר את maxUnavailable ואת minAvailable ביחד, צריך להגדיר רק אחד מהם. האופרטור של Apigee דוחה הגדרה של שניהם בו-זמנית. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: maxUnavailable: 1
watcher.replicaCountMax	בסיסי	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: 1 תרשים: apigee-org המספר המקסימלי של רפליקות של רכיב Watcher. כדי למנוע התנגשויות, צריך להגדיר את הערך הזה ל-1. ב-Apigee Hybrid נעשה שימוש בפוד watcher אחד לכל התקנה. בחירת מנהיג בוחרת באופן אוטומטי פוד אחד של צופה. עותקים משוכפלים נוספים של פודים של Watcher ייכפו למצב לא יציב. מידע נוסף זמין במאמר בנושא watcher.args.enableLeaderElect. אזהרה: אל תחרגו מהערך 1 במאפיין watcher.replicaCountMax.
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 Runtime Agent.
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 מזהה את ה-Pod-ים שאליהם אפשר להחיל את הטולרנטיות. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: "Equal" תרשים: apigee-org נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך של Equal זהה לערך שמוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫tolerationSeconds מגדיר בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא תרשים: apigee-org התכונה הזו משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.