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

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

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 של Apigee Hybrid Kubernetes, זמינות במאמר הערות בהתאמה אישית.

מידע על מאפייני הגדרה

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

סינון הדף

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

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

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

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

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

מאפיין (property)	סוג	תיאור
axHashSalt	Advanced	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: iloveapis123 אופציונלי השם של סוד ב-Kubernetes שמכיל מלח שמשמש לחישוב גיבובים כדי להסתיר נתוני משתמשים לפני שהם נשלחים ל-Apigee Analytics. אם לא מציינים ערך salt, המערכת משתמשת ב-iloveapis123 כברירת מחדל. יוצרים את הסוד עם ערך ה-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 הוא המיקום שבו מאוחסנים נתונים של מישור הבקרה, כמו חבילות פרוקסי. רשימה של האזורים האפשריים זמינה במאמר אזורי מישור הבקרה של Apigee API שזמינים לשימוש. לדוגמה: contractProvider: https://us-apigee.googleapis.com
customAutoscaling.enabled	בסיסי	הוצגה בגרסה: 1.14.0 ערך ברירת המחדל: true אם המדיניות הזו מוגדרת לערך true (ברירת המחדל), מופעלת התאמת קנה מידה אוטומטית מבוססת-מדדים של Apigee. מגדירים את הערך false כדי להשבית את ההתאמה האוטומטית של קנה המידה בהתאמה אישית. כדי להחיל שינויים על customAutoscaling.enabled, מעדכנים את התרשים apigee-telemetry.
enhanceProxyLimits	Advanced	הוצגה בגרסה: 1.14.0 ערך ברירת המחדל: false חובה enhanceProxyLimits נדרש כדי להשתמש בתכונה 'מכסות משופרות של פרוקסי לכל סביבה' ב-Apigee. מגדירים את הערך הזה ל-enhanceProxyLimits: true אם הארגון ההיברידי שלכם זכאי למגבלות משופרות של שרת proxy לכל סביבה. הערה: התכונה הזו זמינה כחלק מתוכנית המינוי של 2024. ראו: מגבלות על שרתי proxy ל-API. מגבלות משופרות של פרוקסי לכל סביבה. זכויות גישה למינוי. ההגדרה enhanceProxyLimits: true נדרשת עבור שרשור של שרתי proxy, שרשור של נקודות קצה ושרשור של ServiceCallout. מידע נוסף: שרשור של שרתי proxy ל-API מדיניות ServiceCallout התראה: אם הערך מוגדר כ-true, אסור להגדיר אותו כ-false. כדי להחיל את השינויים על enhanceProxyLimits, מעדכנים את התרשים apigee-org ואת התרשים apigee-virtualhost לכל קבוצת סביבות.
gcpProjectID	Advanced	‫Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.projectID במקום זאת. הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מזהה הפרויקט ב-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.8 imagePullPolicy: IfNotPresent הערה: לפני גרסה 1.14.2 של Apigee Hybrid, לרכיבי צד שלישי היה מזהה ייחודי לגרסת התמונה מספק הצד השלישי. לדוגמה: ## an example of internal component vs 3rd party containers: - name: apigee-udca image: private-docker-host.example.com/apigee-udca:1.15.8 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 ערך ברירת מחדל: ללא חובה הארגון עם התכונה Hybrid שהוקצה לכם על ידי Apigee במהלך ההתקנה של Hybrid. ארגון הוא המאגר ברמה העליונה ב-Apigee. הוא מכיל את כל שרתי ה-proxy של ה-API והמשאבים שקשורים אליהם. אם הערך ריק, צריך לעדכן אותו בשם הארגון אחרי שיוצרים אותו.
orgScopedUDCA	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: true האפשרות הזו מפעילה את שירות Universal Data Collection Agent ‏ (UDCA) ברמת הארגון. השירות הזה מחלץ נתונים של Analytics, נתוני מונטיזציה ונתוני ניפוי באגים (trace) ושולח אותם אל Unified Analytics Platform ‏ (UAP), שנמצא ב-Control Plane. ‫UDCA בהיקף הארגון משתמש בחשבון שירות יחיד של Google לכל סביבות Apigee. לחשבון השירות צריך להיות התפקיד Apigee Analytics Agent ‏ (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 ערך ברירת המחדל: "1158" (גרסת Apigee Hybrid בלי נקודות. לדוגמה, בגרסה 1.12.0, ערך ברירת המחדל הוא "1120".) ‫Apigee hybrid תומך בעדכוני Kubernetes מתגלגלים, שמאפשרים לבצע עדכוני פריסה ללא השבתה, על ידי עדכון הדרגתי של מופעי Pod במופעים חדשים. כשמעדכנים החלפות מסוימות של YAML שגורמות לשינוי ב-Kubernetes הבסיסי PodTemplateSpec, צריך לשנות גם את מאפיין ההחלפה revision ב-override.yaml של הלקוח. הדבר נדרש כדי שהבקר הבסיסי של Kubernetes‏ ApigeeDeployment (AD) יבצע עדכון מדורג בטוח מהגרסה הקודמת לגרסה החדשה. אפשר להשתמש בכל ערך טקסט באותיות קטנות, למשל: blue, a, 1.0.0 הערה: revision יכול לקבל רק אותיות קטנות, ספרות וסימני פיסוק. כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) לכל הרכיבים שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision: nodeSelector envs imagePullSecrets gcpProjectID k8sClusterName contractProvider org מידע נוסף זמין במאמר בנושא עדכונים מדורגים.
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 לא מנהל את Kubernetes ClusterRole ו-ClursterRoleBinding ישירות. אם יש לכם תהליך שדורש ניהול של המשאבים האלה, התהליך צריך להתבצע על ידי משתמש עם ההרשאות המתאימות.
ao.image.pullPolicy	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
ao.image.tag	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
ao.image.url	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
ao.resources.requests.memory	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 256Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ao.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

apigeeIngressGateway

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

במאמר ingressGateways מוסבר איך להגדיר מופעים בנפרד.

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

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

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

cassandra

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

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

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

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

