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

אתם צופים כרגע בגרסה 1.5 של התיעוד של Apigee Hybrid. This version is end of life. You should upgrade to a newer version. מידע נוסף זמין במאמר בנושא גרסאות נתמכות.

Version 1.5 (unsupported)

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

• 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.

הערה: הוראות להוספת הערות בהתאמה אישית מופיעות במאמר הערות בהתאמה אישית.

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

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

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

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

mart:
    replicaCountMin: 3
    replicaCountMax: 6

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

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

בנוסף, אם אתם מגדירים פריסה מבוססת-Anthos, תוכלו לעיין ב שלב 7: הגדרת זמן הריצה ההיברידי כדי לקבל מידע על הגדרת המאפיינים האלה ב-Anthos.

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

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

מאפיין (property)	תיאור
axHashSalt	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: שם הארגון אופציונלי השם של סוד ב-Kubernetes שמכיל ערך salt לגיבוב שמשמש להצפנה של נתוני משתמשים שעברו טשטוש שנשלחים ל-Apigee Analytics. אם לא תציינו ערך salt, המערכת תשתמש בשם הארגון שלכם כברירת מחדל. יוצרים את הסוד עם ערך ה-salt כקלט. אתם יכולים להשתמש באותו מלח בכמה אשכולות כדי להבטיח תוצאות גיבוב עקביות בין האשכולות.
contractProvider	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: https://apigee.googleapis.com הגדרה של נתיב API לכל ממשקי ה-API בהתקנה.
gcpProjectID	‫Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.projectID במקום זאת. הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מזהה הפרויקט ב-Google Cloud. הפרמטר הזה פועל עם k8sClusterName (הוצא משימוש) ועם gcpRegion (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן נתוני apigee-logger ו-apigee-metrics נשלחים.
gcpRegion	‫Deprecated: בגרסה 1.2.0 ואילך, צריך להשתמש ב-gcp.region במקום זאת. הוצג בגרסה: 1.0.0 ערך ברירת המחדל: us-central1 חובה האזור או התחום (zone) הכי קרובים ב-Google Cloud של אשכול Kubernetes. המאפיין הזה פועל עם gcpProjectID (הוצא משימוש) ועם k8sClusterName (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics שולחים את הנתונים שלהם.
imagePullSecrets.name	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא שם הסוד של Kubernetes מוגדר כסוג docker-registry; משמש לשליפת תמונות ממאגר פרטי.
k8sClusterName	‫Deprecated: בגרסה 1.2.0 ואילך, במקום זאת משתמשים ב-k8sCluster.name וב-k8sCluster.region. הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא השם של אשכול Kubernetes ‏ (K8S) שבו פועל הפרויקט ההיברידי. הוא פועל עם gcpProjectID (הוצא משימוש) ועם gcpRegion (הוצא משימוש) כדי לזהות את הפרויקט ולקבוע לאן apigee-logger ו-apigee-metrics שולחים את הנתונים שלהם.
kmsEncryptionKey	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: defaults.org.kmsEncryptionKey אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. נתיב מערכת הקבצים המקומית של מפתח ההצפנה של נתוני KMS ב-Apigee.
kmsEncryptionPath	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
kmsEncryptionSecret.key	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. המפתח של סוד ב-Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
kmsEncryptionSecret.name	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kmsEncryptionKey,‏ kmsEncryptionPath או kmsEncryptionSecret. השם של סוד ב-Kubernetes שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
kvmEncryptionKey	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: defaults.org.kmsEncryptionKey אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. נתיב במערכת הקבצים המקומית של מפתח ההצפנה של נתוני KVM ב-Apigee.
kvmEncryptionPath	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. הנתיב לקובץ שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
kvmEncryptionSecret.key	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. המפתח של סוד ב-Kubernetes שמכיל מפתח הצפנה בקידוד base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
kvmEncryptionSecret.name	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אופציונלי. אפשר להשתמש רק באחד מהפרמטרים kvmEncryptionKey,‏ kvmEncryptionPath או kvmEncryptionSecret. השם של סוד ב-Kubernetes שמכיל מפתח הצפנה בקידוד Base64. מידע נוסף זמין במאמר בנושא הצפנת נתונים.
namespace	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: apigee מרחב השמות של אשכול Kubernetes שבו יותקנו רכיבי Apigee.
org	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה הארגון עם התכונה Hybrid שהוקצה לכם על ידי Apigee במהלך ההתקנה של Hybrid. ארגון הוא המאגר ברמה העליונה ב-Apigee. הוא מכיל את כל שרתי ה-proxy של ה-API והמשאבים שקשורים אליהם. אם הערך ריק, צריך לעדכן אותו בשם הארגון אחרי שיוצרים אותו.
revision	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: v120 ‫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 מידע נוסף זמין במאמר בנושא עדכונים מדורגים.
validateServiceAccounts	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: true הגדרה שמאפשרת אימות קפדני של הרשאות בחשבון שירות. השיטה הזו משתמשת ב-method testIamPermissions של Cloud Resource Manager API כדי לוודא שלחשבון השירות שצוין יש את ההרשאות הנדרשות. במקרה של חשבונות שירות של ארגון Apigee, בדיקת מזהה הפרויקט היא זו שממופה לארגון. במקרה של Metrics ו-Logger, הפרויקט שנבדק מבוסס על ההגדרה של gcpProjectID overrides.yaml. מידע נוסף מופיע ב-gcpProjectID

ao

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

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

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

מאפיין (property)	תיאור
ao.image.pullPolicy	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
ao.image.tag	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
ao.image.url	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-operators המיקום של קובץ האימג' של Docker בשביל השירות הזה.
ao.resources.limits.cpu	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 250m מגבלת המעבד (CPU) למשאב בקונטיינר Kubernetes, במילי-ליבות.
ao.resources.limits.memory	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 256Mi מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.
ao.resources.requests.cpu	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 250m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
ao.resources.requests.memory	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 256Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.

authz

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

מאפיין (property)	תיאור
authz.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
authz.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
authz.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-authn-authz המיקום של קובץ האימג' של Docker בשביל השירות הזה.
authz.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
authz.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
authz.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
authz.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
authz.readinessProbe.failureThreshold	הוצג בגרסה: Beta2 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
authz.readinessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
authz.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
authz.readinessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שצריך כדי שבקשה לבדיקת תקינות מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
authz.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
authz.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 50m כמות משאבי ה-CPU להקצאה לבקשות אימות.
authz.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 128Mi כמות משאבי הזיכרון להקצאה לבקשות אימות.

cassandra

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

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

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

מאפיין (property)	תיאור
cassandra.annotations	הוצגה בגרסה: 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	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.auth.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.auth.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra-client המיקום של קובץ האימג' של Docker בשביל השירות הזה.
cassandra.auth.jmx.password	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: iloveapis123 חובה הסיסמה של המשתמש Cassandra JMX operations. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.
cassandra.auth.jmx.username	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: apigee חובה שם המשתמש של המשתמש של פעולות 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 ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט. מידע נוסף: אחסון נתונים בסוד של Kubernetes Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes
cassandra.backup.cloudProvider	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: GCP נדרש אם הגיבוי מופעל. ספק שירותי ענן לאחסון גיבויים. אפשר להגדיר את הערך ל-GCP או ל-HYBRID. מגדירים את הערך ל-GCP אם רוצים לאחסן את הגיבוי ב-Google Cloud Storage, ול-HYBRID אם רוצים לאחסן את הגיבוי בשרת מרוחק.
cassandra.backup.dbStorageBucket	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא נדרש אם הגיבוי מופעל. קטגוריה של Cloud Storage לנתוני הגיבוי.
cassandra.backup.enabled	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: false גיבוי הנתונים לא מופעל כברירת מחדל. כדי להפעיל, מגדירים את האפשרות ל-true. מידע נוסף זמין במאמר בנושא גיבוי ושחזור של Cassandra.
cassandra.backup.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.backup.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.backup.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility המיקום של קובץ האימג' של Docker בשביל השירות הזה.
cassandra.backup.schedule	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 2 * * * לוח הזמנים של משימת ה-cron. מידע נוסף זמין במאמר בנושא גיבוי ושחזור של Cassandra.
cassandra.backup.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא אם הגיבוי מופעל, צריך להגדיר את העמודה backup.serviceAccountPath או את העמודה backup.serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל אובייקט אחסון.
cassandra.backup.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם הגיבוי מופעל, צריך להגדיר את העמודה backup.serviceAccountPath או את העמודה backup.serviceAccountRef.
cassandra.clusterName	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: apigeecluster מציין את השם של אשכול Cassandra.
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 משתמש בתכונה הזו בהתקנות במספר אזורים כדי ליצור תקשורת בין Podים, אם למרחב השמות של רשת ה-Podים אין קישוריות בין אשכולות (האשכולות פועלים ב'מצב רשת איים'), וזהו המצב שמוגדר כברירת מחדל בהתקנות שאינן GKE, כולל GKE בארגון, GKE ב-AWS, ‏ Anthos בשרת פיזי, AKS, ‏ EKS ו-OpenShift. מגדירים את cassandra.hostNetwork ל-false להתקנות באזור יחיד ולהתקנות במספר אזורים עם קישוריות בין פודים באשכולות שונים, למשל התקנות GKE. מגדירים את cassandra.hostNetwork ל-true להתקנות במספר אזורים ללא תקשורת בין Podים באשכולות שונים, למשל התקנות של GKE On-prem,‏ GKE ב-AWS,‏ Anthos בשרת פיזי,‏ AKS,‏ EKS ו-OpenShift. מידע על פריסה בכמה אזורים: דרישות מוקדמות כש-true, מדיניות DNS מוגדרת אוטומטית ל-ClusterFirstWithHostNet.
cassandra.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra המיקום של קובץ האימג' של Docker בשביל השירות הזה.
cassandra.maxHeapSize	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 512M המגבלה העליונה של זיכרון המערכת של JVM שזמין לפעולות של Cassandra, במגה-בייט.
cassandra.multiRegionSeedHost	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא כתובת ה-IP של אשכול Cassandra קיים שמשמש להרחבת האשכול הקיים לאזור חדש. מידע נוסף זמין במאמר בנושא הגדרת מארח seed במספר אזורים.
cassandra.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מפתח התווית של בורר הצמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes לשירותי נתונים של cassandra. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
cassandra.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא ערך אופציונלי של תווית לבחירת צומת שמשמש לטירגוט צמתים ייעודיים של Kubernetes עבור שירותי נתונים של cassandra ולביטול ההגדרות של nodeSelector.apigeeData. ראו nodeSelector.
cassandra.port	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 9042 מספר היציאה שמשמש להתחברות ל-cassandra.
cassandra.rack	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: ra-1 מציין את המתלה של צומת Cassandra.
cassandra.readinessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
cassandra.readinessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
cassandra.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 10 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
cassandra.readinessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שצריך כדי שבקשה לבדיקת תקינות מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
cassandra.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
cassandra.replicaCount	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 ‫Cassandra הוא מאגר נתונים משוכפל. במאפיין הזה מציינים את מספר הצמתים של Cassandra שמשמשים כ-StatefulSet.
cassandra.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
cassandra.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1Gi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
cassandra.restore.cloudProvider	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: GCP חובה אם מופעל שחזור. ספק שירותי ענן לאחסון גיבויים.
cassandra.restore.dbStorageBucket	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה אם מופעל שחזור. קטגוריה ב-Cloud Storage לנתוני הגיבוי שרוצים לשחזר.
cassandra.restore.enabled	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: false
cassandra.restore.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
cassandra.restore.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
cassandra.restore.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility המיקום של קובץ האימג' של Docker בשביל השירות הזה.
cassandra.restore.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא אם השחזור מופעל, צריך להגדיר את העמודה restore.serviceAccountPath או restore.serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל אובייקט אחסון.
cassandra.restore.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם השחזור מופעל, צריך להגדיר את העמודה restore.serviceAccountPath או restore.serviceAccountRef.
cassandra.restore.snapshotTimestamp	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה אם מופעל שחזור. חותמת הזמן של הגיבוי שצריך לשחזר.
cassandra.restore.user	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: חשבון אדמין שם המשתמש ב-Cassandra שמשמש לשחזור גיבוי הסכימה. אם לא מציינים משתמש, המערכת משתמשת במשתמש האדמין.
cassandra.sslCertPath	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא הנתיב במערכת לקובץ אישור TLS. הערה: בכל סביבה מוגדרת, השם הנפוץ (CN) באישור צריך להיות זהה לדומיין במאפיין hostAliases[]. לדוגמה, אם ה-CN הוא *.example.com, ה-hostAliases[] יכול להיות foo.example.com או bar.example.com.
cassandra.sslKeyPath	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא הנתיב במערכת לקובץ המפתח הפרטי של TLS.
cassandra.sslRootCAPath	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא שרשרת האישורים לרשות האישורים (CA) הבסיסית.
cassandra.storage.capacity	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 50Gi נדרש אם מציינים את storage.storageclass ההגדרה קובעת את גודל הדיסק הנדרש במבי-בייט.
cassandra.storage.storageclass	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא מציין את סוג האחסון המקומי שבו נעשה שימוש.
cassandra.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 300 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

certmanagercainjector

ה-CA injector של cert-manager הוא תהליך של cert-manager שאחראי להחדרת חבילת ה-CA לתהליך ה-Webhook של cert-manager. מידע נוסף על CA injector מופיע במסמכי cert-manager.

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

מאפיין (property)	תיאור
certmanagercainjector.image.tag	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: v0.12.0 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
certmanagercainjector.image.url	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cert-manager-cainjector המיקום של קובץ האימג' של Docker בשביל השירות הזה.

certmanagerwebhook

ה-Webhook של cert-manager הוא תהליך שמספק בקרה דינמית על אישור בקשות למשאבי cert-manager. מידע נוסף על Webhook זמין במאמרי העזרה של cert-manager.

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

מאפיין (property)	תיאור
certmanagerwebhook.image.tag	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: v0.12.0 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
certmanagerwebhook.image.url	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cert-manager-webhook המיקום של קובץ האימג' של Docker בשביל השירות הזה.

connectAgent

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

מידע נוסף על Apigee Connect

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

מאפיין (property)	תיאור
connectAgent.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
connectAgent.enabled	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: false האם ההתקנה הזו משתמשת ב-Apigee Connect במקום ב-Istio ingress בשביל mart? נכון או לא נכון? מידע נוסף על Apigee Connect
connectAgent.server	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: apigeeconnect.googleapis.com:443 המיקום של השרת והיציאה של השירות הזה.
connectAgent.logLevel	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: INFO רמת הדיווח ביומן. הערכים האפשריים הם: ‫INFO: הודעות עם מידע חשוב בנוסף להודעות אזהרה, שגיאה והודעות קריטיות. ההגדרה הזו שימושית בעיקר לניפוי באגים. ‫WARNING: אזהרות לא קריטיות בנוסף להודעות שגיאה והודעות קריטיות. ‫ERROR: שגיאות פנימיות ושגיאות שלא מוחזרות למשתמש, בנוסף להודעות קריטיות. ‫FATAL: שגיאות ואירועים שלא ניתן לשחזר שגורמים לקריסה של Apigee Connect.
connectAgent.image.pullPolicy	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
connectAgent.image.tag	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
connectAgent.image.url	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-connect-agent המיקום של קובץ האימג' של Docker בשביל השירות הזה. בודקים את values.yaml הקובץ כדי למצוא את כתובת ה-URL הספציפית.
connectAgent.replicaCountMax	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 5 מספר הרפליקות המקסימלי שזמין לשינוי גודל אוטומטי.
connectAgent.replicaCountMin	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1 מספר הרפליקות המינימלי שזמין לשינוי גודל אוטומטי. בסביבת ייצור, כדאי להגדיל את הערך של replicaCountMin ל-3, כדי שיהיו יותר חיבורים למישור הבקרה לצורך אמינות ומדרגיות.
connectAgent.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 100m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
connectAgent.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
connectAgent.targetCPUUtilizationPercentage	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 75 ניצול המעבד (CPU) של סוכן Apigee Connect ביעד בפוד. הערך בשדה הזה מאפשר ל-Apigee Connect לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
connectAgent.terminationGracePeriodSeconds	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 600 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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[].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 ערך ברירת מחדל: ללא מציינת את סוג ה-HTTP proxy כ-HTTP או כ-HTTPS. כברירת מחדל, נעשה שימוש ב-HTTP.
envs[].httpProxy.username	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם שרת ה-Proxy של HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.
envs[].httpProxy.password	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא אם ה-HTTP proxy דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.
envs[].name	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה שם סביבת Apigee שיש לסנכרן.
envs[].pollInterval	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא המרווח שמשמש לסנכרון שינויים בארגון ובסביבה, בשניות.
envs[].port	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא מספר יציאת TCP לתנועת HTTPS.
envs[].serviceAccountPaths.runtime	הוצגה בגרסה: 1.4.0 ערך ברירת מחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Cloud Trace Agent, בדרך כלל חשבון השירות apigee-distributed-trace. במאמר מידע על חשבונות שירות מפורטים שמות ברירת המחדל של חשבונות השירות והתפקידים שהוקצו להם.
envs[].serviceAccountPaths.synchronizer	הוצג בגרסה: 1.0 ערך ברירת מחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Apigee Synchronizer Manager.
envs[].serviceAccountPaths.udca	הוצג בגרסה: 1.0 ערך ברירת מחדל: ללא הנתיב לקובץ במערכת המקומית למפתח של חשבון שירות ב-Google עם התפקיד Apigee Analytic Agent.
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 כקלט.
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 ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט. מידע נוסף: אחסון נתונים בסוד של Kubernetes Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes

gcp

המזהה של הפרויקט ב-Google Cloud והאזור שבו apigee-logger ו-apigee-metrics שולחים את הנתונים שלהם.

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

מאפיין (property)	תיאור
gcp.region	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה מציין את האזור ב-Google Cloud שבו apigee-logger ו-apigee-metrics מעבירים את הנתונים שלהם.
gcp.projectID	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה מזהה את הפרויקט ב-Google Cloud שבו apigee-logger ו-apigee-metrics מעלים את הנתונים שלהם.
gcp.projectIDRuntime	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא מזהה את פרויקט אשכול Kubernetes בזמן הריצה. המאפיין projectIDRuntime הוא אופציונלי. אם לא משתמשים בפרמטר הזה, המערכת מניחה שערך projectID משמש גם לפרויקט Google Cloud של ארגון Apigee וגם לפרויקט של אשכול K8S של זמן הריצה.

httpProxy

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

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

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

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

מאפיין (property)	תיאור
httpProxy.host	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא שם המארח של Proxy ל-HTTP.
httpProxy.port	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא היציאה של ה-Proxy ל-HTTP.
httpProxy.scheme	הוצג בגרסה: 1.1.1 ערך ברירת המחדל: HTTP הסכימה שבה נעשה שימוש בשרת ה-proxy. הערך חייב להיות HTTP באותיות רישיות. אין תמיכה בפרוקסי קדימה עם אימות ו-HTTPS.

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	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
kubeRBACProxy.image.tag	הוספנו בגרסה: 1.2.0 ערך ברירת המחדל: v0.11.0 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
kubeRBACProxy.image.url	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy המיקום של קובץ האימג' של Docker בשביל השירות הזה. אם אתם לא רוצים להשתמש ב-Google Docker Hub, אתם יכולים להוריד את התמונות ולהשתמש בכתובת שבה מתארח קובץ האימג' של Docker באופן פנימי.

logger

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

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

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

מאפיין (property)	תיאור
logger.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
logger.enabled	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: false המתג מפעיל או משבית את הרישום ביומן באשכול. במקרים שבהם לא מדובר ב-GKE, הערך הוא true. במקרים שבהם מדובר ב-Anthos או ב-GKE, הערך הוא false.
logger.fluentd.buffer_chunk_limit	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 512k הגודל המקסימלי של נתח מאגר, בקילובייט. חלקים שחורגים מהמגבלה יועברו אוטומטית לתור הפלט.
logger.fluentd.buffer_queue_limit	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 6 האורך המקסימלי של תור הפלט. המגבלה שמוגדרת כברירת מחדל היא 256 מקטעים.
logger.fluentd.flush_interval	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5s מרווח הזמן להמתנה לפני הפעלת ניקוי המאגר הבא, בשניות.
logger.fluentd.max_retry_wait	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 המרווח המקסימלי בין ניסיונות חוזרים של כתיבה, בשניות.
logger.fluentd.num_threads	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר השרשורים שמשמשים לניקוי המאגר. ערך ברירת המחדל הוא 1.
logger.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
logger.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.8.4 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
logger.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent המיקום של קובץ האימג' של Docker בשביל השירות הזה.
logger.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
logger.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
logger.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 60 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
logger.livenessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שנדרש כדי שבדיקת הפעילות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
logger.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
logger.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: apigee.com/apigee-logger-enabled חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes לשירותי זמן ריצה של logger. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
logger.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: true חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes עבור שירותי זמן ריצה של logger. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
logger.proxyURL	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא כתובת ה-URL של שרת ה-proxy של הלקוח.
logger.resources.limits.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500Mi מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.
logger.resources.limits.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 200m מגבלת המעבד (CPU) למשאב בקונטיינר Kubernetes, במילי-ליבות.
logger.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 100m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
logger.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
logger.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Logs Writer.
logger.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.
logger.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

mart

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

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

מאפיין (property)	תיאור
mart.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
mart.hostAlias	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא כינוי המארח שמצביע על אובייקט MART. אפשר להגדיר את המאפיין הזה כ-* או כשם דומיין שמוגדר במלואו.
mart.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
mart.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
mart.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-mart-server המיקום של קובץ האימג' של Docker בשביל השירות הזה. בודקים את קובץ values.yaml כדי למצוא את כתובת ה-URL הספציפית.אפשר לבטל את ההגדרה הזו.
mart.initCheckCF.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 10m כמות משאבי המעבד שהוקצו לבדיקת האתחול של תהליך Cloud Foundry.
mart.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 12 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
mart.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 15 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
mart.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
mart.livenessProbe.timeoutSeconds	הוצג בגרסה: 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.readinessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
mart.readinessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 15 מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
mart.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
mart.readinessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שצריך כדי שבקשה לבדיקת תקינות מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
mart.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
mart.replicaCountMax	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 מספר הרפליקות המקסימלי שזמין לשינוי גודל אוטומטי.
mart.replicaCountMin	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר הרפליקות המינימלי שזמין לשינוי גודל אוטומטי.
mart.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
mart.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
mart.serviceAccountPath	הוצג בגרסה: 1.1.1 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות של Google ללא תפקיד.
mart.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.
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	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול המעבד (CPU) של תהליך ה-MART ביחידת ה-pod. הערך בשדה הזה מאפשר ל-MART לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
mart.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

metrics

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

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

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

מאפיין (property)	תיאור
metrics.aggregator.resources.requests.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המצבר במאגר Kubernetes, במילי-ליבות.
metrics.aggregator.resources.requests.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האגרגטור במאגר Kubernetes, במביבייט.
metrics.aggregator.resources.limits.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת השימוש במעבד (CPU) למשאב המצטבר בקונטיינר Kubernetes, במילי-ליבות.
metrics.aggregator.resources.limits.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 3Gi מגבלת הזיכרון של משאב המצטבר בקונטיינר Kubernetes, בגיביבייט.
metrics.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
metrics.app.resources.requests.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.app.resources.requests.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של האפליקציה במאגר Kubernetes, במביבייט.
metrics.app.resources.limits.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב האפליקציה בקונטיינר Kubernetes, במילי-ליבות.
metrics.app.resources.limits.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון למשאב האפליקציה בקונטיינר Kubernetes, בגיביבייט.
metrics.enabled	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: true הפעלת מדדים של Apigee. מגדירים את הערך true כדי להפעיל את המדדים. מגדירים את הערך כ-false כדי להשבית את המדדים.
metrics.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes לשירותי זמן ריצה של metrics. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
metrics.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes עבור שירותי זמן ריצה של metrics. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
metrics.prometheus.args.storage_tsdb_retention	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 48h כמות הזמן ש-Prometheus ממתין לפני הסרת נתונים ישנים מהאחסון המקומי, בשעות.
metrics.prometheus.containerPort	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 9090 היציאה להתחברות לשירות המדדים של Prometheus.
metrics.prometheus.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
metrics.prometheus.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: v2.33.5 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.prometheus.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-prom-prometheus המיקום של קובץ האימג' של Docker בשביל השירות הזה.
metrics.prometheus.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 6 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
metrics.prometheus.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
metrics.prometheus.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 120 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
metrics.prometheus.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 3 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
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	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש להפעלה רגילה של ה-proxy במאגר Kubernetes, במילי-ליבות.
metrics.proxy.resources.requests.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של ה-proxy בקונטיינר Kubernetes, במביבייט.
metrics.proxy.resources.limits.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת השימוש במעבד (CPU) למשאב ה-proxy בקונטיינר Kubernetes, במילי-ליבות.
metrics.proxy.resources.limits.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של משאב ה-proxy במאגר Kubernetes, בגיביבייט.
metrics.proxyURL	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא כתובת ה-URL של פרוקסי ה-sidecar של תהליך המדדים באשכול Kubernetes.
metrics.sdSidecar.containerPort	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 9091 היציאה להתחברות לשירות המדדים של Cloud Operations.
metrics.sdSidecar.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent קובע מתי Kubelet מושך את קובץ האימג' של Docker של השירות הזה. הערכים האפשריים כוללים: ‫IfNotPresent: לא לשלוף תמונה חדשה אם היא כבר קיימת ‫Always: תמיד שולפים את המדיניות, גם אם היא כבר קיימת מידע נוסף זמין במאמר בנושא עדכון תמונות.
metrics.sdSidecar.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0.7.5 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
metrics.sdSidecar.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-stackdriver-prometheus-sidecar המיקום של קובץ האימג' של Docker בשביל השירות הזה.
metrics.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד כתיבת מדדים ב-Monitoring.
metrics.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.
metrics.stackdriverExporter.resources.requests.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 128m המעבד שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, באלפיות ליבה.
metrics.stackdriverExporter.resources.requests.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 512Mi הזיכרון שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, במביבייט.
metrics.stackdriverExporter.resources.limits.cpu	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 500m מגבלת המעבד (CPU) למשאב stackdriverExporter בקונטיינר Kubernetes, במילי-ליבות.
metrics.stackdriverExporter.resources.limits.memory	הוצגה בגרסה: 1.4.0 ערך ברירת המחדל: 1Gi מגבלת הזיכרון של משאב stackdriverExporter בקונטיינר Kubernetes, בגיביבייט.
metrics.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 300 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

nodeSelector

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

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

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

runtime

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

מאפיין (property)	תיאור
runtime.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
runtime.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
runtime.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
runtime.image.url	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: כתובת ה-URL למשאב התמונה של ההתקנה, לדוגמה: gcr.io/apigee-release/hybrid/apigee-runtime המיקום של קובץ האימג' של Docker בשביל השירות הזה.
runtime.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
runtime.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 60 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
runtime.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
runtime.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
runtime.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא מפתח התווית האופציונלי של בורר צמתים לטירגוט צמתים של Kubernetes עבור שירותים runtime. מידע על המאפיין nodeSelector
runtime.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא ערך התווית של בורר הצמתים לטירגוט צמתים של Kubernetes עבור שירותים של runtime. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
runtime.readinessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
runtime.readinessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 60 מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
runtime.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
runtime.readinessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שצריך כדי שבקשה לבדיקת תקינות מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
runtime.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
runtime.replicaCountMax	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי שזמין לשינוי גודל אוטומטי.
runtime.replicaCountMin	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר הרפליקות המינימלי שזמין לשינוי גודל אוטומטי.
runtime.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות. הערה: כדי להשיג שינוי גודל אוטומטי חלק של מעבדי ההודעות כדי להתאים לעלייה בתנועת הגולשים, מומלץ לא לחרוג משני ליבות (2,000 מילי-ליבות) אם מחליטים לבטל את ברירת המחדל. רכיבי זמן הריצה של Apigee מוגבלים על ידי קלט/פלט, ולא תמיד עוזר להוסיף קיבולת CPU כדי להתמודד עם עלייה בתנועה. כשיש בקשות גבוהות של יחידת עיבוד מרכזית (CPU), יכול להיות שמעבדי ההודעות לא יתבצעו באופן אוטומטי, ושהבדיקות של פעילות המערכת ייכשלו בגלל עומס תנועה גבוה.
runtime.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 512Mi (ראו הערה בהמשך) הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במביבייט (Mi) או בג'יביבייט (Gi). הערה: צריך לאפס את הערך של runtime.resources.requests.memory ל-1Gi לפחות ב-overrides.yaml. ערך ברירת המחדל 512Mi מספיק להפעלה ולהגדרה ראשוניות, אבל צריך להגדיל אותו בשביל סביבת ייצור. כדי להשיג שינוי גודל אוטומטי חלק של מעבדי ההודעות כדי להתאים לעלייה בתנועה, מומלץ לא לחרוג מ-2.5Gi ‏ (2,560Mi) אם מחליטים לשנות את ברירת המחדל.
runtime.service.type	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: ClusterIP סוג השירות. אפשר להגדיר את זה לשירות אחר מלבד ClusterIP, למשל, LoadBalancer.
runtime.targetCPUUtilizationPercentage	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול המעבד (CPU) של תהליך זמן הריצה ב-Pod. הערך בשדה הזה מאפשר לזמן הריצה לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
runtime.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 180 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

synchronizer

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

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

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

מאפיין (property)	תיאור
synchronizer.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
synchronizer.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
synchronizer.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
synchronizer.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-synchronizer המיקום של קובץ האימג' של Docker בשביל השירות הזה.
synchronizer.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
synchronizer.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
synchronizer.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
synchronizer.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
synchronizer.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה תווית אופציונלית של מפתח התווית של בורר הצמתים לטירגוט צמתים של Kubernetes עבור synchronizer שירותי זמן ריצה. ראו nodeSelector.
synchronizer.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא ערך אופציונלי של תווית לבחירת צומת, שמשמש לטירגוט צמתים של Kubernetes עבור שירותי זמן ריצה של synchronizer. ראו nodeSelector.
synchronizer.pollInterval	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 60 משך הזמן שהכלי Synchronizer ממתין בין פעולות של שליחת בקשות. הכלי Synchronizer מבצע בדיקות בשירותי מישור הבקרה של Apigee כדי לזהות ולשלוף חוזים חדשים של זמן ריצה.
synchronizer.readinessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים ש-Kubernetes יאמת ש בדיקות המוכנות נכשלו לפני שיסמן את הפוד כלא מוכן. הערך המינימלי הוא 1.
synchronizer.readinessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות שעוברות אחרי הפעלת מאגר לפני הפעלת בדיקת מוכנות.
synchronizer.readinessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה תתבצע בדיקת מוכנות. הערך המינימלי הוא 1.
synchronizer.readinessProbe.successThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר ההצלחות המינימלי ברצף שצריך כדי שבקשה לבדיקת תקינות מוכנות תיחשב כמוצלחת אחרי כשל. הערך המינימלי הוא 1.
synchronizer.readinessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
synchronizer.replicaCount	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הרפליקות לצורך שינוי גודל אוטומטי.
synchronizer.replicaCountMax	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 4 מספר הרפליקות המקסימלי להרחבה אוטומטית.
synchronizer.replicaCountMin	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: 1 מספר הרפליקות המינימלי להרחבה אוטומטית.
synchronizer.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 100m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
synchronizer.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1Gi הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר Kubernetes, בג'יגה-בייט.
synchronizer.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות של Google עם התפקיד Apigee Synchronizer Manager.
synchronizer.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.
synchronizer.targetCPUUtilizationPercentage	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 ניצול יחידת העיבוד המרכזית (CPU) של תהליך הסנכרון ב-pod. הערך בשדה הזה מאפשר ל-Synchronizer לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.
synchronizer.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 30 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

udca

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

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

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

מאפיין (property)	תיאור
udca.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
udca.fluentd.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
udca.fluentd.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.8.4 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
udca.fluentd.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent המיקום של קובץ האימג' של Docker בשביל השירות הזה.
udca.fluentd.resources.limits.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500Mi מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.
udca.fluentd.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 500m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
udca.fluentd.resources.requests.memory	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250Mi הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.
udca.image.pullPolicy	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: IfNotPresent ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים: ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת. ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת. מידע נוסף זמין במאמר בנושא עדכון תמונות.
udca.image.tag	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1.3.6 תווית הגרסה של קובץ האימג' של Docker בשירות הזה.
udca.image.url	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-udca המיקום של קובץ האימג' של Docker בשביל השירות הזה.
udca.jvmXms	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 256m כמות הזיכרון ההתחלתית של JVM בתא של איסוף הנתונים.
udca.jvmXmx	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 256m ההקצאה המקסימלית של זיכרון ל-JVM של יחידת איסוף הנתונים.
udca.livenessProbe.failureThreshold	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 2 מספר הפעמים שבהן Kubernetes יאמת ש בדיקות הפעילות נכשלו לפני הפעלה מחדש של הקונטיינר. הערך המינימלי הוא 1.
udca.livenessProbe.initialDelaySeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 0 מספר השניות אחרי הפעלת מאגר לפני הפעלת בדיקת הפעילות.
udca.livenessProbe.periodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 5 ההגדרה הזו קובעת את התדירות (בשניות) שבה יתבצע בדיקת פעילות. הערך המינימלי הוא 1.
udca.livenessProbe.timeoutSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר השניות שאחריהן בדיקת החיות מסתיימת בטיימאאוט. הערך המינימלי הוא 1.
udca.nodeSelector.key	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה מפתח תווית של בורר צמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes לשירותי זמן ריצה של udca. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
udca.nodeSelector.value	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה ערך התווית של בורר הצמתים שמשמש לטירגוט צמתים ייעודיים של Kubernetes עבור שירותי זמן ריצה של udca. מידע נוסף על הגדרת מאגרי צמתים ייעודיים
udca.pollingIntervalInSec	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 משך הזמן בשניות שבו הכלי UDCA ממתין בין פעולות של דגימה. כלי UDCA מבצע סקר של ספריית הנתונים במערכת הקבצים של פוד איסוף הנתונים כדי לזהות קבצים חדשים להעלאה.
udca.replicaCountMax	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 4 המספר המקסימלי של פודים שהפריסה ההיברידית יכולה להוסיף באופן אוטומטי עבור פריסת ה-UDCA. מכיוון ש-UDCA מיושם כ-ReplicaSet, הפודים הם רפליקות.
udca.replicaCountMin	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 1 מספר הפודים המינימלי לפריסת UDCA. מכיוון ש-UDCA מוטמע כ-ReplicaSet, הפודים הם רפליקות. אם השימוש במעבד (CPU) יעלה על udca.targetCPUUtilizationPercentage, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים, עד udca.replicaCountMax.
udca.resources.requests.cpu	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 250m השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.
udca.revision	נוסף בגרסה: 1 ערך ברירת המחדל: v1 ערך סטטי שמאוכלס בתווית כדי לאפשר פריסות קנריות.
udca.serviceAccountPath	הוצג בגרסה: 1.0.0 ערך ברירת מחדל: ללא חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef. הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Apigee Analytics Agent.
udca.serviceAccountRef	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא צריך לציין את serviceAccountPath או את serviceAccountRef.
udca.targetCPUUtilizationPercentage	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 75 סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. בשיטה ההיברידית נעשה שימוש משולב בכל המכולות ב-pod לאיסוף נתונים (גם fluentd וגם UDCA) כדי לחשב את רמת הניצול הנוכחית. אם השימוש במעבד (CPU) יעלה מעל הערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים ב-ReplicaSet, עד udca.replicaCountMax.
udca.terminationGracePeriodSeconds	הוצג בגרסה: 1.0.0 ערך ברירת המחדל: 600 הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

virtualhosts

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

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

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

מאפיין (property)	תיאור
virtualhosts[].additionalGateways	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא רשימה של Istio Gateways להפניית תעבורה אליהם.
virtualhosts[].name	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה השם של המארח הווירטואלי.
virtualhosts[].hostAliases[]	הוצג בגרסה: 1.2.0 ערך ברירת מחדל: ללא חובה ‫Deprecated: החל מגרסה 1.4 של Hybrid, מישור זמן הריצה מקבל את המידע הזה ממישור הניהול. מידע נוסף זמין במאמר הסבר על סביבות וקבוצות של סביבות.
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[].selector	הוצג בגרסה: 1.2.0 ערך ברירת המחדל: app: istio-ingressgateway חובה צמד של סלקטור-ערך של מפתח/ערך שמפנה לסלקטורים שונים של כניסה.
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 ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט. מידע נוסף: אחסון נתונים בסוד של Kubernetes Secrets in the Kubernetes documentation יצירת סוד באמצעות kubectl בתיעוד של Kubernetes

watcher

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

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

מאפיין (property)	תיאור
watcher.annotations	הוצגה בגרסה: 1.5.0 ערך ברירת מחדל: ללא מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.
watcher.replicaCountMax	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: 1 המספר המקסימלי של רפליקות של רכיב Watcher. כדי למנוע התנגשויות, צריך להגדיר את הערך הזה ל-1.
watcher.replicaCountMin	הוצג בגרסה: 1.3.0 ערך ברירת המחדל: 1 מספר העותקים המשוכפלים המינימלי של רכיב ה-Watcher.
watcher.serviceAccountPath	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: ללא חובה. הנתיב לקובץ המפתח של חשבון השירות של Google עם התפקיד Apigee Runtime Agent.
watcher.serviceAccountRef	הוצג בגרסה: 1.3.0 ערך ברירת מחדל: ללא צריך לציין את serviceAccountPath או את serviceAccountRef.