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

הגרסה הנוכחית של מסמכי התיעוד של Apigee Hybrid היא 1.15 . למידע נוסף, ראו גרסאות נתמכות.

Version 1.15 

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

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

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

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

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

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

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

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

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

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

mart:
    replicaCountMin: 3
    replicaCountMax: 6

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

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

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

סינון הדף הזה

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

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

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

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

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

מאפיין (property)	סוג	תיאור
axHashSalt	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: iloveapis123 אופציונלי השם של סוד של Kubernetes שמכיל ערך salt שמשמש לחישוב גיבובים כדי להסתיר נתוני משתמשים לפני שהם נשלחים לניתוח ב-Apigee. אם לא מציינים ערך salt, המערכת משתמשת ב-iloveapis123 כברירת מחדל. יוצרים את הסוד עם ערך ה-salt כקלט. אפשר להשתמש באותו ערך גיבוב (salt) בכמה אשכולות כדי להבטיח תוצאות גיבוב עקביות בין האשכולות. ‫Apigee משתמשת ב-SHA512 כדי לגבב את הערך המקורי לפני שליחת הנתונים ממישור זמן הריצה למישור הבקרה. מידע נוסף זמין במאמר הסתרת נתוני משתמשים לצורך ניתוח.
contractProvider	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: https://apigee.googleapis.com מגדיר את נתיב ה-API לכל ממשקי ה-API בהתקנה. נדרש אם בהתקנה ההיברידית נעשה שימוש במיקום אחסון הנתונים בפורמט הבא: contractProvider: https://CONTROL_PLANE_LOCATION-apigee.googleapis.com כאשר CONTROL_PLANE_LOCATION הוא המיקום שבו מאוחסנים נתוני מישור הבקרה, כמו חבילות שרת proxy. רשימת האזורים הזמינים של מישור הבקרה של Apigee API לדוגמה: contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled	בסיסי	נוספה בגרסה: 1.14.0 ערך ברירת המחדל: true הפעלת התאמה אוטומטית לעומס (scaling) מבוססת-מדדים של Apigee כשהערך מוגדר ל-true (ברירת המחדל). מגדירים את הערך false כדי להשבית את ההתאמה האישית של הגודל. כדי להחיל שינויים על customAutoscaling.enabled, צריך לעדכן את התרשים של apigee-telemetry.
enhanceProxyLimits	Advanced	נוספה בגרסה: 1.14.0 ערך ברירת המחדל: false חובה ההרשאה enhanceProxyLimits נדרשת לתכונה "מגבלות משופרות לשרתי proxy לכל סביבה" של Apigee. צריך להגדיר את האפשרות הזו ל-enhanceProxyLimits: true אם הארגון ההיברידי שלך זכאי למגבלות משופרות של שרתי proxy לכל סביבה. הערה: התכונה הזו זמינה כחלק מתוכנית המינויים של 2024. אפשר לעיין במאמרים הבאים: מגבלות על שרתי proxy ל-API. מגבלות משופרות על שרתי proxy לכל סביבה. הרשאות מינוי. ההגדרה enhanceProxyLimits: true נדרשת לשרשור שרתי proxy, לשרשור נקודות קצה ולשרשור ServiceCallout. למידע נוסף: שרשור של שרתי proxy ל-API מדיניות ServiceCallout התראה: אל תגדירו את הערך הזה ל-false אחרי שהגדרתם אותו ל-true. מחילים את השינויים על enhanceProxyLimits על ידי עדכון התרשים apigee-org והתרשים apigee-virtualhost לכל קבוצת סביבות.
gcpProjectID	Advanced	Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.projectID. נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה מזהה הפרויקט ב-Google Cloud. הוא פועל עם k8sClusterName (הוצא משימוש) ו-gcpRegion (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics ידחפו את הנתונים שלהם.
gcpRegion	Advanced	Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.region. נוספה בגרסה: 1.0.0 ערך ברירת המחדל: us-central1 חובה האזור או התחום (zone) הקרוב ביותר ב-Google Cloud לאשכול Kubernetes. הוא פועל עם gcpProjectID (הוצא משימוש) ועם k8sClusterName (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics דוחפים את הנתונים שלהם.
hub	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא כתובת ה-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.15.10 imagePullPolicy: IfNotPresent הערה: בגרסאות של Apigee Hybrid שקדמו ל-1.14.2, לרכיבים של צד שלישי היה מזהה ייחודי לגרסת קובץ האימג' של הספק החיצוני. לדוגמה: ## an example of internal component vs 3rd party containers: - name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.15.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 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 ערך ברירת המחדל: ללא שם הסוד של Kubernetes שמוגדר כסוג docker-registry; משמש לשליפת קובצי אימג' ממאגר פרטי.
instanceID	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא חובה מזהה ייחודי של ההתקנה הזו. מחרוזת ייחודית לזיהוי המופע הזה. השם יכול להיות כל שילוב של אותיות ומספרים באורך של עד 63 תווים. אפשר ליצור כמה ארגונים באותו אשכול, אבל הערך של instanceID חייב להיות זהה בכל הארגונים באותו אשכול Kubernetes. בהתקנות במספר אזורים, לכל אזור נדרש אשכול משלו (אשכולות נפרדים לא משתרעים על פני אזורים).
k8sClusterName	Advanced	Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש במקום זאת ב-k8sCluster.name וב-k8sCluster.region. נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא השם של אשכול ה-Kubernetes‏ (K8S) שבו פועל הפרויקט ההיברידי. הוא פועל עם gcpProjectID (הוצא משימוש) ו-gcpRegion (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics דוחפים את הנתונים שלהם.
kmsEncryptionKey	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: defaults.org.kmsEncryptionKey אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. הנתיב במערכת הקבצים המקומית למפתח ההצפנה של נתוני KMS ב-Apigee.
kmsEncryptionPath	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים
kmsEncryptionSecret.key	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
kmsEncryptionSecret.name	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. השם של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
kvmEncryptionKey	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: defaults.org.kmsEncryptionKey אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. הנתיב במערכת הקבצים המקומית למפתח ההצפנה של נתוני ה-KVM של Apigee.
kvmEncryptionPath	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים
kvmEncryptionSecret.key	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
kvmEncryptionSecret.name	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אופציונלי. צריך להשתמש רק באחד מהשדות הבאים: kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. השם של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
multiOrgCluster	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: false באשכולות עם כמה ארגונים, המאפיין הזה מאפשר לייצא את המדדים של הארגון לפרויקט שמופיע במאפיין gcp.projectID. צריך להחיל את ההגדרה הזו בקובץ השינויים של כל ארגון באשכול עם כמה ארגונים. למידע נוסף, קראו את המאמר הוספת כמה ארגונים היברידיים לאשכול.
namespace	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigee מרחב השמות של אשכול Kubernetes שבו יותקנו רכיבי Apigee.
org	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה הארגון שמופעלת בו הגרסה ההיברידית, שהוקצה לכם על ידי Apigee במהלך ההתקנה של הגרסה ההיברידית. ארגון הוא מאגר ברמה העליונה ב-Apigee. הוא מכיל את כל שרתי ה-proxy ל-API ומקורות מידע שקשורים לנושא. אם הערך ריק, צריך לעדכן אותו בשם הארגון אחרי שיוצרים אותו.
orgScopedUDCA	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: true הפעלת השירות Universal Data Collection Agent‏ (UDCA) ברמת הארגון, ששולף נתוני ניתוח, מונטיזציה וניפוי באגים (מעקב) ושולח אותם אל Unified Analytics Platform‏ (UAP) שנמצא במישור הבקרה. ב-UDCA ברמת הארגון, משתמשים בחשבון שירות אחד של Google לכל הסביבות של Apigee. לחשבון השירות צריך להיות התפקיד "סוכן Apigee Analytics"‏ (roles/apigee.analyticsAgent). מציינים את הנתיב לקובץ המפתח של חשבון השירות באמצעות המאפיין udca.serviceAccountPath, או מספקים את המפתח בסוד של Kubernetes באמצעות המאפיין udca.serviceAccountRef בקובץ התצורה של overrides.yaml. אם אתם מעדיפים להשתמש בסוכן UDCA נפרד לכל סביבה, הגדירו את orgScopedUDCA: false ואת הערכים של envs[].serviceAccountPaths.udca ו-envs[].serviceAccountSecretRefs.udca. ראו גם: udca.
revision	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: "11510" (גרסת Apigee Hybrid ללא נקודות. לדוגמה, בגרסה 1.12.0, ערך ברירת המחדל הוא "1120".) ‫Apigee hybrid תומך בעדכונים הדרגתיים של Kubernetes, שמאפשרים לעדכן את הפריסה בלי זמן השבתה, על ידי עדכון הדרגתי של מכונות Pod עם מכונות חדשות. כשמעדכנים שינויים מסוימים ב-YAML שגורמים לשינוי ב-Kubernetes PodTemplateSpec הבסיסי, צריך לשנות גם את מאפיין השינוי revision ב-override.yaml של הלקוח. הפעולה הזו נדרשת כדי שבקר ApigeeDeployment (AD)‎ של Kubernetes יוכל לבצע עדכון הדרגתי (rolling) בטוח מהגרסה הקודמת לגרסה החדשה. אפשר להשתמש בכל ערך טקסט באותיות קטנות, למשל: blue,‏ a,‏ 1.0.0 הערה: revision יכול לקבל רק אותיות קטנות, מספרים וסימני פיסוק. כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) של כל הרכיבים שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision: nodeSelector envs imagePullSecrets gcpProjectID k8sClusterName contractProvider org מידע נוסף זמין במאמר עדכונים בהדרגה (rolling).
serviceAccountSecretProviderClass	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא השם של מחלקת ספק הסודות הספציפית לארגון (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault. אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault
validateOrg	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: true מאפשר אימות קפדני של הקישור בין הארגון ב-Apigee לבין הפרויקט ב-Google Cloud, ובודק אם קיימות קבוצות סביבה. מידע נוסף מופיע ב-org.
validateServiceAccounts	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: true הפעלת אימות קפדני של הרשאות לחשבון שירות. הפעולה הזו משתמשת ב-method‏ testIamPermissions של Cloud Resource Manager API כדי לוודא שלחשבון השירות שצוין יש את ההרשאות הנדרשות. במקרה של חשבונות שירות של ארגון ב-Apigee, מזהה הפרויקט שנבדק הוא זה שממופה לארגון. ב-Metrics וב-Logger, הפרויקט שנבדק מבוסס על ההגדרה של gcpProjectID overrides.yaml. מידע נוסף מופיע ב-gcpProjectID.

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 לספק הגדרות ל-Cloud Service Mesh שהלקוח התקין. צריך להגדיר את הערך true להתקנות היברידיות שמשתמשות בשער הכניסה של Apigee. צריך להגדיר את הערך false להתקנות היברידיות באמצעות Cloud Service Mesh (גרסאות Apigee hybrid 1.8‎ וגרסאות קודמות).
ao.args.disableManagedClusterRoles	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: true כשהערך הוא true (ברירת המחדל), Apigee Hybrid לא מנהל ישירות את ClusterRole ו-ClursterRoleBinding של Kubernetes. אם יש לכם תהליך שדורש ניהול של המשאבים האלה, התהליך צריך להתבצע על ידי משתמש עם ההרשאות המתאימות.
ao.image.pullPolicy	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
ao.image.tag	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
ao.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
ao.resources.limits.cpu	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 250m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
ao.resources.limits.memory	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 256Mi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
ao.resources.requests.cpu	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 250m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
ao.resources.requests.memory	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 256Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
ao.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
ao.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ao.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ao.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ao.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

apigeeIngressGateway

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

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

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

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

מאפיין (property)	סוג	תיאור
apigeeIngressGateway.image.pullPolicy	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
apigeeIngressGateway.image.tag	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
apigeeIngressGateway.image.url	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
apigeeIngressGateway.nodeSelector.key	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא חובה מפתח התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי שער כניסה. הגדרת מאגרי צמתים ייעודיים
apigeeIngressGateway.nodeSelector.value	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא ערך אופציונלי של תווית בורר הצמתים, שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי שער כניסה, ולעקיפת ההגדרות של nodeSelector.apigeeData. ראו nodeSelector.
apigeeIngressGateway.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של שער כניסה של Apigee שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לשער ספציפי, משתמשים ב-ingressGateways[].podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: apigeeIngressGateway: podDisruptionBudget: minAvailable: "50%"
apigeeIngressGateway.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של Pods של שער כניסה של Apigee שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לשער ספציפי, משתמשים ב-ingressGateways[].podDisruptionBudget.maxUnavailable. לדוגמה, ב-overrides.yaml: apigeeIngressGateway: podDisruptionBudget: maxUnavailable: 1
apigeeIngressGateway.replicaCountMax	בסיסי	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 4 מספר ה-pods המקסימלי שההיברידי יכול להוסיף באופן אוטומטי לשער הכניסה שזמין להתאמה אוטומטית לעומס.
apigeeIngressGateway.replicaCountMin	בסיסי	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 2 המספר המינימלי של Pods לשער הכניסה שזמינים להתאמה אוטומטית לעומס.
apigeeIngressGateway.targetCPUUtilizationPercentage	Advanced	הושקה בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1 ערך ברירת המחדל: 75 סף השימוש במעבד (CPU) לשינוי מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. כשהשימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר הפודים ב-ReplicaSet, עד ל-apigeeIngressGateway.replicaCountMax. למידע נוסף על התאמה לעומס ב-Kubernetes, קראו את המאמר התאמה אופקית של קבוצות Pod לעומס במסמכי התיעוד של Kubernetes.
apigeeIngressGateway.tolerations.effect	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
apigeeIngressGateway.tolerations.key	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
apigeeIngressGateway.tolerations.operator	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
apigeeIngressGateway.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
apigeeIngressGateway.tolerations.value	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

cassandra

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

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

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

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

מאפיין (property)	סוג	תיאור
cassandra.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
cassandra.auth.admin.password	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של האדמין ב-Cassandra. המשתמש עם הרשאת אדמין משמש לכל פעולות הניהול שמתבצעות באשכול Cassandra, כמו גיבוי ושחזור.
cassandra.auth.ddl.password	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש בשפת הגדרת הנתונים (DDL) של Cassandra. משמש את MART לכל אחת ממשימות הגדרת הנתונים, כמו יצירה, עדכון ומחיקה של מרחב מפתחות.
cassandra.auth.default.password	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה למשתמש ברירת המחדל של Cassandra שנוצר כשהאימות מופעל. צריך לאפס את הסיסמה הזו כשמגדירים אימות של Cassandra. מידע נוסף זמין במאמר הגדרת TLS ל-Cassandra.
cassandra.auth.dml.password	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש בשפת הטיפול בנתונים (DML) של Cassandra. משתמש ה-DML משמש את הלקוח לתקשורת כדי לקרוא ולכתוב נתונים ב-Cassandra.
cassandra.auth.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
cassandra.auth.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.auth.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
cassandra.auth.jmx.password	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש בפעולות Cassandra JMX. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.
cassandra.auth.jmx.username	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: jmxuser חובה שם המשתמש של המשתמש בפעולות Cassandra JMX. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.
cassandra.auth.jolokia.password	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש בפעולות Cassandra Jolokia JMX. משמש לאימות ולתקשורת עם Cassandra JMX API.
cassandra.auth.jolokia.username	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: apigee חובה שם המשתמש של Cassandra Jolokia JMX. משמש לאימות ולתקשורת עם Cassandra JMX API.
cassandra.auth.secret	בסיסי	נוספה בגרסה: 1.3.3 ערך ברירת המחדל: ללא שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
cassandra.auth.secretProviderClass	Advanced	נוסף בגרסה: 1.10.3 ערך ברירת המחדל: ללא מדיניות האחסון הסודית של 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 השם של ספק הגיבוי. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך: GCP כדי לאחסן ארכיוני גיבוי ב-Google Cloud Storage. ‫HYBRID כדי לאחסן ארכיוני גיבוי בשרת SSH מרוחק. CSI (מומלץ) כדי להשתמש ב-Volume Snapshots של Kubernetes CSI לגיבוי. למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, קראו את המאמר גיבוי ושחזור של CSI.
cassandra.backup.dbStorageBucket	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP. השם של קטגוריה קיימת ב-Google Cloud Storage שתשמש לאחסון ארכיוני הגיבוי. אם אתם צריכים ליצור קטגוריה, תוכלו להיעזר במאמר יצירת קטגוריות. הערה: החל מגרסה 1.13 של Hybrid, לא צריך להוסיף את הקידומת gs:// לשם הקטגוריה. התמיכה בקידומת הזו הוצאה משימוש ותוסר בגרסאות עתידיות.
cassandra.backup.enabled	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: false גיבוי הנתונים לא מופעל כברירת מחדל. כדי להפעיל, צריך להגדיר את הערך true. גיבוי ושחזור של Cassandra
cassandra.backup.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-cassandra Google IAM‏ (GSA) שצריך לשייך לחשבון השירות של Cassandra backup Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.backup.enabled לערך true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" איך מפעילים את איחוד הזהויות של עומסי עבודה ב-GKE
cassandra.backup.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
cassandra.backup.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.backup.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
cassandra.backup.keyfile	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID. הנתיב במערכת הקבצים המקומית לקובץ המפתח הפרטי של SSH.
cassandra.backup.schedule	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 2 * * * לוח הזמנים של משימת ה-cron לגיבוי. גיבוי ושחזור של Cassandra
cassandra.backup.server	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID. כתובת ה-IP של שרת הגיבוי המרוחק של SSH.
cassandra.backup.serviceAccountPath	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא הנתיב לקובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים ב-Storage‏ (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להעלאת ארכיוני גיבוי אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage לצורך העלאת ארכיוני הגיבוי: הערך שצוין: cassandra.backup.serviceAccountPath. הערך שצוין: cassandra.backup.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.backup.serviceAccountRef	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקטים באחסון (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להעלאת ארכיוני גיבוי אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא GCP, צריך לבצע את אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage לצורך העלאת ארכיוני הגיבוי: הערך שצוין: cassandra.backup.serviceAccountPath. הערך שצוין: cassandra.backup.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.backup.storageDirectory	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא חובה אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider הוא HYBRID. יכול להיות נתיב מוחלט או נתיב יחסי לספריית הבית של המשתמש ב-apigee. השם של ספריית הגיבוי בשרת ה-SSH לגיבוי.
cassandra.clusterName	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigeecluster מציין את השם של אשכול Cassandra. הערה: בהתקנות במספר אזורים, הערך של clusterName צריך להיות זהה בכל האזורים.
cassandra.datacenter	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: dc-1 מציין את מרכז הנתונים של צומת Cassandra.
cassandra.dnsPolicy	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא הערה: ב-Apigee hybrid v1.3, המאפיין הזה כבר לא נתמך. כשמגדירים את hostNetwork כ-true, מדיניות ה-DNS מוגדרת כ-ClusterFirstWithHostNet.
cassandra.externalSeedHost	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא שם המארח או כתובת ה-IP של צומת באשכול Cassandra. אם לא מגדירים את המדיניות, המערכת משתמשת בשירות המקומי של Kubernetes.
cassandra.heapNewSize	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 100M כמות הקצאת זיכרון המערכת של JVM שמוקצית לאובייקטים חדשים יותר, במגה-בייט.
cassandra.hostNetwork	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: false הפעלת התכונה hostNetwork של Kubernetes. ‫Apigee משתמשת בתכונה הזו בהתקנות במספר אזורים כדי לתקשר בין פודים אם למרחב השמות של רשת הפודים אין קישוריות בין אשכולות (האשכולות פועלים ב-"island network mode"), שזה המצב שמוגדר כברירת מחדל בהתקנות שהן לא GKE, כולל Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. מגדירים את cassandra.hostNetwork לערך false בהתקנות באזור יחיד ובהתקנות במספר אזורים עם קישוריות בין Pods באשכולות שונים, למשל התקנות של GKE. מגדירים את cassandra.hostNetwork לערך true בהתקנות במספר אזורים שאין בהן תקשורת בין Pods באשכולות שונים, למשל התקנות של Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. פריסה בכמה אזורים: דרישות מוקדמות כשמגדירים את true, מדיניות ה-DNS מוגדרת אוטומטית ל-ClusterFirstWithHostNet.
cassandra.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
cassandra.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
cassandra.maxHeapSize	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 512M הגבול העליון של זיכרון המערכת של JVM שזמין לפעולות של Cassandra, במגה-בייט.
cassandra.multiRegionSeedHost	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא כתובת ה-IP של אשכול Cassandra קיים שמשמש להרחבת האשכול הקיים לאזור חדש. הגדרת מארח ה-seed במספר אזורים
cassandra.nodeSelector.key	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי הנתונים של cassandra. הגדרת מאגרי צמתים ייעודיים
cassandra.nodeSelector.value	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא ערך אופציונלי של תווית בורר הצמתים, שמשמש לטירגוט צמתים ייעודיים של Kubernetes לשירותי הנתונים של cassandra, ולעקיפת ההגדרות של nodeSelector.apigeeData. ראו nodeSelector.
cassandra.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-datastore המספר המינימלי של פודים של Cassandra שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: cassandra: podDisruptionBudget: minAvailable: "50%"
cassandra.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-datastore המספר המקסימלי של פודים של Cassandra שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: cassandra: podDisruptionBudget: maxUnavailable: 1
cassandra.port	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 9042 מספר היציאה שמשמשת לחיבור ל-Cassandra.
cassandra.rack	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ra-1 מציין את המדף של צומת Cassandra.
cassandra.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
cassandra.readinessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת מוכנות.
cassandra.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 10 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
cassandra.readinessProbe.successThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
cassandra.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
cassandra.replicaCount	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 ‫Cassandra הוא מסד נתונים משוכפל. המאפיין הזה מציין את מספר הצמתים של Cassandra שמועסקים כ-StatefulSet. הערה: ערך ברירת המחדל של 1 מתאים רק להתקנות של הדגמה או בדיקה. בהתקנות בסביבת ייצור, הערך של replicaCount חייב להיות כפולה של 3. כדי לקבוע את הערך הרצוי של replicaCount, צריך להביא בחשבון את הדברים הבאים: מעריכים את נפח התנועה הנדרש לשרתי ה-Proxy. מבצעים בדיקת עומסים ומבצעים חיזויים סבירים של ניצול המעבד (CPU). אפשר לציין ערכים שונים של replicaCount באזורים שונים. אפשר להרחיב את replicaCount בעתיד בקובץ השינויים.
cassandra.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
cassandra.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1Gi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
cassandra.restore.cloudProvider	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: GCP השם של ספק השחזור. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך: ‫GCP כדי לשחזר נתונים מגיבוי שמאוחסן ב-Google Cloud Storage. ‫HYBRID כדי לשחזר נתונים מגיבוי שמאוחסן בשרת SSH מרוחק. ‫CSI (מומלץ) כדי להשתמש ב-Volume Snapshots של Kubernetes CSI לשחזור. למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, קראו את המאמר גיבוי ושחזור של CSI.
cassandra.restore.dbStorageBucket	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה אם השחזור מופעל והערך של cassandra.restore.cloudProvider הוא GCP. השם של קטגוריה ב-Google Cloud Storage שבה מאוחסנים קובצי הגיבוי שמשמשים לשחזור הנתונים. הערה: החל מגרסה 1.13 של Hybrid, לא צריך להוסיף את הקידומת gs:// לשם הקטגוריה. התמיכה בקידומת הזו הוצאה משימוש ותוסר בגרסאות עתידיות.
cassandra.restore.enabled	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: false כברירת מחדל, שחזור הנתונים לא מופעל. כדי להפעיל, צריך להגדיר את הערך true. גיבוי ושחזור של Cassandra
cassandra.restore.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-cassandra Google IAM‏ (GSA) שצריך לשייך לחשבון השירות של Cassandra לשחזור ב-Kubernetes כשמפעילים את Workload Identity באשכולות GKE. צריך להגדיר את זה כשהגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.restore.enabled לערך true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" איך מפעילים את Workload Identity ב-GKE
cassandra.restore.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
cassandra.restore.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.restore.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
cassandra.restore.serviceAccountPath	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא הנתיב לקובץ מפתח של חשבון שירות ב-Google עם התפקיד אדמין של אובייקטים ב-Storage‏ (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין. אם השחזור מופעל והערך של cassandra.restore.cloudProvider הוא GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להוריד את קובצי הגיבוי לשחזור: הערך שצוין: cassandra.restore.serviceAccountPath. הערך שצוין: cassandra.restore.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.restore.serviceAccountRef	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקטים באחסון (roles/storage.objectAdmin). חשבון השירות הזה של Google ישמש להורדת ארכיוני גיבוי מ-cassandra.restore.dbStorageBucket שצוין. אם השחזור מופעל והערך של cassandra.restore.cloudProvider הוא GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא של-Apigee Hybrid יש גישה לקטגוריה של Google Cloud Storage כדי להוריד את קובצי הגיבוי לשחזור: הערך שצוין: cassandra.restore.serviceAccountPath. הערך שצוין: cassandra.restore.serviceAccountRef. הגדרתם את Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ל-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.restore.snapshotTimestamp	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה אם השחזור מופעל. חותמת הזמן של הגיבוי שצריך לשחזר.
cassandra.storage.capacity	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 10Gi חובה אם צוין המאפיין storage.storageclass מציינת את גודל הדיסק הנדרש, במגה-בייט (Mi) או בגיגה-בייט (Gi).
cassandra.storage.storageclass	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא מציין את סוג האחסון המקומי שבו משתמשים.
cassandra.storage.storageSize	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 10Gi חובה אם צוין המאפיין storage.storageclass מציינת את גודל הדיסק הנדרש, במגה-בייט (Mi) או בגיגה-בייט (Gi).
cassandra.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 300 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
cassandra.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
cassandra.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
cassandra.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
cassandra.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
cassandra.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

certManager

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

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

מאפיין (property)	סוג	תיאור
certManager.namespace	Advanced	נוסף בגרסה: 1.9.0 ערך ברירת המחדל: cert-manager מרחב השמות של cert-manager. הפעלת cert-manager במרחב שמות בהתאמה אישית

connectAgent

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

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

מאפיין (property)	סוג	תיאור
connectAgent.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
connectAgent.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM‏ (GSA) ש-connectAgent ישייך לחשבון השירות התואם של Kubernetes, כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. הערה: connectAgent משתמש בחשבון השירות apigee-mart. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
connectAgent.logLevel	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: INFO רמת הדיווח ביומן. הערכים יכולים להיות: ‫INFO: הודעות מידע בנוסף להודעות אזהרה, שגיאה וקריסה. האפשרות הזו שימושית בעיקר לניפוי באגים. ‫WARNING: אזהרות לא קריטיות בנוסף להודעות שגיאה והודעות קריטיות. ‫ERROR: שגיאות פנימיות ושגיאות שלא מוחזרות למשתמש, בנוסף להודעות על שגיאות חמורות. ‫FATAL: שגיאות שבעקבותיהן אי אפשר לשחזר ואירועים שגורמים לקריסה של Apigee Connect.
connectAgent.image.pullPolicy	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
connectAgent.image.tag	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
connectAgent.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
connectAgent.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של סוכני חיבורים ב-Apigee שצריכים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של Pods של סוכני Apigee Connect שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: maxUnavailable: 1
connectAgent.replicaCountMax	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 5 המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.
connectAgent.replicaCountMin	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס. בסביבת הייצור, יכול להיות שתרצו להגדיל את הערך של replicaCountMin ל-1, כדי שיהיו יותר חיבורים למישור הבקרה לצורך אמינות וסקלביליות.
connectAgent.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 512m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
connectAgent.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 512Mi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
connectAgent.resources.requests.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 100m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
connectAgent.resources.requests.memory	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 30Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
connectAgent.server	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: apigeeconnect.googleapis.com:443 המיקום של השרת והיציאה של השירות הזה.
connectAgent.serviceAccountPath	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google, עבור חשבון השירות apigee-mart. ברוב ההתקנות, הערך של connectAgent.serviceAccountPath צריך להיות זהה לערך של mart.serviceAccountPath.
connectAgent.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes ברוב ההתקנות, הערך של connectAgent.serviceAccountRef צריך להיות זהה לערך של mart.serviceAccountRef.
connectAgent.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 75 ניצול יעד של המעבד (CPU) לסוכן Apigee Connect ב-pod. הערך של השדה הזה מאפשר ל-Apigee Connect לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
connectAgent.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 600 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
connectAgent.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
connectAgent.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
connectAgent.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
connectAgent.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
connectAgent.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

defaults

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

הערה: צריך לעדכן את הפרטים האלה בהתאם להתקנה שלכם.

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

מאפיין (property)	סוג	תיאור
defaults.org.kmsEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw== מפתח ההצפנה שמוגדר כברירת מחדל לארגון ב-KMS.
defaults.org.kvmEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw== מפתח ההצפנה שמוגדר כברירת מחדל לארגון ב-KVM.
defaults.env.kmsEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw== מפתח הצפנה שמוגדר כברירת מחדל לסביבה (env) ב-KMS.
defaults.env.kvmEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw== מפתח הצפנה שמוגדר כברירת מחדל לסביבה (env) ב-KVM.
defaults.env.cacheEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: aWxvdmVhcGlzMTIzNDU2Nw== מפתח הצפנה שמוגדר כברירת מחדל למטמון של הסביבה (env).

envs

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

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

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

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

מאפיין (property)	סוג	תיאור
envs[].cacheEncryptionKey	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret. מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים
envs[].cacheEncryptionPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret. הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף על הצפנת נתונים
envs[].cacheEncryptionSecret.key	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין אחד מהערכים הבאים: cacheEncryptionKey, cacheEncryptionPath או cacheEncryptionSecret. המפתח של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
envs[].cacheEncryptionSecret.name	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין אחד מהערכים הבאים: cacheEncryptionKey,‏ cacheEncryptionPath או cacheEncryptionSecret. השם של סוד Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף על הצפנת נתונים
envs[].components.runtime.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env אפשר לשנות את הערך של runtime.podDisruptionBudget.minAvailable כדי להגדיר את המספר המינימלי של פודים של סביבת זמן ריצה בסביבה הזו שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-runtime.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: envs: - name: test components: runtime: podDisruptionBudget: minAvailable: "50%"
envs[].components.runtime.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env אפשר לשנות את הערך של runtime.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של פודים של סביבת זמן ריצה בסביבה הזו, שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-runtime.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: envs: - name: test components: runtime: podDisruptionBudget: maxUnavailable: 1
envs[].components.runtime.replicaCountMax	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות runtime.replicaCountMax.
envs[].components.runtime.replicaCountMin	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות runtime.replicaCountMin.
envs[].components.runtime.resources.limits.memory	Advanced	נוסף בגרסה: 1.15.0 ערך ברירת המחדל: ללא מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). חשוב: אם מגדירים את המאפיין הזה לסביבה הזו, Apigee לא משתמש בערכים של: runtime.resources.limits.memory runtime.resources.requests.memory אם מגדירים את המאפיין הזה, צריך להגדיר גם את envs[].components.runtime.resources.requests.memory לסביבה הזו. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB בסביבה הזו, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את envs[].components.runtime.resources.limits.memory ל-‎6Gi. מגדילים את envs[].components.runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
envs[].components.runtime.resources.requests.memory	Advanced	נוסף בגרסה: 1.15.0 ערך ברירת המחדל: ללא הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). חשוב: אם מגדירים את המאפיין הזה לסביבה הזו, Apigee לא משתמש בערכים של: runtime.resources.limits.memory runtime.resources.requests.memory אם מגדירים את המאפיין הזה, צריך להגדיר גם את envs[].components.runtime.resources.limits.memory לסביבה הזו. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB בסביבה הזו, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את envs[].components.runtime.resources.limits.memory ל-‎6Gi. מגדילים את envs[].components.runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
envs[].components.synchronizer.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env אפשר לשנות את הערך של synchronizer.podDisruptionBudget.minAvailable כדי להגדיר את המספר המינימלי של pod של סנכרון בסביבה הזו שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-synchronizer.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: envs: - name: test components: synchronizer: podDisruptionBudget: minAvailable: "50%"
envs[].components.synchronizer.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env אפשר לשנות את הערך של synchronizer.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של פודים של סנכרון בסביבה הזו שלא יהיו זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, הסביבה הזו משתמשת ב-synchronizer.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: envs: - name: test components: synchronizer: podDisruptionBudget: maxUnavailable: 1
envs[].components.synchronizer.replicaCountMax	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות synchronizer.replicaCountMax.
envs[].components.synchronizer.replicaCountMin	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות synchronizer.replicaCountMin.
envs[].components.udca.replicaCountMax	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling). אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות udca.replicaCountMax.
envs[].components.udca.replicaCountMin	בסיסי	נוספה בגרסה: 1.9.3 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות להתאמה אוטומטית לעומס. אם המדיניות הזו מוגדרת, היא מבטלת את המדיניות udca.replicaCountMin.
envs.gsa.runtime	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא 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 ערך ברירת המחדל: ללא 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.udca	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של Google IAM ב-udca, עבור udca ברמת הסביבה, לשיוך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
envs[].hostAliases[]	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא ‫Deprecated: החל מגרסה 1.4 של Hybrid, מישור זמן הריצה מקבל את המידע הזה ממישור הניהול. מידע נוסף זמין במאמר מידע על סביבות וקבוצות של סביבות.
envs[].httpProxy.host	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא מציינת את שם המארח או את כתובת ה-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 ערך ברירת המחדל: ללא מציינת את היציאה שבה פועל ה-Proxy ל-HTTP. אם המאפיין הזה מושמט, כברירת מחדל נעשה שימוש ביציאה 80 ל-HTTP וביציאה 443 ל-HTTPS.
envs[].httpProxy.scheme	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: HTTPS מציינת את סוג ה-Proxy ל-HTTP, כלומר HTTP או HTTPS. כברירת מחדל, המערכת משתמשת ב-HTTPS.
envs[].httpProxy.username	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.
envs[].httpProxy.password	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא אם שרת ה-proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.
envs[].managementCallsSkipProxy	Advanced	הושק בגרסה: 1.15.1 ערך ברירת המחדל: false בשימוש בשילוב עם envs[].httpProxy. אם מגדירים את הערך true לשרת proxy להעברה ברמת הסביבה, המעקב והניתוח (שמשתמשים ב-googleapis.com) ידלגו על שרת ה-proxy להעברה.
envs[].name	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה שם סביבת Apigee לסנכרון.
envs[].pollInterval	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המרווח שמשמש לדגימת שינויים בסנכרון של הארגון והסביבה, בשניות.
envs[].port	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא מספר יציאת TCP לתנועת HTTPS.
envs[].serviceAccountPaths.runtime	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד סוכן Cloud Trace, בדרך כלל חשבון השירות apigee-runtime. במאמר מידע על חשבונות שירות מפורטים שמות ברירת המחדל של חשבונות השירות והתפקידים שהוקצו להם.
envs[].serviceAccountPaths.synchronizer	בסיסי	נוספה בגרסה: 1.0 ערך ברירת המחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד מנהל Apigee Synchronizer.
envs[].serviceAccountPaths.udca	בסיסי	נוספה בגרסה: 1.0 ערך ברירת המחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד סוכן ניתוח נתונים של Apigee. צריך להגדיר את המאפיין הזה רק אם המאפיין orgScopedUDCA מוגדר לערך false.
envs[].serviceAccountSecretProviderClass	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא השם של מחלקת ספק הסודות הספציפית לסביבה (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault. אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault
envs[].serviceAccountSecretRefs.runtime	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: ללא השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google עם התפקיד סוכן Cloud Trace כקלט.
envs[].serviceAccountSecretRefs.synchronizer	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google, עם התפקיד Apigee Synchronizer Manager כקלט.
envs[].serviceAccountSecretRefs.udca	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google, עם התפקיד Apigee Analytic Agent כקלט. צריך להגדיר את המאפיין הזה רק אם המאפיין orgScopedUDCA מוגדר לערך false.
envs[].sslCertPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין את sslCertPath/sslKeyPath או את sslSecret. הנתיב במערכת לקובץ של אישור TLS. הערה: בכל סביבה שהוגדרה, השם הנפוץ (CN) באישור חייב להיות תואם לדומיין במאפיין hostAliases[]. לדוגמה, אם ה-CN הוא *.example.com, ה-hostAliases[] יכול להיות foo.example.com או bar.example.com.
envs[].sslKeyPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. הנתיב במערכת לקובץ המפתח הפרטי של TLS.
envs[].sslSecret	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין את sslCertPath/sslKeyPath או את sslSecret. שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את שמות המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes

gcp

מזהה את הפרויקט ב-Google Cloud (חובה בכל ההתקנות ההיברידיות), את ההגדרות של Workload Identity ושל איחוד שירותי אימות הזהות של עומסי עבודה, ואת האזור שאליו apigee-logger ו-apigee-metrics שולחים את הנתונים שלהם.

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

מאפיין (property)	סוג	תיאור
gcp.federatedWorkloadIdentity.audience	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא הקהל המורשה של ספק מאגרי הזהויות של עומסי העבודה בפלטפורמות שאינן GKE. הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS
gcp.federatedWorkloadIdentity.credentialSourceFile	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא שם הקובץ והנתיב לקובץ המקור של פרטי הכניסה שמשמש את איחוד שירותי אימות הזהות של עומסי עבודה כדי לקבל את פרטי הכניסה לחשבונות השירות. זה הערך שצריך לספק ל-credential-source-file כשמגדירים את איחוד שירותי אימות הזהות של עומסי עבודה באמצעות הפקודה create-cred-config. הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS
gcp.federatedWorkloadIdentity.enabled	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: false הפעלת איחוד שירותי אימות הזהות של עומסי עבודה בפלטפורמות שהן לא GKE. אסור להגדיר את true אם gcp.workloadIdentity.enabled מוגדר ל-true באותו אשכול. הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS
gcp.federatedWorkloadIdentity.tokenExpiration	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 3600 משך החיים של האסימון בשניות. הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS
gcp.projectID	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא חובה מזהה את הפרויקט ב-Google Cloud שאליו apigee-logger ו-apigee-metrics מעבירים את הנתונים שלהם.
gcp.projectIDRuntime	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא מזהה את הפרויקט של אשכול Kubernetes בזמן הריצה. המאפיין projectIDRuntime הוא אופציונלי. אם לא משתמשים בו, המערכת מניחה שהערך של projectID משמש גם לפרויקט ב-Google Cloud של הארגון ב-Apigee וגם לפרויקט בענן של אשכול K8s בסביבת זמן הריצה.
gcp.region	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: us-central1 חובה מזהה את האזור ב-Google Cloud שאליו apigee-logger ו-apigee-metrics מעבירים את הנתונים שלהם.
gcp.workloadIdentity.enabled	בסיסי	נוספה בגרסה: 1.10.0 ערך ברירת המחדל:false מאפשר להשתמש באיחוד זהויות של עומסי עבודה ל-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 ערך ברירת המחדל: ללא כתובת האימייל של חשבון השירות של Google IAM‏ (GSA) לכל הרכיבים שצריך לשייך לחשבון השירות התואם של Kubernetes, כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. ‫gcp.workloadIdentity.gsa חלה על כל הרכיבים ההיברידיים. אם מציינים ערך ל-gcp.workloadIdentity.gsa, לא צריך לספק GSA לאף אחד מהרכיבים ההיברידיים הנפרדים. אם תספקו GSA לרכיב ספציפי, ה-GSA של הרכיב הזה יחליף את gcp.workloadIdentity.gsa רק ברכיב הזה. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" Enabling Workload Identity on GKE.
gcp.workloadIdentityEnabled	בסיסי	נוספה בגרסה: 1.4.0 ערך ברירת המחדל:false ‫apigeectl בלבד: מאפשר להשתמש ב-Workload Identity. בעזרת Workload Identity, עומסי עבודה באשכולות GKE יכולים להתחזות לחשבונות שירות של ניהול זהויות והרשאות גישה (IAM) כדי לגשת לשירותי Google Cloud. כשהערך של workloadIdentityEnabled הוא false (ברירת המחדל), Apigee משתמשת בחשבונות השירות של IAM לכל רכיב של Apigee Hybrid. למידע נוסף, קראו את המאמר מידע על חשבונות שירות. כשהערך של workloadIdentityEnabled הוא true, Apigee משתמש בחשבונות שירות של Kubernetes במקום בחשבונות שירות של IAM, ומתעלם ממאפייני ההגדרות הבאים: validateServiceAccounts cassandra.backup.serviceAccountPath cassandra.backup.serviceAccountRef cassandra.restore.serviceAccountPath cassandra.restore.serviceAccountRef envs[].serviceAccountPaths.* logger.serviceAccountPath logger.serviceAccountRef mart.serviceAccountPath mart.serviceAccountRef metrics.serviceAccountPath metrics.serviceAccountRef mintTaskScheduler.serviceAccountPath mintTaskScheduler.serviceAccountRef synchronizer.serviceAccountPath synchronizer.serviceAccountRef udca.serviceAccountPath udca.serviceAccountRef watcher.serviceAccountPath watcher.serviceAccountRef

httpProxy

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

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

ראו גם: connectAgent,‏ logger,‏ mart,‏ metrics,‏ synchronizer ו-udca.

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

מאפיין (property)	סוג	תיאור
httpProxy.host	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא שם המארח של ה-Proxy ל-HTTP.
httpProxy.password	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא אם שרת ה-proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.
httpProxy.port	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא היציאה של ה-Proxy ל-HTTP.
httpProxy.scheme	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: HTTPS הסכמה שבה משתמש שרת ה-proxy. הערכים יכולים להיות HTTP או HTTPS. הערכים חייבים להיות באותיות רישיות בלבד.
httpProxy.useForRuntimeManagement	Advanced	הושק בגרסה: 1.15.1 ערך ברירת המחדל: ללא אם המדיניות useForRuntimeManagement מוגדרת לערך true, נתוני ניפוי הבאגים או הניתוח מנותבים על ידי זמן הריצה באמצעות שרת ה-proxy להעברה הזה. אפשר להגדיר את הדגל הזה גם אם לסביבת זמן הריצה יש הגדרת שרת proxy משלה לסביבה שלה. במקרה כזה, נתוני ניתוח או ניפוי באגים של זמן הריצה ישתמשו בשרת ה-proxy המשותף ברמת הארגון, ואילו תנועת ה-proxy או הקצה העורפי תמשיך להשתמש בשרת ה-proxy ברמת הסביבה (כולל קריאות ל-googleapis.com).
httpProxy.username	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא אם שרת ה-Proxy ל-HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.

ingressGateways

מגדיר כל מופע נפרד של שער הכניסה של Apigee. אפשר להשתמש במאפיינים האלה כשרוצים לנהל מופעים ספציפיים בנפרד באמצעות ingressGateways[].name.

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

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

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

מאפיין (property)	סוג	תיאור
ingressGateways[].name	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: ללא חובה שם שער הכניסה. שירותים אחרים ישתמשו בשם הזה כדי להפנות תנועה לשער. השם צריך לעמוד בדרישות הבאות: להיות באורך של עד 17 תווים להכיל רק תווים אלפאנומריים באותיות קטנות, "-" או "." להתחיל בתו אלפאנומרי להסתיים בתו אלפאנומרי מידע נוסף זמין במאמר שמות של תת-דומיינים ב-DNS במסמכי התיעוד של Kubernetes.
ingressGateways[].podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org אפשר לשנות את הערך של apigeeIngressGateway.podDisruptionBudget.minAvailable כדי להגדיר את מספר הפודים המינימלי של שער ה-Ingress הזה שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, השער הזה משתמש ב-apigeeIngressGateway.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: ingressGateways: - name: my-gateway podDisruptionBudget: minAvailable: "50%"
ingressGateways[].podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org אפשר לשנות את הערך של apigeeIngressGateway.podDisruptionBudget.maxUnavailable כדי להגדיר את המספר המקסימלי של Pods בשער ה-Ingress הזה שלא יהיו זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, השער הזה משתמש ב-apigeeIngressGateway.podDisruptionBudget. אם גם הוא לא מוגדר, מפעיל Apigee מחיל את ברירת המחדל שלו, maxUnavailable: 1. לדוגמה, ב-overrides.yaml: ingressGateways: - name: my-gateway podDisruptionBudget: maxUnavailable: 1
ingressGateways[].resources.limits.cpu	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 2000m מגבלת המעבד (CPU) של המשאב, באלפיות ליבה.
ingressGateways[].resources.limits.memory	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של המשאב, ב-mebibyte.
ingressGateways[].resources.requests.cpu	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 300m המעבד (CPU) שנדרש לפעולה רגילה של המשאב, ב-millicores.
ingressGateways[].resources.requests.memory	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 128Mi הזיכרון שנדרש לפעולה רגילה של המשאב, ב-mebibytes.
ingressGateways[].replicaCountMax	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 10 מספר ה-pods המקסימלי שההיברידי יכול להוסיף באופן אוטומטי לשער הכניסה שזמין להתאמה אוטומטית לעומס.
ingressGateways[].replicaCountMin	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 2 המספר המינימלי של Pods לשער הכניסה שזמינים להתאמה אוטומטית לעומס.
ingressGateways[].svcAnnotations	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: ללא מפה אופציונלית של מפתח/ערך שמשמשת להוספת הערות לשער הכניסה בפלטפורמות שתומכות בהוספת הערות. לדוגמה: ingressGateways: svcAnnotations: networking.gke.io/load-balancer-type: "Internal"
ingressGateways[].svcLoadBalancerIP	בסיסי	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: ללא בפלטפורמות שתומכות בציון כתובת ה-IP של מאזן העומסים, מאזן העומסים ייווצר עם כתובת ה-IP הזו. בפלטפורמות שלא מאפשרות לציין את כתובת ה-IP של מאזן העומסים, המערכת מתעלמת מהמאפיין הזה.
ingressGateways[].svcType	בסיסי	נוספה בגרסה: 1.8.1 ערך ברירת המחדל: LoadBalancer משמש לשינוי הסוג של שירות ברירת המחדל של k8s לפריסת Ingress. כדי להשבית את היצירה של מאזן עומסים כברירת מחדל, מגדירים את הערך ClusterIP. ערכים אפשריים: ClusterIP LoadBalancer
ingressGateways[].targetCPUUtilizationPercentage	Advanced	הושקה בגרסה: 1.10.5, ‏ 1.11.2, ‏ 1.12.1 ערך ברירת המחדל: 75 סף השימוש במעבד (CPU) לשינוי מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. כשהשימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר הפודים ב-ReplicaSet, עד ל-ingressGateways[].replicaCountMax. למידע נוסף על התאמה לעומס ב-Kubernetes, קראו את המאמר התאמה אופקית של קבוצות Pod לעומס במסמכי התיעוד של Kubernetes.
ingressGateways[].tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
ingressGateways[].tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ingressGateways[].tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ingressGateways[].tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
ingressGateways[].tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

istiod

מגדירים את ה-ingress של Apigee.

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

מאפיין (property)	סוג	תיאור
istiod.accessLogFile	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: /dev/stdout כתובת הקובץ של יומן הגישה של Ingress, לדוגמה /dev/stdout. אם הערך הזה לא מוגדר, רישום הגישה מושבת.
istiod.accessLogFormat	Advanced	נוספה בגרסה: 1.8.0 הפורמט של יומן הגישה של Ingress. אם לא מגדירים את הערך הזה, המערכת משתמשת בפורמט ברירת המחדל של יומן הגישה של שרת ה-proxy. פורמט ברירת המחדל של יומן הגישה: '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}' הדוגמה הבאה היא עותק של הפורמט של יומן הגישה שמוגדר כברירת מחדל, עם מעברי שורה שנוספו כדי לשפר את הקריאוּת. '{"start_time":"%START_TIME%", "remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%", "user_agent":"%REQ(USER-AGENT)%", "host":"%REQ(:AUTHORITY)%", "request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%", "request_time":"%DURATION%", "status":"%RESPONSE_CODE%", "status_details":"%RESPONSE_CODE_DETAILS%", "bytes_received":"%BYTES_RECEIVED%", "bytes_sent":"%BYTES_SENT%", "upstream_address":"%UPSTREAM_HOST%", "upstream_response_flags":"%RESPONSE_FLAGS%", "upstream_response_time":"%RESPONSE_DURATION%", "upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%", "upstream_cluster":"%UPSTREAM_CLUSTER%", "x_forwarded_for":"%REQ(X-FORWARDED-FOR)%", "request_method":"%REQ(:METHOD)%", "request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%", "request_protocol":"%PROTOCOL%", "tls_protocol":"%DOWNSTREAM_TLS_VERSION%", "request_id":"%REQ(X-REQUEST-ID)%", "sni_host":"%REQUESTED_SERVER_NAME%", "apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
istiod.forwardClientCertDetails	Advanced	נוסף בגרסה: 1.9.2 ערך ברירת המחדל: SANITIZE_SET קובע איך שרת ה-proxy של Envoy (בשער הכניסה של Apigee) מטפל בכותרת ה-HTTP‏ x-forwarded-client-cert ‏(XFCC). הערכים שאפשר לבחור הם: SANITIZE_SET (ברירת המחדל) כשחיבור הלקוח הוא mTLS, מאפסים את כותרת ה-XFCC עם פרטי אישור הלקוח ושולחים אותה לצעד הבא. ‫FORWARD_ONLY כשחיבור הלקוח הוא mTLS (‏Mutual TLS), מעבירים את כותרת ה-XFCC בבקשה בלבד. ‫APPEND_FORWARD אם חיבור הלקוח הוא mTLS, מוסיפים את פרטי אישור הלקוח לכותרת ה-XFCC של הבקשה ומעבירים אותה. ‫SANITIZE אל תעבירו את הכותרת XFCC. ALWAYS_FORWARD_ONLY תמיד להעביר את כותרת ה-XFCC בבקשה, גם אם חיבור הלקוח הוא לא mTLS. מידע נוסף על הערכים האלה זמין במסמכי התיעוד של Envoy בנושא Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails. אם משנים את ההגדרה הזו אחרי שמתקינים את Hybrid, צריך להחיל אותה באמצעות apigeectl init ואז להפעיל מחדש את הפודים של שער הכניסה של Apigee.
istiod.healthCheckUserAgents	Advanced	נוספה בגרסה: 1.12.0 ערכי ברירת מחדל: - "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)" - "Edge Health Probe" מאפשרת למאזני עומסים שאינםGoogle Cloud לבדוק את נקודות הקצה של בדיקת התקינות של שער הכניסה (/healthz/ingress ו-/healthz) על ידי שינוי רשימת ההיתרים של סוכן המשתמש שמוגדרת כברירת מחדל ב-hybrid. הערה: השימוש במאפיין ההגדרה הזה נתמך רק בהתקנות היברידיות באמצעות תרשימי Helm. אין תמיכה בשימוש בו עם apigeectl. כדי לשנות את סוכני המשתמש שצוינו כברירת מחדל, משתמשים בתחביר הבא ומזינים את סוכני המשתמש בהתאמה אישית: istiod: healthCheckUserAgents: - "CUSTOM_USER_AGENT_1" - "CUSTOM_USER_AGENT_2" כדי להסיר את הדרישה לסוכן משתמש, משתמשים בקוד הבא: istiod: healthCheckUserAgents: [] הערה: כדי שהשינוי ייכנס לתוקף, צריך להפעיל מחדש את ה-pods. משתמשים ב-kubectl rollout restart deployment -n apigee apigee-ingressgateway-manager כדי להפעיל מחדש את ה-pods וב-kubectl rollout status deployment -n apigee apigee-ingressgateway-manager כדי לבדוק את סטטוס ההשקה.
istiod.image.pullPolicy	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
istiod.image.tag	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
istiod.image.url	Advanced	נוספה בגרסה: 1.8.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
istiod.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
istiod.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
istiod.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
istiod.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
istiod.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

k8sCluster

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

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

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

kubeRBACProxy

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

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

מאפיין (property)	סוג	תיאור
kubeRBACProxy.image.pullPolicy	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
kubeRBACProxy.image.tag	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
kubeRBACProxy.image.url	Advanced	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
kubeRBACProxy.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
kubeRBACProxy.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 128Mi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
kubeRBACProxy.resources.requests.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 5m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
kubeRBACProxy.resources.requests.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 64Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.

logger

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

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

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

מאפיין (property)	סוג	תיאור
logger.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
logger.bufferChunkSize	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 256k גודל שטח האחסון הזמני הראשוני לקריאת קובצי יומן.
logger.bufferMaxSize	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 104857600 המגבלה של גודל שטח האחסון הזמני לכל קובץ במעקב. קבצים שחורגים מהמגבלה הזו יוסרו מרשימת הקבצים במעקב.
logger.bufferMemoryLimit	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 150MB מגבלת הזיכרון שהכלי לרישום ביומן יכול לצרוך. אם מגיעים למגבלה, הרישום ביומן מושהה לרגע עד שהנתונים הקיימים נמחקים מהזיכרון.
logger.enabled	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: false הפעלה או השבתה של רישום ביומן באשכול. בסביבות שהן לא GKE, מגדירים את הערך true. ב-GKE ב- Google Cloud או ב-Google Distributed Cloud, מגדירים את הערך false.
logger.envVars	בסיסי	נוסף בגרסה: 1.8.5 ערך ברירת המחדל: ללא מאפשרת לכלול את משתנה הסביבה 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 מרווח הזמן בשניות שצריך להמתין לפני הפעלת הניקוי הבא של המאגר.
logger.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-logger Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
logger.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
logger.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
logger.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
logger.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
logger.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
logger.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 60 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
logger.livenessProbe.successThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת תקינות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
logger.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
logger.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigee.cloud.google.com/apigee-logger-enabled חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן ריצה של logger. הגדרת מאגרי צמתים ייעודיים
logger.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: true חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן הריצה של logger. הגדרת מאגרי צמתים ייעודיים
logger.resources.limits.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 200m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
logger.resources.limits.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500Mi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
logger.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 100m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
logger.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
logger.serviceAccountPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כותב יומנים.
logger.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
logger.storageMaxChunks	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 128 המספר המקסימלי של מקטעים שיכולים להיות בזיכרון. קטעים שחורגים מהמגבלה יישמרו במערכת הקבצים.
logger.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 30 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
logger.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
logger.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
logger.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
logger.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
logger.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mart

מגדיר את שירות MART (ממשק Management API לנתוני RunTime), שפועל כספק API לממשקי API ציבוריים של Apigee, כדי שתוכלו לגשת לישויות נתונים של זמן ריצה ולנהל אותן, כמו KMS (מפתחות API ואסימוני OAuth),‏ KVM, מכסות ומוצרי API.

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

מאפיין (property)	סוג	תיאור
mart.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
mart.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-mart Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
mart.hostAlias	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא הכינוי של המארח שמפנה לאובייקט MART. אפשר להגדיר את המאפיין הזה לערך * או לשם דומיין שמוגדר במלואו.
mart.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
mart.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mart.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
mart.initCheckCF.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 10m כמות משאבי המעבד (CPU) שהוקצו לבדיקת האתחול של תהליך Cloud Foundry.
mart.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 12 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
mart.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 15 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
mart.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
mart.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
mart.metricsURL	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: /v1/server/metrics
mart.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של mart. אם לא מציינים מפתח ל-mart.nodeselector, סביבת זמן הריצה משתמשת בצומת שצוין באובייקט nodeSelector. הגדרת מאגרי צמתים ייעודיים
mart.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא ערך אופציונלי של תווית בורר הצמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של mart. אפשר לעיין גם באובייקט nodeSelector. הגדרת מאגרי צמתים ייעודיים
mart.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של MART שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: minAvailable: "50%"
mart.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של MART שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: maxUnavailable: 1
mart.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
mart.readinessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 15 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת מוכנות.
mart.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
mart.readinessProbe.successThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
mart.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
mart.replicaCountMax	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.
mart.replicaCountMin	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס.
mart.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 2000m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
mart.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 5Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
mart.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
mart.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
mart.serviceAccountPath	בסיסי	נוספה בגרסה: 1.1.1 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. נתיב לקובץ מפתח של חשבון שירות ב-Google ללא תפקיד.
mart.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
mart.sslCertPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. הנתיב של מערכת הקבצים המקומית לטעינה ולקידוד של אישור ה-SSL לסוד.
mart.sslKeyPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך לציין את sslCertPath/sslKeyPath או את sslSecret. נתיב מערכת הקבצים המקומית לטעינה ולקידוד של מפתח ה-SSL ל-Secret.
mart.sslSecret	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח ואישור ה-TLS כקלט. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
mart.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול יעד של המעבד (CPU) לתהליך MART ב-pod. הערך של השדה הזה מאפשר ל-MART לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
mart.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 30 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
mart.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
mart.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mart.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mart.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mart.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

metrics

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

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

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

מאפיין (property)	סוג	תיאור
metrics.adapter.image.pullPolicy	Advanced	נוספה בגרסה: 1.8.1 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
metrics.adapter.image.tag	Advanced	נוספה בגרסה: 1.8.1 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.adapter.image.url	Advanced	נוספה בגרסה: 1.8.1 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.adapter.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים של מתאם מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של מתאם מדדים שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: maxUnavailable: 1
metrics.adapter.resources.limits.cpu	Advanced	נוסף בגרסה: 1.14.1 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב המתאם בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.adapter.resources.limits.memory	Advanced	נוספה בגרסה: 1.14.1 ערך ברירת המחדל: 4Gi מגבלת הזיכרון למשאב המתאם בקונטיינר של Kubernetes, בגיביבייט.
metrics.adapter.resources.requests.cpu	Advanced	נוספה בגרסה: 1.14.1 ערך ברירת המחדל: 100m המעבד (CPU) שנדרש לפעולה רגילה של המתאם בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.adapter.resources.requests.memory	Advanced	נוסף בגרסה: 1.14.1 ערך ברירת המחדל: 128Mi הזיכרון שנדרש לפעולה רגילה של המתאם בקונטיינר של Kubernetes, ב-mebibyte.
metrics.aggregator.resources.requests.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של האגרגטור בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.aggregator.resources.requests.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האגרגטור בקונטיינר של Kubernetes, ב-mebibytes.
metrics.aggregator.resources.limits.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) של משאב הצבירה בקונטיינר של Kubernetes, ב-millicores.
metrics.aggregator.resources.limits.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 3Gi מגבלת הזיכרון של משאב האגרגטור בקונטיינר של Kubernetes, בגיביבייט.
metrics.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
metrics.app.resources.requests.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.
metrics.app.resources.requests.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, ב-mebibytes.
metrics.app.resources.limits.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.
metrics.app.resources.limits.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של משאב האפליקציה בקונטיינר של Kubernetes, בגיביבייט.
metrics.appStackdriverExporter.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים של Stackdriver exporter של מדדי האפליקציה שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: appStackdriverExporter: podDisruptionBudget: minAvailable: "50%"
metrics.appStackdriverExporter.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של ייצוא מדדים של אפליקציות ל-Stackdriver שיכולים להיות לא זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: appStackdriverExporter: podDisruptionBudget: maxUnavailable: 1
metrics.appStackdriverExporter.resources.limits.cpu	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.appStackdriverExporter.resources.limits.memory	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של המשאב stackdriverExporter בקונטיינר של Kubernetes, בגיביבייט.
metrics.appStackdriverExporter.resources.requests.cpu	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 128m המעבד (CPU) שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.appStackdriverExporter.resources.requests.memory	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, במגה-בייטים.
metrics.collector.envVars	בסיסי	נוספה בגרסה: 1.13 ערך ברירת המחדל: ללא מאפשר להעביר משתני סביבה ולשנות אותם ב-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 קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר שימוש במאגר תמונות פרטי עם Apigee Hybrid .
metrics.collector.image.tag	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.collector.image.url	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.collector.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים לאיסוף מדדים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שה-collector פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מה-pods של ה-collector (מעוגל כלפי מטה) במקום להשתמש ב-maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים לאיסוף מדדים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא תגדירו אף אחד מהשדות, מפעיל Apigee עדיין ייצור PodDisruptionBudget לפודים האלה. מכיוון שה-collector פועל כ-DaemonSet, ברירת המחדל הזו מגדירה את minAvailable ל-80% מה-pods של ה-collector (מעוגל כלפי מטה) במקום להשתמש ב-maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: maxUnavailable: 1
metrics.collector.resources.requests.cpu	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.
metrics.collector.resources.requests.memory	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האפליקציה בקונטיינר של Kubernetes, ב-mebibytes.
metrics.collector.resources.limits.cpu	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב האפליקציה בקונטיינר של Kubernetes, במילי-ליבות.
metrics.collector.resources.limits.memory	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של משאב האפליקציה בקונטיינר של Kubernetes, בגיביבייט.
metrics.collector.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 5 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
metrics.collector.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 30 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
metrics.collector.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 10 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
metrics.collector.livenessProbe.successThreshold	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת תקינות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
metrics.collector.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 5 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
metrics.collector.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 3 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
metrics.collector.readinessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 30 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת מוכנות.
metrics.collector.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 10 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
metrics.collector.readinessProbe.successThreshold	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
metrics.collector.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: 5 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
metrics.disablePrometheusPipeline	בסיסי	נוספה בגרסה: 1.12.0 ערך ברירת המחדל: true מדדים של משאבים במעקב מסוג ProxyV2 ו-TargetV2 לא מופקים כשהערך מוגדר ל-true. במקום זאת, צריך להשתמש במדדים של המשאבים במעקב Proxy ו-Target.
metrics.enabled	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: true הפעלת מדדי Apigee. כדי להפעיל את המדדים, מגדירים את הערך true. כדי להשבית את המדדים, מגדירים את הערך false.
metrics.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-metrics Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
metrics.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן ריצה של metrics. הגדרת מאגרי צמתים ייעודיים
metrics.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן הריצה של metrics. הגדרת מאגרי צמתים ייעודיים
metrics.prometheus.containerPort	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 9090 היציאה לחיבור לשירות המדדים של Prometheus.
metrics.prometheus.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
metrics.prometheus.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.prometheus.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.prometheus.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 6 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
metrics.prometheus.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
metrics.prometheus.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 120 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
metrics.prometheus.resources.limits.cpu	Advanced	נוסף בגרסה: 1.14.1 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב Prometheus בקונטיינר של Kubernetes, ב-millicores.
metrics.prometheus.resources.limits.memory	Advanced	נוספה בגרסה: 1.14.1 ערך ברירת המחדל: 4Gi מגבלת הזיכרון למשאב Prometheus בקונטיינר של Kubernetes, בגיביבייט.
metrics.prometheus.resources.requests.cpu	Advanced	נוספה בגרסה: 1.14.1 ערך ברירת המחדל: 128m המעבד (CPU) שנדרש לפעולה רגילה של Prometheus בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.prometheus.resources.requests.memory	Advanced	נוסף בגרסה: 1.14.1 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של Prometheus בקונטיינר של Kubernetes, ב-mebibyte.
metrics.prometheus.sslCertPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה הנתיב לאישור ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים. אפשר לעיין במאמרים הבאים: מדדים למידע כללי, האתר של Prometheus
metrics.prometheus.sslKeyPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה הנתיב למפתח ה-SSL של תהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכולה להשתמש בו כדי לאסוף ולעבד מדדים. אפשר לעיין במאמרים הבאים: מדדים למידע כללי, האתר של Prometheus
metrics.proxy.resources.requests.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של שרת ה-proxy בקונטיינר של Kubernetes, ב-millicores.
metrics.proxy.resources.requests.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של שרת ה-proxy בקונטיינר של Kubernetes, ב-mebibytes.
metrics.proxy.resources.limits.cpu	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב ה-proxy בקונטיינר של Kubernetes, ב-millicores.
metrics.proxy.resources.limits.memory	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון למשאב ה-proxy בקונטיינר של Kubernetes, בגיביבייטים.
metrics.proxyStackdriverExporter.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים של metrics proxy Stackdriver exporter שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: proxyStackdriverExporter: podDisruptionBudget: minAvailable: "50%"
metrics.proxyStackdriverExporter.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של metrics proxy Stackdriver exporter שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: proxyStackdriverExporter: podDisruptionBudget: maxUnavailable: 1
metrics.proxyStackdriverExporter.resources.requests.cpu	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 128m המעבד (CPU) שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.proxyStackdriverExporter.resources.requests.memory	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של stackdriverExporter בקונטיינר של Kubernetes, במגה-בייטים.
metrics.proxyStackdriverExporter.resources.limits.cpu	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב stackdriverExporter בקונטיינר של Kubernetes, באלפיות ליבה.
metrics.proxyStackdriverExporter.resources.limits.memory	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של המשאב stackdriverExporter בקונטיינר של Kubernetes, בגיביבייט.
metrics.proxyURL	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא כתובת ה-URL של קובץ העזר החיצוני של תהליך המדדים באשכול Kubernetes.
metrics.sdSidecar.containerPort	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 9091 היציאה לחיבור לשירות המדדים של Cloud Monitoring.
metrics.sdSidecar.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובע מתי Kubelet שולף את קובץ האימג' של Docker של השירות הזה. הערכים האפשריים כוללים: ‫IfNotPresent: לא למשוך תמונה חדשה אם היא כבר קיימת ‫Always: תמיד לשלוף את המדיניות, גם אם היא כבר קיימת מידע נוסף זמין במאמר עדכון תמונות.
metrics.sdSidecar.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.sdSidecar.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
metrics.serviceAccountPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כתיבת מדדי מעקב.
metrics.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
metrics.stackdriverExporter.resources.requests.cpu	Advanced	נוספה בגרסה: 1.4.0 ‫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 ‫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 ‫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 ‫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 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
metrics.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
metrics.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
metrics.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
metrics.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
metrics.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

mintTaskScheduler

‫mintTaskScheduler הוא משימת ה-cron לתזמון משימות מונטיזציה, כמו חישוב עמלות חוזרות על בסיס תקופתי.

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

מאפיין (property)	סוג	תיאור
mintTaskScheduler.gsa	Advanced	הושק בגרסה: 1.15.1 ערך ברירת המחדל: ללא כתובת האימייל של חשבון השירות (GSA) של apigee-mint-task-scheduler Google IAM שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
mintTaskScheduler.image.pullPolicy	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
mintTaskScheduler.image.tag	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mintTaskScheduler.image.url	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
mintTaskScheduler.resources.limits.cpu	Advanced	נוספה בגרסה: 1.1.0 ערך ברירת המחדל: 2000m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
mintTaskScheduler.resources.limits.memory	Advanced	נוספה בגרסה: 1.1.0 ערך ברירת המחדל: 4Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
mintTaskScheduler.resources.requests.cpu	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
mintTaskScheduler.resources.requests.memory	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
mintTaskScheduler.serviceAccountPath	בסיסי	הושק בגרסה: 1.15.1 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google.
mintTaskScheduler.serviceAccountRef	בסיסי	הושק בגרסה: 1.15.1 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
mintTaskScheduler.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
mintTaskScheduler.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mintTaskScheduler.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mintTaskScheduler.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
mintTaskScheduler.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

newDataPipeline

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

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

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

nodeSelector

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

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

מאפיין (property)	סוג	תיאור
nodeSelector.apigeeData.key	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: cloud.google.com/gke-nodepool ‫ApigeeData הוא הצומת של מסד הנתונים של Cassandra. מפתח תווית של בורר צמתים לטירגוט צומתי Kubernetes לעבודה עם נתוני שירותים של Apigee. הגדרת מאגרי צמתים ייעודיים
nodeSelector.apigeeData.value	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigee-data ‫apigee-data הוא הצומת של מסד הנתונים של Cassandra. ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לעבודה עם נתוני שירותי Apigee. הגדרת מאגרי צמתים ייעודיים
nodeSelector.apigeeRuntime.key	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: cloud.google.com/gke-nodepool ‫Apigee Runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. מפתח תווית של בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן ריצה של Apigee. הגדרת מאגרי צמתים ייעודיים
nodeSelector.apigeeRuntime.value	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: apigee-runtime ‫apigee-runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של Apigee. הגדרת מאגרי צמתים ייעודיים
nodeSelector.requiredForScheduling	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: true ערך ברירת המחדל של המאפיין requiredForScheduling הוא true. כאשר true, המשמעות היא שאם Kubernetes לא יכול למצוא צמתים עם מפתח/ערך התווית שהוגדר, קבוצות ה-Pod הבסיסיות לא יתוזמנו בצמתים של ה-VM. בגרסת הייצור, צריך להגדיר את nodeSelector.requiredForScheduling כ-true. הגדרת מאגרי צמתים ייעודיים

redis

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

מאפיין (property)	סוג	תיאור
redis.auth.password	בסיסי	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של האדמין ב-Redis. משתמש עם הרשאת אדמין משמש לכל פעולות הניהול שמתבצעות באשכול Redis.
redis.auth.secret	בסיסי	נוספה בגרסה: 1.9.1 ערך ברירת המחדל: ללא שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את הסיסמה של מנהל המערכת של Redis. קובץ הסוד צריך להכיל את המפתח: data: redis.auth.password: encoded_value מידע נוסף: redis.auth.password אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes
redis.envoy.image.pullPolicy	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
redis.envoy.image.tag	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.envoy.image.url	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
redis.envoy.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-redis המספר המינימלי של פודים של Redis Envoy שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-redis המספר המקסימלי של פודים של Redis Envoy שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: maxUnavailable: 1
redis.image.pullPolicy	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
redis.image.tag	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.image.url	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
redis.replicaCount	בסיסי	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 2 ‫Redis הוא אחסון משוכפל. המאפיין הזה מציין את מספר צומתי Redis שמועסקים כ-StatefulSet.
redis.resources.requests.cpu	Advanced	נוסף בגרסה: 1.6.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה. ‫Apigee ממליצה על ערך בין 500m ל-1000m. עם 0.5 ליבות, צומת Redis יכול בדרך כלל לטפל ב-10,000 שאילתות לשנייה. עם ליבה אחת, בדרך כלל אפשר לטפל ב-20,000 שאילתות לשנייה. ברוב המקרים, משאבי בקשות מעבד (CPU) מעל 1,000m לא מועילים.
redis.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
redis.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
redis.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
redis.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
redis.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

runtime

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

מאפיין (property)	סוג	תיאור
runtime.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
runtime.envVars	בסיסי	נוספה בגרסה: 1.13.1 ערך ברירת המחדל: ללא מאפשרת לספק משתני סביבה נוספים לרכיב זמן הריצה בצמד מפתח/ערך: 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 קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
runtime.hpaBehavior.scaleDown.percent.periodSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 60 חלון הזמן שבו המדיניות צריכה להתקיים כשמצמצמים אנכית בהתאם לעומס (scale down) אחוז מסוים של מכונות בזמן ריצה.
runtime.hpaBehavior.scaleDown.percent.value	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 20 מידת השינוי שמותרת לפי המדיניות כשמצמצמים אנכית בהתאם לעומס (scale down) אחוז מסוים של מכונות בזמן הריצה.
runtime.hpaBehavior.scaleDown.pods.periodSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 60 חלון הזמן שבו המדיניות צריכה להתקיים כשמצמצמים אנכית בהתאם לעומס (scale down) מספר מופעים של זמן ריצה.
runtime.hpaBehavior.scaleDown.pods.value	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 20 מידת השינוי שמותרת לפי המדיניות כשמצמצמים את מספר המכונות בזמן הריצה.
runtime.hpaBehavior.scaleDown.selectPolicy	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: דקה אחת ההחלטה שמידרוג אוטומטי מקבל בין כמה כללי מדיניות להתאמה אוטומטית לעומס. הגדרת הערך ל-Min מאפשרת את השינוי הקטן ביותר בצמצום אנכית של מכונות בזמן הריצה. אם מגדירים את הערך ל-Max, השינוי בצמצום האנכי של מכונות זמן הריצה יהיה הגדול ביותר.
runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 120 מספר השניות שבהן המערכת צריכה להתחשב בהמלצות קודמות בזמן צמצום אנכי בהתאם לעומס (scale down).
runtime.hpaBehavior.scaleUp.percent.periodSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 60 חלון הזמן שבו המדיניות צריכה להתקיים כשמגדילים את אחוז המכונות בזמן הריצה.
runtime.hpaBehavior.scaleUp.percent.value	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 20 חלון הזמן שבו המדיניות צריכה להתקיים כשמגדילים את אחוז המכונות בזמן הריצה.
runtime.hpaBehavior.scaleUp.pods.periodSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 60 חלון הזמן שבו המדיניות צריכה להתקיים כשמגדילים את מספר המכונות בזמן הריצה.
runtime.hpaBehavior.scaleUp.pods.value	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 4 מידת השינוי שמותרת לפי המדיניות כשמגדילים את מספר המכונות בזמן הריצה.
runtime.hpaBehavior.scaleUp.selectPolicy	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: מקסימלי ההחלטה שמידרוג אוטומטי מקבל בין כמה כללי מדיניות להתאמה אוטומטית לעומס. אם מגדירים את הערך ל-Min, השינוי בהגדלת המכונות של זמן הריצה יהיה הקטן ביותר. הגדרת הערך ל-Max מאפשרת את השינוי הגדול ביותר בהגדלת מספר המכונות בזמן הריצה.
runtime.hpaBehavior.scaleUp.stabilizationWindowSeconds	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 30 מספר השניות שבהן המערכת צריכה להתחשב בהמלצות קודמות בזמן הגדלת המכסות של המכונות בזמן הריצה.
runtime.hpaMetrics.serverMainTaskWaitTime	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 400M זמן ההמתנה הממוצע הרצוי (באלפיות השנייה) של תור העיבוד במכונות בזמן ריצה לבקשות proxy בשכבת ה-HTTP.
runtime.hpaMetrics.serverNioTaskWaitTime	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 400M זמן ההמתנה הממוצע הרצוי (באלפיות השנייה) של תור העיבוד במופעי זמן ריצה לבקשות של שרת proxy לעיבוד כללי מדיניות.
runtime.hpaMetrics.targetCPUUtilizationPercentage	Advanced	נוסף בגרסה: 1.7.0 ערך ברירת המחדל: 75 אחוז הניצול הרצוי של המעבד (CPU) בכל המכונות של סביבת זמן הריצה.
runtime.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
runtime.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
runtime.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
runtime.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 60 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
runtime.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
runtime.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
runtime.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי runtime. אפשר לעיין במאפיין nodeSelector.
runtime.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא ערך התווית של בורר הצמתים לטירגוט צומתי Kubernetes לשירותי runtime. הגדרת מאגרי צמתים ייעודיים
runtime.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המינימלי של פודים של זמן ריצה שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של סביבת זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: runtime: podDisruptionBudget: minAvailable: "50%"
runtime.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של סביבת זמן ריצה שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של סביבת זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.maxUnavailable. לדוגמה, ב-overrides.yaml: runtime: podDisruptionBudget: maxUnavailable: 1
runtime.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
runtime.readinessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 60 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת מוכנות.
runtime.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
runtime.readinessProbe.successThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
runtime.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
runtime.release.strategy	Advanced	נוספה בגרסה: 1.15.7 ערך ברירת המחדל: rolling בוחרת את האסטרטגיה שמשמשת להשקת ReplicaSet חדש של סביבת זמן ריצה (מעבד בקשות) כששינוי בהגדרת הסביבה מפעיל גרסה. אפשר גם להגדיר את זה לכל סביבה באמצעות envs[].components.runtime.release.strategy. ערכים מותרים: ‫rolling (ברירת מחדל): יוצרת את ה-ReplicaSet החדש לצד הקיים ומעבירה אליו את התנועה בשלבים לפני שהיא מצמצמת אנכית בהתאם לעומס (scale down) את ה-ReplicaSet הישן. כך אפשר להעביר את התנועה בהדרגה, אבל באופן זמני נדרש נפח מחשוב נוסף (עד בערך פי שניים ממספר הפודים במצב יציב) במהלך ההשקה. מומלץ לרוב סביבות הייצור. ‫scale-down-first: החלפת Pods אחד אחרי השני, ניקוז Pod קיים לפני יצירת Pod חלופי. מכיוון שכל החלפה היא אחד לאחד, הגרסה נשארת במסגרת מספר הפודים במצב יציב ולא נדרש מרווח נוסף לחישוב. האפשרות הזו מתאימה לאשכולות בלי התאמה אוטומטית לעומס של הצמתים, כמו התקנות עם מגבלות חומרה או התקנות על Bare Metal. הגרסאות מתפרסמות לאט יותר ולא כוללות העברת תנועה הדרגתית. ‫none: מעבר מיידי ל-ReplicaSet החדש בלי העברת תנועה הדרגתית.
runtime.replicaCountMax	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 4 המספר המקסימלי של רפליקות שזמינות להתאמה אוטומטית לעומס. אם משתמשים במגבלות משופרות של שרתי proxy לכל סביבה, הן יחולו על כל קבוצות הרפליקות בסביבה. כל קבוצת רפליקות עדיין תתאים את הגודל שלה באופן אוטומטי ובנפרד.
runtime.replicaCountMin	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות שזמינות להתאמה אוטומטית לעומס. אם משתמשים במגבלות משופרות של שרתי proxy לכל סביבה, הן יחולו על כל קבוצות הרפליקות בסביבה. כל replicaset עדיין יבצע התאמה אוטומטית של קנה המידה באופן עצמאי.
runtime.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 4000m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
runtime.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 6Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את runtime.resources.limits.memory ל-‎6Gi. מגדילים את runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
runtime.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה. הערה: כדי לבצע התאמה אוטומטית לעומס (automatic scaling) חלקה של מעבדי בקשות לעלייה בתעבורת נתונים, מומלץ לא לחרוג משתי ליבות (2,000 מילי-ליבות) אם מחליטים לשנות את ברירת המחדל. רכיבי סביבת זמן הריצה של Apigee מוגבלים על ידי קלט/פלט, והוספת קיבולת CPU לא תמיד עוזרת להתמודד עם עומסי תנועה. כשיש בקשות רבות למעבד (CPU), יכול להיות שמעבדי הבקשות לא יבצעו התאמה אוטומטית לעומס, ובדיקות החיוּת ייכשלו בגלל תנועה רבה.
runtime.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi (ראו הערה בהמשך) הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במגה-בייטים (Mi) או בגיגה-בייטים (Gi). חשוב: בסביבות ייצור, צריך לאפס את הערך של runtime.resources.requests.memory ל-1Gi לפחות ב-overrides.yaml. ערך ברירת המחדל של 512Mi מספיק להפעלה ולהגדרה הראשונית, אבל צריך להגדיל אותו בסביבת הייצור. כדי להשיג התאמה אוטומטית לעומס (automatic scaling) חלקה של מעבדי בקשות לעלייה בתעבורת נתונים, מומלץ לא לחרוג מ-2.5Gi‏ (2560Mi) אם מחליטים לשנות את ברירת המחדל. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות שגדולים מ-10MB, אתם צריכים לבצע את השינויים הבאים בהגדרות: מגדילים את גודל ה-heap ל-4Gi. מגדילים את runtime.resources.limits.memory ל-‎6Gi. מגדילים את runtime.resources.requests.memory ל-4Gi. פרטים נוספים זמינים במאמר הגדרת תמיכה במטען ייעודי (payload) גדול של הודעות ב-Apigee Hybrid.
runtime.service.type	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ClusterIP סוג השירות. אפשר להגדיר את זה לשירות אחר שהוא לא ClusterIP, לדוגמה LoadBalancer.
runtime.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 75 יעד ניצול המעבד (CPU) לתהליך זמן הריצה ב-pod. הערך של השדה הזה מאפשר לסביבת זמן הריצה להתאים את עצמה לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
runtime.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 3600 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי. הערה: הערך הזה מוגדר על ידי בקר Apigee ואי אפשר לשנות אותו.
runtime.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
runtime.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
runtime.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
runtime.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
runtime.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

synchronizer

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

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

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

מאפיין (property)	סוג	תיאור
synchronizer.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
synchronizer.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
synchronizer.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
synchronizer.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
synchronizer.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
synchronizer.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
synchronizer.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
synchronizer.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
synchronizer.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה מפתח אופציונלי של תווית בורר צמתים לטירגוט צומתי Kubernetes לשירותי זמן הריצה של synchronizer. ראו nodeSelector.
synchronizer.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא ערך אופציונלי של תווית בורר הצמתים, שמשמש לטירגוט צומתי Kubernetes לשירותי זמן הריצה של synchronizer. ראו nodeSelector.
synchronizer.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המינימלי של פודים לסנכרון שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: synchronizer: podDisruptionBudget: minAvailable: "50%"
synchronizer.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-env המספר המקסימלי של pod של סנכרון שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב שונה לפודים של הסנכרון בסביבה ספציפית, משתמשים ב-envs[].components.synchronizer.podDisruptionBudget.maxUnavailable. לדוגמה, ב-overrides.yaml: synchronizer: podDisruptionBudget: maxUnavailable: 1
synchronizer.pollInterval	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 60 משך הזמן שהסנכרון ממתין בין פעולות דגימה. הסנכרון דוגם את שירותי מישור הבקרה של Apigee כדי לזהות ולמשוך חוזים חדשים של סביבת זמן הריצה.
synchronizer.readinessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות המוכנות נכשלו לפני שיסמן את ה-Pod כלא מוכן. הערך המינימלי הוא 1.
synchronizer.readinessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת מוכנות.
synchronizer.readinessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה מתבצעת בדיקת מוכנות. הערך המינימלי הוא 1.
synchronizer.readinessProbe.successThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת מוכנות תיחשב כמוצלחת אחרי כישלון. הערך המינימלי הוא 1.
synchronizer.readinessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
synchronizer.replicaCount	בסיסי	נוספה בגרסה: 1.0.0 ‫Deprecated: החל מגרסה 1.2 של Hybrid, אפשר לנהל את מספר הרפליקות של Synchronizer באמצעות: synchronizer.replicaCountMax ו-synchronizer.replicaCountMin
synchronizer.replicaCountMax	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להתאמה אוטומטית לעומס (autoscaling).
synchronizer.replicaCountMin	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות להתאמה אוטומטית לעומס.
synchronizer.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 2000m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
synchronizer.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 5Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
synchronizer.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 100m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
synchronizer.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1Gi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, בג'יגה-בייט.
synchronizer.serviceAccountPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל Apigee Synchronizer.
synchronizer.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להגדיר את העמודה serviceAccountPath או את העמודה serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
synchronizer.serviceAccountSecret	בסיסי	נוספה בגרסה: 1.1.0 ערך ברירת המחדל: ללא השם של סוד ב-Kubernetes. כדי ליצור את הסוד, צריך להשתמש במפתח של חשבון שירות ב-Google עם התפקיד מנהל סנכרון של Apigee כקלט.
synchronizer.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול היעד של המעבד (CPU) לתהליך של Synchronizer ב-pod. הערך של השדה הזה מאפשר ל-Synchronizer לבצע התאמה אוטומטית לעומס (automatic scaling) כשניצול המעבד (CPU) מגיע לערך הזה, עד replicaCountMax.
synchronizer.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 30 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
synchronizer.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
synchronizer.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
synchronizer.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
synchronizer.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
synchronizer.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

udca

(סוכן איסוף נתונים אוניברסלי) מגדיר את השירות שפועל בתוך pod של איסוף נתונים במישור זמן הריצה. השירות הזה מחלץ נתוני ניתוח וסטטוס פריסה ושולח אותם לפלטפורמת הניתוח המאוחדת (UAP).

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

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

מאפיין (property)	סוג	תיאור
udca.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
udca.fluentd.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
udca.fluentd.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
udca.fluentd.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent המיקום של קובץ האימג' של Docker בשירות הזה.
udca.fluentd.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 1000m מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
udca.fluentd.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 500Mi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
udca.fluentd.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 500m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
udca.fluentd.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
udca.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-udca Google IAM ‏(GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את זה כשהערך של gcp.workloadIdentity.enabled הוא true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
udca.image.pullPolicy	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
udca.image.tag	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
udca.image.url	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
udca.jvmXms	Advanced	נוספה בגרסה: 1.0.0 ‫Deprecated: החל מגרסה 1.8 של Hybrid, לא משתמשים יותר ב-udca.jvmXms.
udca.jvmXmx	Advanced	נוספה בגרסה: 1.0.0 ‫Deprecated: החל מגרסה 1.8 של Hybrid, לא משתמשים יותר ב-udca.jvmXmx.
udca.livenessProbe.failureThreshold	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת שבדיקות החיוניות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
udca.livenessProbe.initialDelaySeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות מרגע שהקונטיינר מתחיל לפעול ועד שמתחילה בדיקת החיות.
udca.livenessProbe.periodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת באיזו תדירות (בשניות) תתבצע בדיקת תקינות. הערך המינימלי הוא 1.
udca.livenessProbe.timeoutSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן הזמן הקצוב לתפוגה של בדיקת החיות מסתיים. הערך המינימלי הוא 1.
udca.nodeSelector.key	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן ריצה של udca. הגדרת מאגרי צמתים ייעודיים
udca.nodeSelector.value	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צומתי Kubernetes ייעודיים לשירותי זמן הריצה של udca. הגדרת מאגרי צמתים ייעודיים
udca.pollingIntervalInSec	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 משך הזמן, בשניות, ש-UDCA ממתין בין פעולות דגימה. ‫UDCA דוגם את ספריית הנתונים במערכת הקבצים של pod איסוף הנתונים כדי לזהות קבצים חדשים להעלאה.
udca.replicaCountMax	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 4 מספר ה-Pods המקסימלי שהמערכת ההיברידית יכולה להוסיף באופן אוטומטי לפריסת ה-UDCA. מכיוון ש-UDCA מיושם כ-ReplicaSet, הפודים הם רפליקות. מומלץ להגדיר את udca.replicaCountMax למספר המקסימלי של רפליקות לכל סביבה כפול מספר הסביבות בארגון Apigee. לדוגמה, אם רוצים לאפשר עד 4 רפליקות לכל סביבה ויש 3 סביבות, מגדירים את הערך udca.replicaCountMax: 12. אם משתמשים ב-UDCA ברמת הסביבה, מגדירים את udca.replicaCountMax למספר המקסימלי של רפליקות לסביבה אחת. אפשר לעיין במאמר orgScopedUDCA.
udca.replicaCountMin	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר הפודים המינימלי לפריסת UDCA. מכיוון ש-UDCA מיושם כ-ReplicaSet, הפודים הם רפליקות. אם השימוש במעבד (CPU) יעלה מעל udca.targetCPUUtilizationPercentage, המערכת ההיברידית תגדיל בהדרגה את מספר ה-pods עד ל-udca.replicaCountMax.
udca.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 1000m מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
udca.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 2Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
udca.resources.requests.cpu	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 250m המעבד (CPU) שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
udca.resources.requests.memory	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, ב-mebibyte.
udca.revision	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: v1 ערך סטטי שמאוכלס בתווית כדי לאפשר פריסות של גרסאות ראשוניות (canary).
udca.serviceAccountPath	בסיסי	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: ללא צריך להזין את serviceAccountPath או את serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד סוכן Apigee Analytics.
udca.serviceAccountRef	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך להזין את serviceAccountPath או את serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
udca.targetCPUUtilizationPercentage	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 75 סף השימוש במעבד (CPU) לשינוי מספר ה-pods ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. במצב היברידי, המערכת מחשבת את הניצול הנוכחי על סמך הניצול המשולב של כל הקונטיינרים ב-Pod של איסוף הנתונים (גם fluentd וגם UDCA). כשהשימוש במעבד (CPU) חורג מהערך הזה, המערכת ההיברידית מגדילה בהדרגה את מספר הפודים ב-ReplicaSet, עד ל-udca.replicaCountMax.
udca.terminationGracePeriodSeconds	Advanced	נוספה בגרסה: 1.0.0 ערך ברירת המחדל: 600 משך הזמן המקסימלי בשניות בין בקשה למחיקת pod לבין סגירת ה-pod. במהלך התקופה הזו, כל ה-prestop hooks יופעלו וכל תהליך שפועל אמור להסתיים בצורה תקינה. ה-Pod יושבת כשכל התהליכים הפעילים יסתיימו או בסוף תקופת החסד, המוקדם מביניהם. אם אין תהליכים שפועלים, ה-pod יושבת באופן מיידי.
udca.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
udca.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
udca.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
udca.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
udca.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.

virtualhosts

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

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

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

מאפיין (property)	סוג	תיאור
virtualhosts[].additionalGateways	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא רשימה של שערי Istio שאליהם תנותב התנועה.
virtualhosts[].cipherSuites[]	Advanced	נוסף בגרסה: 1.9.2 ערך ברירת המחדל: ללא המאפיין הזה מגדיר את הצפנות ה-TLS שמשמשות בשער הכניסה. בהמשך מופיעה רשימה של הצפנים שמופעלים כברירת מחדל בפורמט OpenSSL. מידע נוסף על הצפנים הנתמכים זמין במסמכי התיעוד של Boring FIPS build of Envoy. ערך ריק מוגדר כברירת מחדל לסטים של אלגוריתמים להצפנה (cipher suite) שנתמכים על ידי גרסת Boring FIPS של Envoy. TLS v1.3: מופעלת כברירת מחדל חבילות הצפנה נוספות TLS_AES_128_GCM_SHA256 TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 אי אפשר לשנות את ההגדרות של סט אלגוריתמים להצפנה (cipher suite) של TLS 1.3. TLS v1.2: מופעלת כברירת מחדל חבילות הצפנה נוספות ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-GCM-SHA384 AES128-GCM-SHA256 AES128-SHA AES256-GCM-SHA384 AES256-SHA ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES128-SHA ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-ECDSA-AES256-SHA ECDHE-ECDSA-CHACHA20-POLY1305 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-SHA ECDHE-RSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-SHA ECDHE-RSA-CHACHA20-POLY1305 TLS v1.1: מופעלת כברירת מחדל חבילות הצפנה נוספות ‫TLS v1.1 לא מופעל כברירת מחדל. ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-GCM-SHA384 ECDHE-ECDSA-CHACHA20-POLY1305 ECDHE-RSA-CHACHA20-POLY1305 ECDHE-ECDSA-AES128-SHA ECDHE-ECDSA-AES256-SHA ECDHE-RSA-AES256-SHA כדי להפעיל עוד חבילות צפנים, צריך להוסיף אותן למאפיין virtualhosts.cipherSuites יחד עם גרסת ה-TLS שרוצים להפעיל אותן עבורה במאפיין virtualhosts.minTLSProtocolVersion. לדוגמה, כדי להפעיל את כל חבילות ההצפנה המקובלות של TLS v.1.2, מוסיפים את הפרטים הבאים להגדרות של virtualhosts: virtualhosts: - name: ENV_GROUP_NAME minTLSProtocolVersion: "1.2" cipherSuites: - "AES128-GCM-SHA256" - "AES128-SHA" - "AES256-GCM-SHA384" - "AES256-SHA" - "ECDHE-ECDSA-AES128-GCM-SHA256" - "ECDHE-ECDSA-AES128-SHA" - "ECDHE-ECDSA-AES256-GCM-SHA384" - "ECDHE-ECDSA-AES256-SHA" - "ECDHE-ECDSA-CHACHA20-POLY1305" - "ECDHE-RSA-AES128-GCM-SHA256" - "ECDHE-RSA-AES128-SHA" - "ECDHE-RSA-AES256-GCM-SHA384" - "ECDHE-RSA-AES256-SHA" - "ECDHE-RSA-CHACHA20-POLY1305" ... אם רוצים להפעיל גרסאות ישנות יותר של TLS בפריסה של שער הכניסה של Apigee, משתמשים במאפיינים virtualhosts.minTLSProtocolVersion ו-virtualhosts.cipherSuites. לדוגמה, כדי להפעיל את TLS v.1.1: virtualhosts: - name: ENV_GROUP_NAME minTLSProtocolVersion: "1.1" cipherSuites: - "ECDHE-ECDSA-AES128-GCM-SHA256" - "ECDHE-RSA-AES128-GCM-SHA256" - "ECDHE-ECDSA-AES256-GCM-SHA384" - "ECDHE-RSA-AES256-GCM-SHA384" - "ECDHE-ECDSA-CHACHA20-POLY1305" - "ECDHE-RSA-CHACHA20-POLY1305" - "ECDHE-ECDSA-AES128-SHA" - "ECDHE-RSA-AES128-SHA" - "ECDHE-ECDSA-AES256-SHA" - "ECDHE-RSA-AES256-SHA" ... הערה: המאפיין הזה מחליף את רשימת ה-cipher suites שנתמכים על ידי Envoy, ולא מוסיף לה. טיפ: המאפיין virtualhosts.cipherSuites משתמש בפורמט של סט אלגוריתמים להצפנה (cipher suite) של OpenSSL. רשימה של הצפנות עם השמות שלהן בפורמט OpenSSL וגם בפורמט IANA מופיעה במאמר Translating OpenSSL cipher suite names to IANA במסמכי התיעוד של SSL.org.
virtualhosts[].name	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא חובה השם של המארח הווירטואלי.
virtualhosts[].maxTLSProtocolVersion	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא הגרסה המקסימלית של פרוטוקול TLS ש-Envoy יכול לבחור. ‫Envoy משתמש באופן אוטומטי בגרסה האופטימלית של פרוטוקול TLS בין virtualhosts[].minTLSProtocolVersion ל-virtualhosts[].maxTLSProtocolVersion. הערך חייב להיות מספר. לדוגמה: virtualhosts: - name: default maxTLSProtocolVersion: "1.3" המספר מייצג את מספר הגרסה של TLS בפורמט #.#. בדוגמה שלמעלה, "1.3" מייצג את גרסת Istio TLS‏ TLSV1_3. אפשר גם לקרוא את המאמר ServerTLSSettings.TLSProtocol במסמכי התיעוד של Istio.
virtualhosts[].minTLSProtocolVersion	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא הגרסה המינימלית של פרוטוקול TLS ש-Envoy יכול לבחור. ‫Envoy משתמש באופן אוטומטי בגרסה האופטימלית של פרוטוקול TLS בין virtualhosts[].minTLSProtocolVersion ל-virtualhosts[].maxTLSProtocolVersion. הערך חייב להיות מספר. לדוגמה: virtualhosts: - name: default minTLSProtocolVersion: "1.2" המספר מייצג את מספר הגרסה של TLS בפורמט #.#. בדוגמה שלמעלה, 1.2 מייצג את גרסת Istio TLS‏ TLSV1_2. אפשר גם לקרוא את המאמר ServerTLSSettings.TLSProtocol במסמכי התיעוד של Istio.
virtualhosts[].requestTimeout	בסיסי	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: 300 תרשים: apigee-virtualhost מספר השניות שאחריהן הזמן הקצוב לתפוגה של בקשה נגמר. הערך המינימלי הוא 1.
virtualhosts[].selector	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: app: apigee-ingressgateway חובה צמד מפתח/ערך של סלקטור/ערך להפניה לסלקטורים שונים של Ingress. ‫apigee-ingressgateway: להתקנות של Apigee Hybrid שמשתמשות בשער הכניסה של Apigee. ‫istio-ingressgateway: להתקנות של Apigee Hybrid באמצעות Cloud Service Mesh (גרסאות Apigee Hybrid‏ 1.8 ומטה). אם לא מספקים תווית בורר, ההגדרות מסופקות לשער הכניסה של Apigee.
virtualhosts[].sslCertPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. הנתיב במערכת לקובץ של אישור TLS. הערה: בכל סביבה שהוגדרה, השם הנפוץ (CN) באישור חייב להיות תואם לדומיין במאפיין hostAliases[]. לדוגמה, אם ה-CN הוא *.example.com, ה-hostAliases[] יכול להיות foo.example.com או bar.example.com.
virtualhosts[].sslKeyPath	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. הנתיב במערכת לקובץ המפתח הפרטי של TLS.
virtualhosts[].sslSecret	בסיסי	נוספה בגרסה: 1.2.0 ערך ברירת המחדל: ללא צריך לציין את sslCertPath/sslKeyPath או את sslSecret. שם הקובץ שמאוחסן בסוד של Kubernetes ומכיל את שמות המשתמשים והסיסמאות של Cassandra. כדי ליצור את הסוד, פועלים לפי ההוראות במאמר יצירת הסוד. מידע נוסף: אחסון נתונים ב-Kubernetes secret סודות במסמכי התיעוד של Kubernetes יצירת סוד באמצעות kubectl במסמכי התיעוד של Kubernetes

watcher

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

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

מאפיין (property)	סוג	תיאור
watcher.annotations	Advanced	נוסף בגרסה: 1.5.0 ערך ברירת המחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות לפודים. מידע נוסף מופיע במאמר הערות בהתאמה אישית.
watcher.args.enableIssueScanning	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: true הפעלה או השבתה של הצגת בעיות אוטומטית. כש-true, Watcher סורק באופן אוטומטי את מישור הבקרה ואת מצב שרת ה-API של Kubernetes כדי לקבוע אם יש בעיות בהגדרות. מגדירים את הערך false כדי להשבית את ההצגה האוטומטית של בעיות. מידע נוסף זמין במאמר הצגת בעיות באופן אוטומטי.
watcher.args.enableLeaderElect	Advanced	נוספה בגרסה: 1.13.0 ערך ברירת המחדל: true כשהערך הוא true (ברירת המחדל) watcher.args.enableLeaderElect בוחר pod אחד של watcher כדי לנהל את פרטי הניתוב ולדווח עליהם. כדי למנוע זמן השבתה במהלך שדרוגים או חזרה לגרסה קודמת, צריך להגביל את זה ל-pod אחד. במהלך האירועים האלה, יכול להיות שכמה גרסאות של watcher יפעלו בו-זמנית. לכל מופע של Watcher יכול להיות לוגיקה שונה ליצירת נתיבים, מה שעלול לגרום לזמן השבתה.watcher.replicaCountMax.
watcher.args.issueScanInterval	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: 60 מרווח הזמן בשניות שבו Watcher סורק את מישור זמן הריצה כדי לזהות בעיות באופן אוטומטי. מידע נוסף זמין במאמר הצגת בעיות באופן אוטומטי.
watcher.gsa	Advanced	נוספה בגרסה: 1.10.0 ערך ברירת המחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות של apigee-watcher Google IAM ‏ (GSA) שצריך לשייך לחשבון השירות התואם של Kubernetes כשמפעילים את Workload Identity באשכולות GKE באמצעות תרשימי Helm. צריך להגדיר את המדיניות הזו אם המדיניות gcp.workloadIdentity.enabled מוגדרת לערך true. כתובות האימייל של GSA בדרך כלל נראות ככה: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לקרוא מידע נוסף במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
watcher.image.pullPolicy	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: IfNotPresent קובעת מתי kubelet שולף את קובץ האימג' של Docker של ה-pod. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד לשלוף את קובץ האימג', גם אם הוא כבר קיים. מידע נוסף זמין במאמר עדכון תמונות.
watcher.image.tag	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: 1.15.10 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
watcher.image.url	Advanced	נוספה בגרסה: 1.4.0 ערך ברירת המחדל: ללא המיקום של קובץ האימג' של Docker בשירות הזה. כדי לראות את כתובת ה-URL של המאגר הנוכחי של הרכיב הזה, משתמשים ב-apigee-pull-push --list. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים, במקום להגדיר אותם בנפרד.
watcher.podDisruptionBudget.minAvailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של צופים שחייבים להישאר זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה minAvailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). minAvailable ו-maxUnavailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable	Advanced	הושק בגרסה: 1.15.8 ערך ברירת המחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של צופים שלא יכולים להיות זמינים במהלך שיבוש יזום, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. השדה הזה מגדיר את השדה maxUnavailable של PodDisruptionBudget לפודים האלה. הוא מקבל מספר שלם של Pods‏ (1) או מחרוזת של אחוזים ("50%"). maxUnavailable ו-minAvailable הם בלעדיים זה לזה, צריך להגדיר רק אחד מהם. אם מגדירים את שניהם בו-זמנית, המפעיל של Apigee דוחה את ההגדרה. אם לא מגדירים אף אחד מהשדות, מפעיל Apigee עדיין יוצר PodDisruptionBudget לפודים האלה, באמצעות maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: maxUnavailable: 1
watcher.replicaCountMax	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: 1 המספר המקסימלי של רפליקות של צופים. כדי למנוע התנגשויות, צריך להשאיר את הערך 1. ב-Apigee Hybrid נעשה שימוש ב-watcher pod אחד לכל התקנה. בבחירת מנהיג, המערכת בוחרת באופן אוטומטי pod אחד של צופה. עותקים נוספים של pod של watcher ייאלצו לעבור למצב לא יציב. מידע נוסף זמין במאמר watcher.args.enableLeaderElect. אזהרה: הערך של watcher.replicaCountMax לא יכול להיות גדול מ-1.
watcher.replicaCountMin	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: 1 המספר המינימלי של רפליקות של צופים.
watcher.resources.limits.cpu	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 1000m מגבלת המעבד (CPU) של המשאב בקונטיינר של Kubernetes, באלפיות ליבה.
watcher.resources.limits.memory	Advanced	נוספה בגרסה: 1.11.0 ערך ברירת המחדל: 2Gi מגבלת הזיכרון של המשאב בקונטיינר של Kubernetes, במגה-בייטים.
watcher.serviceAccountPath	בסיסי	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא חובה. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד סוכן סביבת זמן הריצה של Apigee.
watcher.serviceAccountRef	Advanced	נוספה בגרסה: 1.3.0 ערך ברירת המחדל: ללא צריך לציין את serviceAccountPath או את serviceAccountRef. הפניה לסוד של Kubernetes לקובץ מפתח של חשבון שירות ב-Google. אחסון מפתחות של חשבונות שירות בסודות של Kubernetes
watcher.tolerations.effect	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. השדה effect מציין את ההשפעה של התאמה בין toleration ל-taint. הערכים של effect יכולים להיות: NoExecute NoSchedule PreferNoSchedule לפרטים נוספים, ראו Taints and Tolerations: Concepts.
watcher.tolerations.key	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫key מזהה את הפודים שאפשר להחיל עליהם את הסבילות. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
watcher.tolerations.operator	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: ‫Equal תואם לערך שמוגדר ב-value. המדיניות Exists מתעלמת מהערך שמוגדר במדיניות value. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
watcher.tolerations.tolerationSeconds	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. הערך של tolerationSeconds מגדיר בשניות כמה זמן pod נשאר מקושר לצומת שנכשל או לא מגיב. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.
watcher.tolerations.value	Advanced	נוספה בגרסה: 1.10.1 ערך ברירת המחדל: ללא משמש את התכונה "דחיות (taints) וטולרנטיות" של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. לפרטים נוספים, קראו את המאמר Taints and Tolerations: Concepts.