מאפיין (property)	סוג	תיאור
cassandra.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
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 של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.auth.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.auth.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
cassandra.auth.jmx.password	בסיסי	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש Cassandra JMX operations. משמש לאימות ולתקשורת עם ממשק 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 Secrets in the Kubernetes documentation יצירת סוד באמצעות 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 (מומלץ) להשתמש ב-Kubernetes CSI Volume Snapshots לגיבוי. למידע על 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 בלבד: כתובת האימייל של חשבון השירות (GSA) של Google IAM‏ apigee-cassandra שאותו רוצים לשייך לחשבון השירות של Kubernetes לגיבוי של Cassandra כשמפעילים Workload Identity באשכולות GKE. צריך להגדיר את המאפיין הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.backup.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" מידע נוסף זמין במאמר בנושא הפעלת איחוד זהויות של עומסי עבודה ב-GKE.
cassandra.backup.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.backup.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.backup.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להעלאת ארכיונים של גיבויים אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider מוגדר כ-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-Google Cloud Storage כדי להעלות ארכיונים של גיבויים: צוין cassandra.backup.serviceAccountPath. צוין cassandra.backup.serviceAccountRef. הגדרתם Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ב-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.backup.serviceAccountRef	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להעלאת ארכיונים של גיבויים אל cassandra.backup.dbStorageBucket שצוין. אם הגיבוי מופעל והערך של cassandra.backup.cloudProvider מוגדר כ-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-Google Cloud Storage כדי להעלות ארכיונים של גיבויים: צוין cassandra.backup.serviceAccountPath. צוין cassandra.backup.serviceAccountRef. הגדרתם Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ב-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.backup.storageDirectory	Advanced	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: ללא חובה אם הגיבוי מופעל והערך של 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 גרסה 1.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 הפעלה של התכונה Kubernetes hostNetwork. ‫Apigee משתמש בתכונה הזו בהתקנות מרובות אזורים כדי ליצור תקשורת בין פודים אם למרחב השמות של רשת הפוד אין קישוריות בין אשכולות (האשכולות פועלים ב'מצב רשת מבודדת'), וזהו המצב שמוגדר כברירת מחדל בהתקנות שאינן GKE, כולל Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. מגדירים את cassandra.hostNetwork ל-false להתקנות באזור יחיד ולהתקנות במספר אזורים עם קישוריות בין פודים באשכולות שונים, למשל התקנות GKE. מגדירים את cassandra.hostNetwork ל-true להתקנות בכמה אזורים ללא תקשורת בין פודים באשכולות שונים, למשל התקנות של Google Distributed Cloud ב-VMware או ב-bare metal,‏ AKS,‏ EKS ו-OpenShift. מידע על פריסה בכמה אזורים: דרישות מוקדמות כש-true, מדיניות DNS מוגדרת אוטומטית ל-ClusterFirstWithHostNet.
cassandra.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 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. מבצעים בדיקת עומס ומפיקים חיזויים סבירים לגבי ניצול המעבד. אפשר לציין ערכים שונים של replicaCount באזורים שונים. תוכלו להרחיב את replicaCount בעתיד בקובץ ההחלפות.
cassandra.resources.requests.cpu	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
cassandra.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1Gi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
cassandra.restore.cloudProvider	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: GCP השם של ספק השחזור. ערכים נתמכים: GCP,‏ HYBRID ו-CSI. מגדירים את הערך: GCP כדי לשחזר נתונים מגיבוי שמאוחסן ב-Google Cloud Storage. ‫HYBRID כדי לשחזר נתונים מגיבוי שמאוחסן בשרת SSH מרוחק. ‫CSI (מומלץ) להשתמש ב-Kubernetes CSI Volume Snapshots לשחזור. למידע על CSI גיבוי ושחזור של פלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, אפשר לעיין במאמר גיבוי ושחזור של CSI.
cassandra.restore.dbStorageBucket	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה אם ההגדרה 'שחזור' מופעלת והערך של 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: כתובת האימייל של חשבון השירות (GSA) של apigee-cassandra Google IAM שאותו רוצים לשייך לחשבון השירות של Kubernetes לשחזור Cassandra כשמפעילים Workload Identity באשכולות GKE. צריך להגדיר את המאפיין הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true ואת cassandra.restore.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" מידע נוסף זמין במאמר הפעלת Workload Identity Federation ב-GKE.
cassandra.restore.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.restore.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.restore.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
cassandra.restore.serviceAccountPath	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא נתיב לקובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להורדת ארכיוני גיבוי מcassandra.restore.dbStorageBucket שצוין. אם ההגדרה restore מופעלת ו-cassandra.restore.cloudProvider מוגדר ל-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-Google Cloud Storage כדי להוריד ארכיונים של גיבויים לצורך שחזור: צוין cassandra.restore.serviceAccountPath. צוין cassandra.restore.serviceAccountRef. הגדרתם Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ב-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.restore.serviceAccountRef	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא השם של סוד קיים ב-Kubernetes שבו מאוחסן התוכן של קובץ מפתח של חשבון שירות של Google עם התפקיד אדמין של אובייקט אחסון (roles/storage.objectAdmin). חשבון השירות הזה ב-Google ישמש להורדת ארכיוני גיבוי מcassandra.restore.dbStorageBucket שצוין. אם ההגדרה restore מופעלת ו-cassandra.restore.cloudProvider מוגדר ל-GCP, צריך לבצע אחת מהפעולות הבאות כדי לוודא ש-Apigee Hybrid יכול לגשת לקטגוריה של Cloud Storage ב-Google Cloud Storage כדי להוריד ארכיונים של גיבויים לצורך שחזור: צוין cassandra.restore.serviceAccountPath. צוין cassandra.restore.serviceAccountRef. הגדרתם Workload Identity ל-Apigee Hybrid ב-GKE. הגדרתם איחוד שירותי אימות הזהות של עומסי עבודה ב-Apigee Hybrid ב-AKS או ב-EKS.
cassandra.restore.snapshotTimestamp	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה אם מופעל שחזור. חותמת הזמן של הגיבוי שצריך לשחזר.
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 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
cassandra.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
connectAgent.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא רק ב-Helm: כתובת האימייל של חשבון השירות של Google IAM ‏ (GSA) שאליו connectAgent ישויך כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true. הערה: connectAgent משתמש בחשבון השירות apigee-mart. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לעיין במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
connectAgent.logLevel	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: INFO רמת הדיווח ביומן. הערכים האפשריים הם: ‫INFO: הודעות עם מידע חשוב בנוסף להודעות אזהרה, שגיאה והודעות קריטיות. ההגדרה הזו שימושית בעיקר לניפוי באגים. ‫WARNING: אזהרות לא קריטיות בנוסף להודעות שגיאה והודעות קריטיות. ‫ERROR: שגיאות פנימיות ושגיאות שלא מוחזרות למשתמש, בנוסף להודעות קריטיות. ‫FATAL: שגיאות ואירועים שלא ניתן לשחזר שגורמים לקריסה של Apigee Connect.
connectAgent.image.pullPolicy	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
connectAgent.image.tag	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
connectAgent.image.url	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
connectAgent.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-org מספר המינימלי של פודים של סוכני Apigee Connect שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז צמתים. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: minAvailable: "50%"
connectAgent.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של תרמילי סוכן Apigee Connect שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: connectAgent: podDisruptionBudget: maxUnavailable: 1
connectAgent.replicaCountMax	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 5 מספר הרפליקות המקסימלי שזמין לשינוי גודל אוטומטי.
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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
connectAgent.resources.requests.memory	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 30Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 ביעד בפוד. הערך בשדה הזה מאפשר ל-Apigee Connect לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
connectAgent.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 600 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
connectAgent.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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. כל סביבה מספקת הקשר מבודד או ארגז חול להרצת פרוקסי של 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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 מספר הרפליקות המקסימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של 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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-4Gi. הגדלת envs[].components.runtime.resources.limits.memory ל-6Gi. הגדלת envs[].components.runtime.resources.requests.memory ל-4GB. פרטים נוספים זמינים במאמר בנושא הגדרת תמיכה במטען ייעודי (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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-4Gi. הגדלת envs[].components.runtime.resources.limits.memory ל-6Gi. הגדלת envs[].components.runtime.resources.requests.memory ל-4GB. פרטים נוספים זמינים במאמר בנושא הגדרת תמיכה במטען ייעודי (payload) של הודעות גדולות ב-Apigee Hybrid.
envs[].components.synchronizer.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-env אפשר להגדיר את הערך synchronizer.podDisruptionBudget.minAvailable כדי לציין את מספר הפודים המינימלי של הסינכרונייזר בסביבה הזו שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 מספר הרפליקות המקסימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של synchronizer.replicaCountMax אם הוא מוגדר.
envs[].components.synchronizer.replicaCountMin	בסיסי	הוצג בגרסה: 1.9.3 ערך ברירת מחדל: 1 מספר הרפליקות המינימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של synchronizer.replicaCountMin אם הוא מוגדר.
envs[].components.udca.replicaCountMax	בסיסי	הוצג בגרסה: 1.9.3 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של 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 בהיקף env, שאיתו יש לשייך את חשבון השירות התואם של 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 לשרתי proxy של API.
envs[].httpProxy.port	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא ההגדרה הזאת קובעת את היציאה שבה פועל ה-HTTP proxy. אם לא מציינים את המאפיין הזה, המערכת משתמשת ביציאה 80 ל-HTTP וביציאה 443 ל-HTTPS כברירת מחדל.
envs[].httpProxy.scheme	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: HTTPS מציינת את סוג ה-HTTP proxy כ-HTTP או כ-HTTPS. כברירת מחדל, המערכת משתמשת ב-HTTPS.
envs[].httpProxy.username	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם שרת ה-Proxy של HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.
envs[].httpProxy.password	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם ה-HTTP proxy דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.
envs[].managementCallsSkipProxy	Advanced	הוצג בגרסה: 1.15.1 ערך ברירת המחדל: false משמש לצד envs[].httpProxy. אם מגדירים את האפשרות true עבור פרוקסי קדימה ברמת הסביבה, המערכת תדלג על פרוקסי קדימה עבור מעקב וניתוח (שמשתמשים ב-googleapis.com).
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 Agent, בדרך כלל חשבון השירות apigee-runtime. במאמר מידע על חשבונות שירות מפורטים שמות ברירת המחדל של חשבונות השירות והתפקידים שהוקצו להם.
envs[].serviceAccountPaths.synchronizer	בסיסי	הוצג בגרסה: 1.0 ערך ברירת מחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Apigee Synchronizer Manager.
envs[].serviceAccountPaths.udca	בסיסי	הוצג בגרסה: 1.0 ערך ברירת מחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Apigee Analytic Agent. מגדירים את המאפיין הזה רק אם המאפיין orgScopedUDCA מוגדר לערך false.
envs[].serviceAccountSecretProviderClass	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: ללא השם של מחלקת ספק הסודות הספציפית לסביבה (SecretProviderClass) שמשמשת לאחסון מפתחות של חשבונות שירות ב-Vault. מידע נוסף מופיע במאמר אחסון מפתחות של חשבונות שירות ב-Hashicorp Vault.
envs[].serviceAccountSecretRefs.runtime	בסיסי	הוצגה בגרסה: 1.4.0 ערך ברירת מחדל: ללא השם של סוד ב-Kubernetes. צריך ליצור את הסוד באמצעות מפתח של חשבון שירות ב-Google עם התפקיד Cloud Trace Agent כקלט.
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 Secrets in the Kubernetes documentation יצירת סוד באמצעות 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.

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

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

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

מאפיין (property)	סוג	תיאור
httpProxy.host	בסיסי	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא שם המארח של Proxy ל-HTTP.
httpProxy.password	בסיסי	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא אם ה-HTTP proxy דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.
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 הזה. אפשר להגדיר את הדגל הזה גם אם לסביבת זמן הריצה יש הגדרת פרוקסי משלה. במקרה כזה, נתוני הניפוי באגים או הניתוח של זמן הריצה ישתמשו בפרוקסי המשותף ברמת הארגון, בעוד שתנועת הגולשים בבק-אנד או בפרוקסי תמשיך להשתמש בפרוקסי ברמת הסביבה (כולל קריאות ל-googleapis.com).
httpProxy.username	בסיסי	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא אם שרת ה-Proxy של HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.

ingressGateways

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

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

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

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

מאפיין (property)	סוג	תיאור
ingressGateways[].name	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: ללא חובה השם של שער הכניסה. שירותים אחרים ישתמשו בשם הזה כדי להפנות תנועה לשער. השם צריך לעמוד בדרישות הבאות: האורך המקסימלי הוא 17 תווים להכיל רק תווים אלפאנומריים באותיות קטנות, '-' או '.' להתחיל בתו אלפאנומרי להסתיים בתו אלפאנומרי מידע נוסף זמין במאמר DNS Subdomain Names במסמכי התיעוד של Kubernetes.
ingressGateways[].podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-org מחליפים את הערך של apigeeIngressGateway.podDisruptionBudget.minAvailable כדי להגדיר את מספר הפודים המינימלי של שער הכניסה הזה שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 כדי להגדיר את המספר המקסימלי של פודים בשער הכניסה הזה שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 מגבלת הזיכרון של המשאב, במביבייט.
ingressGateways[].resources.requests.cpu	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: 300m השימוש במעבד שנדרש לפעולה רגילה של המשאב, במיליליבות.
ingressGateways[].resources.requests.memory	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: 128Mi הזיכרון שנדרש לפעולה רגילה של המשאב, במביבייט.
ingressGateways[].replicaCountMax	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: 10 מספר הפודים המקסימלי שהמערכת ההיברידית יכולה להוסיף אוטומטית עבור שער הכניסה שזמין להתאמת קנה מידה אוטומטית.
ingressGateways[].replicaCountMin	בסיסי	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: 2 מספר הפודים המינימלי של שער הכניסה שזמין להרחבה אוטומטית.
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 סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. אם השימוש במעבד עולה מעל הערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים ב-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
ingressGateways[].tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

istiod

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

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

מאפיין (property)	סוג	תיאור
istiod.accessLogFile	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: /dev/stdout כתובת הקובץ של יומן הגישה של התנועה הנכנסת, לדוגמה /dev/stdout. אם לא מגדירים את הערך הזה, רישום הגישה מושבת.
istiod.accessLogFormat	Advanced	הוצג בגרסה: 1.8.0 הפורמט של יומן הגישה לתעבורה נכנסת. אם לא מגדירים את הערך הזה, המערכת משתמשת בפורמט ברירת המחדל של יומן הגישה של השרת הפרוקסי. פורמט ברירת המחדל של יומן הגישה: '{"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 ההגדרה הזו קובעת איך Envoy proxy (בשער הכניסה של Apigee) מטפל בכותרת ה-HTTP‏ x-forwarded-client-cert (XFCC). הערכים שאפשר לבחור הם: ‫SANITIZE_SET (ברירת מחדל) כשחיבור הלקוח הוא mTLS, מאפסים את כותרת ה-XFCC עם פרטי אישור הלקוח ושולחים אותה ל-hop הבא. FORWARD_ONLY אם חיבור הלקוח הוא mTLS (פרוטוקול TLS הדדי), צריך להעביר רק את כותרת ה-XFCC בבקשה. APPEND_FORWARD אם חיבור הלקוח הוא mTLS, מוסיפים את פרטי אישור הלקוח לכותרת XFCC של הבקשה ומעבירים אותה. SANITIZE אל תעבירו את הכותרת XFCC. ALWAYS_FORWARD_ONLY תמיד מעבירים את הכותרת XFCC בבקשה, בלי קשר לשאלה אם חיבור הלקוח הוא mTLS. מידע נוסף על הערכים האלה זמין במאמר בנושא Enum extensions.filters.network.http_connection_manager.v3.HttpConnectionManager.ForwardClientCertDetails בתיעוד של Envoy. אם משנים את ההגדרה הזו אחרי ההתקנה של 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) על ידי ביטול רשימת ההיתרים של סוכן המשתמש שמוגדרת כברירת מחדל בהגדרה היברידית. הערה: השימוש במאפיין ההגדרה הזה נתמך רק בהתקנות היברידיות באמצעות תרשימי 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 של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
istiod.image.tag	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
istiod.image.url	Advanced	הוצג בגרסה: 1.8.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
istiod.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

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

logger

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

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

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

מאפיין (property)	סוג	תיאור
logger.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
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 אם מפעילים HTTP forward proxy. אפשר לעיין בNO_PROXY במסמכי התיעוד של Fluent Bit.
logger.flushInterval	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: 1 מרווח הזמן להמתנה לפני הפעלת מאגר הנתונים הזמני הבא, בשניות.
logger.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-logger Google IAM שאותו רוצים לשייך לחשבון השירות התואם של Kubernetes כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לעיין במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
logger.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
logger.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
logger.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
logger.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
logger.serviceAccountPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Logs Writer.
logger.serviceAccountRef	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הפניה לסוד ב-Kubernetes לקובץ מפתח של חשבון שירות ב-Google. מידע נוסף זמין במאמר בנושא אחסון מפתחות של חשבונות שירות בסודות של Kubernetes.
logger.storageMaxChunks	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת המחדל: 128 המספר המקסימלי של חלקי נתונים שיכולים להיות בזיכרון. חלקים שחורגים מהמגבלה יישמרו במערכת הקבצים.
logger.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
logger.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

mart

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

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

מאפיין (property)	סוג	תיאור
mart.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
mart.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-mart Google IAM שאותו רוצים לשייך לחשבון השירות התואם של Kubernetes כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לעיין במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
mart.hostAlias	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא כינוי המארח שמצביע על אובייקט MART. אפשר להגדיר את המאפיין הזה כ-* או כשם דומיין שמוגדר במלואו.
mart.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
mart.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mart.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
mart.initCheckCF.resources.requests.cpu	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 10m כמות משאבי המעבד שהוקצו לבדיקת האתחול של תהליך 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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: mart: podDisruptionBudget: maxUnavailable: 1
mart.readinessProbe.failureThreshold	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
mart.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 ל-Secret.
mart.sslKeyPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. נתיב במערכת הקבצים המקומית לטעינה וקידוד של מפתח ה-SSL ל-Secret.
mart.sslSecret	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא צריך לציין sslCertPath/sslKeyPath או sslSecret. השם של קובץ שמאוחסן בסוד של Kubernetes ומכיל את אישור ה-TLS ואת המפתח הפרטי. key. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט. מידע נוסף: אחסון נתונים בסוד של Kubernetes Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes
mart.targetCPUUtilizationPercentage	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול המעבד (CPU) של תהליך ה-MART ביחידת ה-pod. הערך בשדה הזה מאפשר ל-MART לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
mart.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mart.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

metrics

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

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

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

מאפיין (property)	סוג	תיאור
metrics.adapter.image.pullPolicy	Advanced	הוצג בגרסה: 1.8.1 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
metrics.adapter.image.tag	Advanced	הוצג בגרסה: 1.8.1 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.adapter.image.url	Advanced	הוצג בגרסה: 1.8.1 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.adapter.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של פודים של מתאם מדדים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: minAvailable: "50%"
metrics.adapter.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של מתאם מדדים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: adapter: podDisruptionBudget: maxUnavailable: 1
metrics.adapter.resources.limits.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 500m מגבלת השימוש במעבד (CPU) למשאב המתאם בקונטיינר Kubernetes, במילי-ליבות.
metrics.adapter.resources.limits.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 4Gi מגבלת הזיכרון של משאב המתאם בקונטיינר Kubernetes, בגיביבייט.
metrics.adapter.resources.requests.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 100m השימוש במעבד שנדרש לפעולה רגילה של המתאם במאגר Kubernetes, במילי-ליבות.
metrics.adapter.resources.requests.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 128Mi הזיכרון שנדרש לפעולה רגילה של המתאם במאגר Kubernetes, במביבייט.
metrics.aggregator.resources.requests.cpu	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המצבר במאגר Kubernetes, במילי-ליבות.
metrics.aggregator.resources.requests.memory	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האגרגטור במאגר Kubernetes, במביבייט.
metrics.aggregator.resources.limits.cpu	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת השימוש במעבד (CPU) למשאב המצטבר בקונטיינר Kubernetes, במילי-ליבות.
metrics.aggregator.resources.limits.memory	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 3Gi מגבלת הזיכרון של משאב המצטבר בקונטיינר Kubernetes, בגיביבייט.
metrics.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
metrics.app.resources.requests.cpu	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.app.resources.requests.memory	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האפליקציה במאגר Kubernetes, במביבייט.
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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 exporter של אפליקציות שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: appStackdriverExporter: podDisruptionBudget: maxUnavailable: 1
metrics.appStackdriverExporter.resources.limits.cpu	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת המחדל: 500m מגבלת המעבד (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 המעבד שנדרש לפעולה רגילה של 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.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.collector.image.url	בסיסי	הוצג בגרסה: 1.12.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.collector.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-telemetry מספר המינימלי של פודים של איסוף מדדים שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה. מכיוון שהמלקט פועל כ-DaemonSet, ברירת המחדל מגדירה את minAvailable ל-80% מהפודים של המלקט (מעוגל כלפי מטה) במקום להשתמש ב-maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: minAvailable: "50%"
metrics.collector.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המקסימלי של פודים של אוספי מדדים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה. מכיוון שהמלקט פועל כ-DaemonSet, ברירת המחדל מגדירה את minAvailable ל-80% מהפודים של המלקט (מעוגל כלפי מטה) במקום להשתמש ב-maxUnavailable: 1. לדוגמה, ב-overrides.yaml: metrics: collector: podDisruptionBudget: maxUnavailable: 1
metrics.collector.resources.requests.cpu	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.collector.resources.requests.memory	Advanced	הוצג בגרסה: 1.12.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האפליקציה במאגר Kubernetes, במביבייט.
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 בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-metrics Google IAM שאותו רוצים לשייך לחשבון השירות התואם של Kubernetes כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לעיין במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
metrics.nodeSelector.key	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צמתים ייעודיים של 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 של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
metrics.prometheus.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.prometheus.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 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, במילי-ליבות.
metrics.prometheus.resources.limits.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 4Gi מגבלת הזיכרון למשאב prometheus במאגר Kubernetes, בגיביבייט.
metrics.prometheus.resources.requests.cpu	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 128m השימוש במעבד שנדרש לפעולה רגילה של Prometheus במאגר Kubernetes, במילי-ליבות.
metrics.prometheus.resources.requests.memory	Advanced	הוצג בגרסה: 1.14.1 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של Prometheus במאגר Kubernetes, במביבייט.
metrics.prometheus.sslCertPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה הנתיב לאישור ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים. ראו: metrics למידע נוסף, אפשר לעיין באתר Prometheus
metrics.prometheus.sslKeyPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה הנתיב למפתח ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים. ראו: metrics למידע נוסף, אפשר לעיין באתר Prometheus
metrics.proxy.resources.requests.cpu	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש להפעלה רגילה של ה-proxy במאגר Kubernetes, במילי-ליבות.
metrics.proxy.resources.requests.memory	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של ה-proxy בקונטיינר Kubernetes, במביבייט.
metrics.proxy.resources.limits.cpu	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת השימוש במעבד (CPU) למשאב ה-proxy בקונטיינר Kubernetes, במילי-ליבות.
metrics.proxy.resources.limits.memory	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של משאב ה-proxy במאגר Kubernetes, בגיביבייט.
metrics.proxyStackdriverExporter.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-telemetry המספר המינימלי של פודים של Stackdriver exporter proxy שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז צמתים. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (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 המספר המקסימלי של פודים של Stackdriver exporter של מדדים שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: metrics: proxyStackdriverExporter: podDisruptionBudget: maxUnavailable: 1
metrics.proxyStackdriverExporter.resources.requests.cpu	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת המחדל: 128m המעבד שנדרש לפעולה רגילה של 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 של פרוקסי ה-sidecar של תהליך המדדים באשכול 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.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.sdSidecar.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
metrics.serviceAccountPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כתיבת מדדים ב-Monitoring.
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 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
metrics.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

mintTaskScheduler

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

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

מאפיין (property)	סוג	תיאור
mintTaskScheduler.gsa	Advanced	הוצג בגרסה: 1.15.1 ערך ברירת מחדל: ללא כתובת האימייל של apigee-mint-task-scheduler חשבון השירות (GSA) של Google IAM שאותו רוצים לשייך לחשבון השירות התואם של Kubernetes כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה אם הגדרתם את gcp.workloadIdentity.enabled לערך true. כתובות אימייל של GSA הן בדרך כלל בפורמט הבא: GSA_NAME@PROJECT_ID.iam.gserviceaccount.com לדוגמה: [e-mail] טיפ: אפשר למצוא את כתובת האימייל של חשבונות השירות באמצעות הפקודה הבאה: gcloud iam service-accounts list --project ${PROJECT_ID} --filter "apigee" אפשר לעיין במאמרים הפעלת Workload Identity ב-GKE או הפעלת איחוד שירותי אימות הזהות של עומסי עבודה ב-AKS וב-EKS.
mintTaskScheduler.image.pullPolicy	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
mintTaskScheduler.image.tag	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mintTaskScheduler.image.url	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
mintTaskScheduler.resources.requests.memory	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
mintTaskScheduler.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

newDataPipeline

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

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

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

nodeSelector

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

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

מאפיין (property)	סוג	תיאור
nodeSelector.apigeeData.key	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: cloud.google.com/gke-nodepool ‫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 הוא הצומת של סביבת זמן הריצה של הפרויקט. מפתח של תווית לבחירת צמתים (Node) לטירגוט צמתים של 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 לא יכול למצוא צמתים עם התווית key/value שהוגדרה , לא תתבצע תזמון של קבוצות ה-Pod הבסיסיות בצמתים של מכונות וירטואליות מסוג worker. בגרסת הייצור, הערך של 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 Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes
redis.envoy.image.pullPolicy	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
redis.envoy.image.tag	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.envoy.image.url	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
redis.envoy.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-redis מספר המינימום של פודים של Redis Envoy שצריכים להישאר זמינים במהלך שיבוש מרצון, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: minAvailable: "50%"
redis.envoy.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-redis המספר המקסימלי של פודים של Redis Envoy שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: redis: envoy: podDisruptionBudget: maxUnavailable: 1
redis.image.pullPolicy	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
redis.image.tag	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
redis.image.url	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
redis.replicaCount	בסיסי	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: 2 ‫Redis הוא אחסון משוכפל. המאפיין הזה מציין את מספר צמתי Redis שמועסקים כ-StatefulSet.
redis.resources.requests.cpu	Advanced	הוצגה בגרסה: 1.6.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות. ב-Apigee מומלץ להשתמש בערך בין 500m ל-1000m. עם 0.5 ליבות, צומת Redis יכול בדרך כלל לטפל ב-10,000 QPS. עם ליבה 1.0, בדרך כלל אפשר לטפל ב-20,000 QPS. ברוב המקרים, בקשות למשאבי מעבד (CPU) מעל 1000m לא מועילות.
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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
redis.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

runtime

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

מאפיין (property)	סוג	תיאור
runtime.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
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 של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
runtime.hpaBehavior.scaleDown.percent.periodSeconds	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: 60 חלון הזמן שבו המדיניות צריכה להיות בתוקף כשמצמצמים את מספר המופעים של זמן הריצה באחוז מסוים.
runtime.hpaBehavior.scaleDown.percent.value	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: 20 היקף השינוי שמותר לפי המדיניות כשמצמצמים את אחוז המופעים של זמן הריצה.
runtime.hpaBehavior.scaleDown.pods.periodSeconds	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: 60 חלון הזמן שבו המדיניות צריכה להיות תקפה כשמצמצמים את מספר המופעים של זמן הריצה.
runtime.hpaBehavior.scaleDown.pods.value	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: 20 היקף השינוי שמותר לפי המדיניות כשמצמצמים את מספר המופעים של זמן הריצה.
runtime.hpaBehavior.scaleDown.selectPolicy	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: Min ההחלטה שמתקבלת על ידי מידרוג אוטומטי בין כמה מדיניות להתאמה אוטומטית לעומס. הגדרת הערך ל-Min מאפשרת את השינוי הקטן ביותר בהקטנת קנה המידה של מופעי זמן ריצה. הגדרת הערך ל-Max מאפשרת את השינוי הגדול ביותר בהקטנת מספר המופעים בזמן הריצה.
runtime.hpaBehavior.scaleDown.stabilizationWindowSeconds	Advanced	הוצגה בגרסה: 1.7.0 ערך ברירת מחדל: 120 מספר השניות שבהן המלצות קודמות צריכות להילקח בחשבון במהלך הקטנת המשאבים.
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.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
runtime.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב אחר ל-pods של זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.minAvailable. לדוגמה, ב-overrides.yaml: runtime: podDisruptionBudget: minAvailable: "50%"
runtime.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-env המספר המקסימלי של פודים של זמן ריצה שלא יכולים להיות זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. כדי להגדיר תקציב אחר ל-pods של זמן הריצה בסביבה ספציפית, משתמשים ב-envs[].components.runtime.podDisruptionBudget.maxUnavailable. לדוגמה, ב-overrides.yaml: runtime: podDisruptionBudget: maxUnavailable: 1
runtime.readinessProbe.failureThreshold	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 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 החדש לצד הקיים ומעביר אליו את תנועת הגולשים בשלבים לפני שמקטין את ה-ReplicaSet הישן. השיטה הזו מאפשרת העברה מדורגת של תנועת הגולשים, אבל היא דורשת זמנית קיבולת נוספת של מחשוב (עד פי שניים בערך ממספר הפודים במצב יציב) במהלך ההפצה. מומלץ לרוב סביבות הייצור. ‫scale-down-first: מחליף את הפודים אחד אחרי השני, ומרוקן פוד קיים לפני שהוא יוצר את הפוד שיחליף אותו. מכיוון שכל החלפה היא אחת לאחת, הגרסה נשארת במסגרת מספר הפודים במצב יציב ולא נדרש מרווח נוסף לחישוב. אפשר להשתמש באפשרות הזו עבור אשכולות ללא שינוי גודל אוטומטי של הצמתים, כמו התקנות עם מגבלות חומרה או התקנות 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, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-4Gi. הגדלת runtime.resources.limits.memory ל-6Gi. הגדלת runtime.resources.requests.memory ל-4GB. פרטים נוספים זמינים במאמר בנושא הגדרת תמיכה במטען ייעודי (payload) של הודעות גדולות ב-Apigee Hybrid.
runtime.resources.requests.cpu	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות. הערה: כדי להשיג שינוי גודל אוטומטי חלק של מעבדי ההודעות כדי להתאים לעלייה בתנועת הגולשים, מומלץ לא לחרוג משני ליבות (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 מספיק להפעלה ולהגדרה הראשוניות, אבל צריך להגדיל אותו בשביל סביבת ייצור. כדי להשיג שינוי גודל אוטומטי חלק של מעבדי ההודעות כדי להתאים לעלייה בתנועה, מומלץ לא לחרוג מ-2.5Gi ‏ (2,560Mi) אם מחליטים לשנות את ברירת המחדל. הערה: אם אתם משתמשים במטענים ייעודיים (payloads) של הודעות בגודל של יותר מ-10MB, אתם צריכים לבצע את שינויי ההגדרה הבאים: מגדילים את גודל הערימה ל-4Gi. הגדלת runtime.resources.limits.memory ל-6Gi. הגדלת runtime.resources.requests.memory ל-4GB. פרטים נוספים זמינים במאמר בנושא הגדרת תמיכה במטען ייעודי (payload) של הודעות גדולות ב-Apigee Hybrid.
runtime.service.type	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: ClusterIP סוג השירות. אפשר להגדיר את זה לשירות אחר מלבד ClusterIP, למשל, LoadBalancer.
runtime.targetCPUUtilizationPercentage	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול המעבד (CPU) של תהליך זמן הריצה ב-Pod. הערך בשדה הזה מאפשר לזמן הריצה לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
runtime.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 3600 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
runtime.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

synchronizer

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

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

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

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

udca

‫(Universal Data Collection Agent) מגדיר את השירות שפועל ב-pod לאיסוף נתונים במישור זמן הריצה. השירות הזה מחלץ נתונים של ניתוח וסטטוס פריסה ושולח אותם אל Unified Analytics Platform ‏ (UAP).

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

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

מאפיין (property)	סוג	תיאור
udca.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
udca.fluentd.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
udca.fluentd.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של 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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
udca.fluentd.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
udca.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-udca 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.
udca.image.pullPolicy	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
udca.image.tag	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
udca.image.url	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-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 מבצע סקר של ספריית הנתונים במערכת הקבצים של פוד איסוף הנתונים כדי לזהות קבצים חדשים להעלאה.
udca.replicaCountMax	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 4 המספר המקסימלי של פודים שהפריסה ההיברידית יכולה להוסיף אוטומטית לפריסת ה-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, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים, עד 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 השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
udca.resources.requests.memory	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
udca.revision	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: v1 ערך סטטי שמאוכלס בתווית כדי לאפשר פריסות קנריות.
udca.serviceAccountPath	בסיסי	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Apigee Analytics Agent.
udca.serviceAccountRef	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הפניה לסוד ב-Kubernetes לקובץ מפתח של חשבון שירות ב-Google. מידע נוסף זמין במאמר בנושא אחסון מפתחות של חשבונות שירות בסודות של Kubernetes.
udca.targetCPUUtilizationPercentage	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. בשיטה ההיברידית נעשה שימוש משולב בכל המכולות ב-pod לאיסוף נתונים (גם fluentd וגם UDCA) כדי לחשב את רמת הניצול הנוכחית. אם השימוש במעבד (CPU) יעלה מעל הערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים ב-ReplicaSet, עד udca.replicaCountMax.
udca.terminationGracePeriodSeconds	Advanced	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 600 הזמן המקסימלי בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה מסודרת. ה-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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
udca.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
udca.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
udca.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.

virtualhosts

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

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

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

מאפיין (property)	סוג	תיאור
virtualhosts[].additionalGateways	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא רשימה של Istio Gateways להפניית תעבורה אליהם.
virtualhosts[].cipherSuites[]	Advanced	הוצג בגרסה: 1.9.2 ערך ברירת מחדל: ללא הנכס הזה מגדיר את הצפנות TLS שמשמשות בשער הכניסה. בהמשך מופיעה רשימה של הצפנות שמופעלות כברירת מחדל בפורמט OpenSSL. מידע נוסף על הצפנות הנתמכות זמין במסמכי התיעוד של Boring FIPS build of Envoy. אם לא מציינים ערך, ברירת המחדל היא חבילות ההצפנה שנתמכות על ידי גרסת ה-FIPS של Envoy. ‫TLS v1.3: מופעל כברירת מחדל חבילות הצפנה נוספות TLS_AES_128_GCM_SHA256 TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 אי אפשר לשנות את TLS 1.3 ciperhsuites. ‫TLS v1.2: מופעל כברירת מחדל חבילות הצפנה נוספות ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-GCM-SHA384 AES128-GCM-SHA256 AES128-SHA AES256-GCM-SHA384 AES256-SHA ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES128-SHA ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-ECDSA-AES256-SHA ECDHE-ECDSA-CHACHA20-POLY1305 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-SHA ECDHE-RSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-SHA ECDHE-RSA-CHACHA20-POLY1305 ‫TLS v1.1: מופעל כברירת מחדל חבילות הצפנה נוספות הפרוטוקול TLS v1.1 לא מופעל כברירת מחדל. ECDHE-ECDSA-AES128-GCM-SHA256 ECDHE-RSA-AES128-GCM-SHA256 ECDHE-ECDSA-AES256-GCM-SHA384 ECDHE-RSA-AES256-GCM-SHA384 ECDHE-ECDSA-CHACHA20-POLY1305 ECDHE-RSA-CHACHA20-POLY1305 ECDHE-ECDSA-AES128-SHA ECDHE-ECDSA-AES256-SHA ECDHE-RSA-AES256-SHA כדי להפעיל עוד חבילות הצפנה, מוסיפים אותן למאפיין virtualhosts.cipherSuites יחד עם גרסת ה-TLS שרוצים להפעיל אותן עבורה במאפיין virtualhosts.minTLSProtocolVersion. לדוגמה, כדי להפעיל את כל חבילות ההצפנה המקובלות של TLS v.1.2, מוסיפים את השורה הבאה להגדרה של virtualhosts: virtualhosts: - name: ENV_GROUP_NAME minTLSProtocolVersion: "1.2" cipherSuites: - "AES128-GCM-SHA256" - "AES128-SHA" - "AES256-GCM-SHA384" - "AES256-SHA" - "ECDHE-ECDSA-AES128-GCM-SHA256" - "ECDHE-ECDSA-AES128-SHA" - "ECDHE-ECDSA-AES256-GCM-SHA384" - "ECDHE-ECDSA-AES256-SHA" - "ECDHE-ECDSA-CHACHA20-POLY1305" - "ECDHE-RSA-AES128-GCM-SHA256" - "ECDHE-RSA-AES128-SHA" - "ECDHE-RSA-AES256-GCM-SHA384" - "ECDHE-RSA-AES256-SHA" - "ECDHE-RSA-CHACHA20-POLY1305" ... אם רוצים להפעיל גרסאות ישנות יותר של TLS בפריסת שער הכניסה של Apigee, משתמשים במאפיינים virtualhosts.minTLSProtocolVersion ו- virtualhosts.cipherSuites. לדוגמה, כדי להפעיל את TLS v.1.1: virtualhosts: - name: ENV_GROUP_NAME minTLSProtocolVersion: "1.1" cipherSuites: - "ECDHE-ECDSA-AES128-GCM-SHA256" - "ECDHE-RSA-AES128-GCM-SHA256" - "ECDHE-ECDSA-AES256-GCM-SHA384" - "ECDHE-RSA-AES256-GCM-SHA384" - "ECDHE-ECDSA-CHACHA20-POLY1305" - "ECDHE-RSA-CHACHA20-POLY1305" - "ECDHE-ECDSA-AES128-SHA" - "ECDHE-RSA-AES128-SHA" - "ECDHE-ECDSA-AES256-SHA" - "ECDHE-RSA-AES256-SHA" ... הערה: הנכס הזה מבטל את רשימת חבילות ההצפנה שנתמכות על ידי Envoy, ולא מוסיף לה. הערה: הנכס virtualhosts.cipherSuites משתמש בפורמט של סט האלגוריתמים להצפנה (cipher suite) של OpenSSL. רשימה של צפנים עם השמות שלהם בפורמט OpenSSL וגם בפורמט IANA זמינה במאמר Translating OpenSSL cipher suite names to IANA (תרגום שמות של חבילות צפנים ב-OpenSSL ל-IANA) במסמכי התיעוד של SSL.org.
virtualhosts[].name	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה השם של המארח הווירטואלי.
virtualhosts[].maxTLSProtocolVersion	בסיסי	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: ללא הגרסה המקסימלית של פרוטוקול TLS שאפשר לבחור ב-Envoy. ‫Envoy משתמש באופן אוטומטי בגרסת פרוטוקול ה-TLS האופטימלית בין virtualhosts[].minTLSProtocolVersion לבין virtualhosts[].maxTLSProtocolVersion. הערך חייב להיות מספר. לדוגמה: virtualhosts: - name: default maxTLSProtocolVersion: "1.3" המספר מייצג את מספר גרסת ה-TLS בפורמט #.#. בדוגמה שלמעלה, "1.3" מייצג את גרסת ה-TLS של Istio‏ 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 מייצג את גרסת ה-TLS של Istio‏ TLSV1_2. אפשר לעיין גם ב ServerTLSSettings.TLSProtocol במסמכי התיעוד של Istio.
virtualhosts[].requestTimeout	בסיסי	הוצג בגרסה: 1.10.0 ערך ברירת המחדל: 300 תרשים: apigee-virtualhost מספר השניות שאחריהן הבקשה תפוג. הערך המינימלי הוא 1.
virtualhosts[].selector	בסיסי	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: app: apigee-ingressgateway חובה צמד של סלקטור-ערך של מפתח/ערך שמפנה לסלקטורים שונים של כניסה. ‫apigee-ingressgateway: להתקנות של Apigee Hybrid באמצעות שער כניסה של Apigee. ‫istio-ingressgateway: להתקנות של Apigee Hybrid באמצעות Cloud Service Mesh (גרסאות Apigee Hybrid 1.8 ואילך). אם לא מספקים תווית של סלקטור, ההגדרה מסופקת ל-Apigee ingress gateway.
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 Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes

watcher

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

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

מאפיין (property)	סוג	תיאור
watcher.annotations	Advanced	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
watcher.args.enableIssueScanning	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת המחדל: true הגדרה להפעלה או להשבתה של חשיפת בעיות אוטומטית. כש-true פועל, הוא סורק באופן אוטומטי את מצב מישור הבקרה ואת שרת ה-API של Kubernetes כדי לקבוע אם יש בעיות בהגדרות. מגדירים את הערך false כדי להשבית את התכונה 'הצגת בעיות באופן אוטומטי'. מידע נוסף מופיע במאמר בנושא חשיפת בעיות באופן אוטומטי.
watcher.args.enableLeaderElect	Advanced	הוצגה בגרסה: 1.13.0 ערך ברירת המחדל: true כשבוחרים באפשרות true (ברירת המחדל) watcher.args.enableLeaderElect, נבחר פוד צופה יחיד לניהול ולדיווח של פרטי הניתוב. כדי למנוע השבתה במהלך שדרוגים או חזרה לגרסה קודמת, צריך להגביל את זה לפוד אחד. במהלך האירועים האלה, יכולות לפעול כמה גרסאות של watcher בו-זמנית. לכל מופע של Watcher יכול להיות לוגיקה שונה ליצירת מסלולים, מה שיכול לגרום להשבתה.watcher.replicaCountMax.
watcher.args.issueScanInterval	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת המחדל: 60 המרווח בשניות שקובע את התדירות שבה Watcher סורק את מישור זמן הריצה כדי להציג בעיות באופן אוטומטי. מידע נוסף מופיע במאמר בנושא חשיפת בעיות באופן אוטומטי.
watcher.gsa	Advanced	הוצג בגרסה: 1.10.0 ערך ברירת מחדל: ללא ב-Helm בלבד: כתובת האימייל של חשבון השירות (GSA) של apigee-watcher Google IAM שאותו רוצים לשייך לחשבון השירות התואם של Kubernetes כשמפעילים Workload Identity באשכולות GKE באמצעות תרשימי Helm. מגדירים את הערך הזה כשמגדירים את הערך true לפרמטר gcp.workloadIdentity.enabled. כתובות אימייל של 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 של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
watcher.image.tag	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 1.15.8 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
watcher.image.url	Advanced	הוצגה בגרסה: 1.4.0 ערך ברירת מחדל: ללא המיקום של קובץ האימג' של Docker בשביל השירות הזה. משתמשים ב-apigee-pull-push --list כדי לראות את כתובת ה-URL הנוכחית של המאגר עבור הרכיב הזה. טיפ: כדאי להשתמש ב-hub כדי להגדיר כתובת URL של מאגר פרטי לכל הרכיבים במקום להגדיר אותם בנפרד.
watcher.podDisruptionBudget.minAvailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המינימלי של פודים של watcher שצריכים להישאר זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוי של צומת. בשדה הזה מגדירים את השדה minAvailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-minAvailable וב-maxUnavailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: minAvailable: "50%"
watcher.podDisruptionBudget.maxUnavailable	Advanced	הוצג בגרסה: 1.15.8 ערך ברירת מחדל: ללא תרשים: apigee-org המספר המקסימלי של פודים של צופים שיכולים להיות לא זמינים במהלך שיבוש רצוני, למשל במהלך שדרוג של מאגר צמתים או ניקוז של צומת. בשדה הזה מגדירים את השדה maxUnavailable של PodDisruptionBudget עבור הפודים האלה. הפונקציה מקבלת מספר שלם של פודים (1) או מחרוזת של אחוזים ("50%"). אי אפשר להשתמש ב-maxUnavailable וב-minAvailable ביחד, צריך להגדיר רק אחד מהם. הגדרת שניהם בו-זמנית נדחית על ידי אופרטור Apigee. אם לא מגדירים אף אחד מהשדות, האופרטור של Apigee עדיין יוצר PodDisruptionBudget בשביל הפודים האלה, ומשתמש ב-maxUnavailable: 1 כברירת מחדל. לדוגמה, ב-overrides.yaml: watcher: podDisruptionBudget: maxUnavailable: 1
watcher.replicaCountMax	בסיסי	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: 1 המספר המקסימלי של רפליקות של רכיב Watcher. כדי למנוע התנגשויות, צריך להגדיר את הערך הזה ל-1. ב-Apigee Hybrid נעשה שימוש ב-watcher pod אחד לכל התקנה. בחירת מנהיג בוחרת באופן אוטומטי פוד אחד של צופה. עותקים משוכפלים נוספים של פודים של watcher ייכפו למצב לא יציב. מידע נוסף זמין במאמר בנושא watcher.args.enableLeaderElect. אזהרה: אל תחרגו מהערך 1 במאפיין watcher.replicaCountMax.
watcher.replicaCountMin	בסיסי	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: 1 מספר העותקים המשוכפלים המינימלי של רכיב ה-Watcher.
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 Runtime Agent.
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 (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.operator	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת המחדל: "Equal" נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes. ‫operator מציין את הפעולה שמשמשת להפעלת effect. הערכים של operator יכולים להיות: הערך Equal תואם לערך שהוגדר ב-value. הפונקציה Exists מתעלמת מהערך שמוגדר ב-value. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.tolerationSeconds	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ההגדרה tolerationSeconds מגדירה בשניות את משך הזמן שבו פוד נשאר קשור לצומת שנכשל או לא מגיב. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.
watcher.tolerations.value	Advanced	הוצג בגרסה: 1.10.1 ערך ברירת מחדל: ללא משמשת את התכונה Taints and Tolerations של Kubernetes. ‫value הוא הערך שמפעיל את effect כש-operator מוגדר כ-Equal. פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-Tolerations (סובלנויות): מושגים.