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

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

סינון הדף

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

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

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

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

מאפיין (property) סוג תיאור
axHashSalt Advanced

הוצג בגרסה: 1.3.0

ערך ברירת המחדל: שם הארגון

אופציונלי

השם של סוד ב-Kubernetes שמכיל מלח שמשמש לחישוב גיבובים כדי להסתיר נתוני משתמשים לפני שהם נשלחים ל-Apigee Analytics. אם לא מציינים ערך salt, המערכת משתמשת ב-iloveapis123 כברירת מחדל. יוצרים את הסוד עם ערך ה-salt כקלט. אפשר להשתמש באותו מלח בכמה אשכולות כדי להבטיח תוצאות גיבוב עקביות בין האשכולות.

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

הסוואת נתוני משתמשים לצורך ניתוח

contractProvider Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: https://apigee.googleapis.com

הגדרה של נתיב API לכל ממשקי ה-API בהתקנה.

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 מעבירים את הנתונים שלהם.

imagePullSecrets.name Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

שם הסוד של Kubernetes שהוגדר כסוג docker-registry; משמש לשליפת תמונות ממאגר פרטי.

instanceID בסיסי הוצג בגרסה: 1.3.0

ערך ברירת מחדל: ללא

חובה

מזהה ייחודי של ההתקנה.

מחרוזת ייחודית לזיהוי המופע הזה. השם יכול לכלול כל שילוב של אותיות ומספרים באורך של עד 63 תווים.

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 ברמת הארגון משתמש בחשבון שירות יחיד לכל סביבות Apigee. צריך להגדיר את חשבון השירות באמצעות המאפיין udca:serviceAccountPath בהגדרה overrides.yaml (המאפיין צריך להגדיר את הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד Apigee Analytics Agent).

אם אתם מעדיפים להשתמש בסוכן UDCA נפרד לכל סביבה, צריך להגדיר את הערך של orgScopedUDCA: false ולהגדיר את הערכים של envs[].serviceAccountPaths.udca ושל envs[].serviceAccountSecretRefs.udca.

מידע נוסף זמין במאמר בנושא udca.

revision Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: "1105" (גרסת Apigee Hybrid בלי נקודות. לדוגמה, בגרסה 1.10.0, ערך ברירת המחדל הוא "1100".)

‫Apigee hybrid תומך בעדכוני Kubernetes מתגלגלים, שמאפשרים לבצע עדכוני פריסה ללא השבתה, על ידי עדכון הדרגתי של מופעי Pod במופעים חדשים.

כשמעדכנים חלק מהחלפות ברירת המחדל של YAML שגורמות לשינוי ב-Kubernetes PodTemplateSpec שמתחת לפני השטח, צריך לשנות גם את מאפיין החלפת ברירת המחדל ב-revision של הלקוח override.yaml. הדבר נדרש כדי שהבקר הבסיסי של Kubernetes‏ ApigeeDeployment (AD) יבצע עדכון מדורג בטוח מהגרסה הקודמת לגרסה החדשה. אפשר להשתמש בכל ערך טקסט באותיות קטנות, למשל: blue, a, 1.0.0

כשמשנים את המאפיין revision ומחילים אותו, מתבצע עדכון בהדרגה (rolling) לכל הרכיבים

שינויים במאפיינים של האובייקטים הבאים מחייבים עדכון של revision:

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

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

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

מאפיין (property) סוג תיאור
ao.args.disableIstioConfigInAPIServer Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: true

ההגדרה הזו מפסיקה את אספקת ההגדרות של Apigee ל-ASM שהותקן על ידי הלקוח.

  • הערך צריך להיות true בהתקנות היברידיות שמשתמשות בשער כניסה של Apigee.
  • הערך צריך להיות false בהתקנות היברידיות באמצעות Anthos 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.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

ao.image.url Advanced הוצג בגרסה: 1.2.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-operators

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

ao.installer.pullPolicy Advanced הוצג בגרסה: 1.3.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

ao.installer.tag Advanced הוצג בגרסה: 1.3.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

ao.installer.url Advanced הוצג בגרסה: 1.3.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-installer

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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 (סובלנויות): מושגים.

cassandra

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

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

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

מאפיין (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.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.auth.image.url Advanced הוצג בגרסה: 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

ערך ברירת המחדל: jmxuser

חובה

שם המשתמש של המשתמש של פעולות Cassandra JMX. משמש לאימות ולתקשורת עם ממשק Cassandra JMX.

cassandra.auth.jolokia.password בסיסי הוצגה בגרסה: 1.4.0

ערך ברירת המחדל: iloveapis123

חובה

הסיסמה של המשתמש Cassandra Jolokia JMX operations. משמש לאימות ולתקשורת עם 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. כדי ליצור את הסוד, פועלים לפי ההוראות הבאות: יצירת הסוד.

מידע נוסף:

cassandra.backup.cloudProvider Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: GCP

נדרש אם הגיבוי מופעל.

ספק שירותי ענן לאחסון גיבויים.

אפשר להגדיר את הערך ל-GCP או ל-HYBRID. מגדירים את הערך ל-GCP אם רוצים לאחסן את הגיבוי ב-Google Cloud Storage, ול-HYBRID אם רוצים לאחסן את הגיבוי בשרת מרוחק.

למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, אפשר לעיין במאמר גיבוי ושחזור של CSI.

cassandra.backup.dbStorageBucket Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

נדרש אם הגיבוי מופעל.

קטגוריה של Cloud Storage לנתוני הגיבוי. נתיב הקטגוריה של Cloud Storage צריך להיות בפורמט gs://BUCKET_NAME. הקידומת gs://‎ נדרשת בשם הקטגוריה cassandra.backup.dbStorageBucket.

cassandra.backup.enabled Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: false

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

מידע נוסף זמין במאמר בנושא גיבוי ושחזור של Cassandra.

cassandra.backup.image.pullPolicy Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

cassandra.backup.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.backup.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

cassandra.backup.schedule Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 0 2 * * *

לוח הזמנים של משימת ה-cron.

מידע נוסף זמין במאמר בנושא גיבוי ושחזור של Cassandra.

cassandra.backup.serviceAccountPath Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

אם הגיבוי מופעל, צריך להגדיר את העמודה backup.serviceAccountPath או את העמודה backup.serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל אובייקט אחסון.

cassandra.backup.serviceAccountRef Advanced הוצג בגרסה: 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

ערך ברירת מחדל: ללא

כשמגדירים את 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, כולל 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 Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

cassandra.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-hybrid-cassandra

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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

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

חובה אם מופעל שחזור.

ספק שירותי ענן לאחסון גיבויים.

למידע על גיבוי ושחזור של CSI בפלטפורמות ענן כמו Google Cloud,‏ AWS ו-Azure, אפשר לעיין במאמר גיבוי ושחזור של CSI.

cassandra.restore.dbStorageBucket Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

חובה אם מופעל שחזור.

קטגוריה ב-Cloud Storage לנתוני הגיבוי שרוצים לשחזר.

cassandra.restore.enabled Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: false

cassandra.restore.image.pullPolicy Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

cassandra.restore.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

cassandra.restore.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-cassandra-backup-utility

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

cassandra.restore.serviceAccountPath Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

אם השחזור מופעל, צריך להגדיר את העמודה restore.serviceAccountPath או restore.serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות ב-Google עם התפקיד מנהל אובייקט אחסון.

cassandra.restore.serviceAccountRef Advanced הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

אם השחזור מופעל, צריך להגדיר את העמודה restore.serviceAccountPath או restore.serviceAccountRef.

cassandra.restore.snapshotTimestamp Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

חובה אם מופעל שחזור.

חותמת הזמן של הגיבוי שצריך לשחזר.

cassandra.restore.user Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: חשבון אדמין

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

cassandra.sslCertPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

הנתיב במערכת לקובץ אישור TLS.

cassandra.sslKeyPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

הנתיב במערכת לקובץ המפתח הפרטי של TLS.

cassandra.sslRootCAPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

שרשרת האישורים לרשות האישורים (CA) הבסיסית.

cassandra.storage.capacity בסיסי הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 10Gi

חובה אם מציינים את storage.storageclass

ההגדרה קובעת את גודל הדיסק הנדרש, במביבייט (Mi) או בגיביבייט (Gi).

cassandra.storage.storageclass בסיסי הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

מציין את סוג האחסון המקומי שבו נעשה שימוש.

cassandra.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 300

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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 באינטרנט.

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

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

מאפיין (property) סוג תיאור
connectAgent.annotations Advanced הוצגה בגרסה: 1.5.0

ערך ברירת מחדל: ללא

מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.

connectAgent.server Advanced הוצג בגרסה: 1.2.0

ערך ברירת המחדל: apigeeconnect.googleapis.com:443

המיקום של השרת והיציאה של השירות הזה.

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

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

connectAgent.image.url Advanced הוצג בגרסה: 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 Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 100m

המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.

connectAgent.resources.requests.memory Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 30Mi

הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.

connectAgent.serviceAccountPath בסיסי הוצג בגרסה: 1.1.1

ערך ברירת מחדל: ללא

חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.

הנתיב לקובץ המפתח של חשבון השירות של Google עבור חשבון השירות apigee-mart.

ברוב ההתקנות, הערך של connectAgent.serviceAccountPath צריך להיות זהה לערך של mart.serviceAccountPath.

connectAgent.serviceAccountRef בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

חובה לציין את אחד מהמאפיינים serviceAccountPath או serviceAccountRef.

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

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

diagnostic

ההגדרות של כלי איסוף האבחון.

איך משתמשים בכלי לאיסוף נתונים לאבחון

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

מאפיין (property) סוג תיאור
diagnostic.bucket בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

השם של קטגוריית האחסון ב-Google Cloud שבה יאוחסנו הנתונים הדיאגנוסטיים.

איך יוצרים קטגוריות אחסון

diagnostic.container בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

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

  • ‫"apigee-cassandra" אוסף נתונים על מסד הנתונים של Cassandra. הפודים של istio-cassandra פועלים במרחב השמות apigee.
  • ‫"apigee-mart-server" אוסף נתונים על MART. הפודים של apigee-mart-server פועלים במרחב השמות apigee.
  • ‫"apigee-runtime" אוסף נתונים על מעבד ההודעות. הפודים של apigee-runtime פועלים במרחב השמות apigee.
  • ‫"apigee-synchronizer" אוסף נתונים על הכלי לסנכרון. הפודים של apigee-synchronizer פועלים במרחב השמות apigee.
  • ‫"apigee-udca" אוסף נתונים על UDCA. הפודים של apigee-udca פועלים במרחב השמות apigee.
  • ‫"apigee-watcher" אוסף נתונים על Watcher. הפודים של apigee-watcher פועלים במרחב השמות apigee.
  • ‫"istio-proxy" מתעד נתונים על שער הכניסה של Istio. הפודים של istio-proxy פועלים במרחב השמות istio-system.
diagnostic.loggingDetails.logDuration בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה אם פעולת איסוף האבחון היא LOGGING (רישום ביומן) (מוגדר באמצעות operation: "LOGGING")

משך הזמן באלפיות השנייה של נתוני היומן שנאספו. ערך טיפוסי הוא 30000.

ראה diagnostic.operation

diagnostic.loggingDetails.loggerNames[] בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה אם פעולת איסוף האבחון היא LOGGING (רישום ביומן) (מוגדר באמצעות operation: "LOGGING")

מציין לפי שם מאיזה רכיבי Logger לאסוף נתונים. ב-Apigee Hybrid גרסה 1.6.0, הערך הנתמך היחיד הוא ALL, כלומר כל רכיבי ה-logger. לדוגמה:

diagnostic:
 loggingDetails:
   loggerNames:
   - ALL
diagnostic.loggingDetails.logLevel בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה אם פעולת איסוף האבחון היא LOGGING (רישום ביומן) (מוגדר באמצעות operation: "LOGGING")

מציינת את רמת הפירוט של נתוני הרישום ביומן שייאספו. ב-Apigee hybrid 1.6, יש תמיכה רק ב-FINE.

diagnostic.namespace בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

מרחב השמות של Kubernetes שבו נמצאים הפודים שאוספים לגביהם נתונים. מרחב השמות חייב להיות הנכון עבור מאגר התגים שצוין באמצעות diagnostic.container:

‫apigee של

  • apigee-runtime
  • apigee-synchronizer
  • apigee-udca
  • apigee-watcher
  • apigee-cassandra
  • apigee-mart-server

‫istio-system של

  • istio-proxy
diagnostic.operation בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

מציינים אם רוצים לאסוף את כל הנתונים הסטטיסטיים או רק את היומנים.

הערכים הם:

diagnostic.podNames[] בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

השמות של ה-pods של Kubernetes שעבורם אוספים נתונים. לדוגמה:

diagnostic:
 podNames:
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-2wcjn
 - apigee-runtime-eng-hybrid-example-3b2ebf3-150-8vfoj-6xzn2
diagnostic.serviceAccountPath בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

חובה

הנתיב לקובץ המפתח של חשבון השירות (.json) עבור חשבון השירות עם התפקיד 'אדמין של Storage' (roles/storage.admin). ברוב ההתקנות של Apigee Hybrid, זהו חשבון השירות apigee-cassandra.

מידע על חשבונות שירות

diagnostic.tcpDumpDetails.maxMsgs בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

אחד מהמאפיינים diagnostic.tcpDumpDetails.maxMsgs או diagnostic.tcpDumpDetails.timeoutInSeconds הוא חובה אם אתם משתמשים ב-diagnostic.tcpDumpDetails.

הגדרת המספר המקסימלי של הודעות tcpDump לאיסוף. ‫Apigee ממליצה על ערך מקסימלי שלא גדול מ-1000.

diagnostic.tcpDumpDetails.timeoutInSeconds בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

אחד מהמאפיינים diagnostic.tcpDumpDetails.maxMsgs או diagnostic.tcpDumpDetails.timeoutInSeconds הוא חובה אם אתם משתמשים ב-diagnostic.tcpDumpDetails.

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

diagnostic.threadDumpDetails.delayInSeconds בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

אם אתם משתמשים ב-diagnostic.threadDumpDetails, אתם חייבים להשתמש גם ב-diagnostic.threadDumpDetails.delayInSeconds וגם ב-diagnostic.threadDumpDetails.iterations.

העיכוב בשניות בין איסוף כל dump של השרשור.

diagnostic.threadDumpDetails.iterations בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת מחדל: ללא

אם אתם משתמשים ב-diagnostic.threadDumpDetails, אתם חייבים להשתמש גם ב-diagnostic.threadDumpDetails.delayInSeconds וגם ב-diagnostic.threadDumpDetails.iterations.

מספר האיטרציות של ה-thread dump של jstack לאיסוף.

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.replicaCountMax בסיסי הוצג בגרסה: 1.9.3

ערך ברירת המחדל: 4

מספר הרפליקות המקסימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של runtime.replicaCountMax אם הוא מוגדר.

envs[].components.runtime.replicaCountMin בסיסי הוצג בגרסה: 1.9.3

ערך ברירת מחדל: 1

מספר הרפליקות המינימלי להרחבה אוטומטית. הפרמטר הזה מבטל את ההגדרה של runtime.replicaCountMin אם הוא מוגדר.

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[].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 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[].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.

envs[].sslKeyPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

צריך לציין sslCertPath/sslKeyPath או sslSecret.

הנתיב במערכת לקובץ המפתח הפרטי של TLS.

envs[].sslSecret בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

צריך לציין sslCertPath/sslKeyPath או sslSecret.

השם של קובץ שמאוחסן בסוד של Kubernetes ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט.

מידע נוסף:

gcp

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

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

מאפיין (property) סוג תיאור
gcp.region בסיסי הוצג בגרסה: 1.2.0

ערך ברירת המחדל: us-central1

חובה

מציין את האזור ב-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 של זמן הריצה.

gcp.workloadIdentityEnabled בסיסי הוצגה בגרסה: 1.4.0

ערך ברירת מחדל:false

האפשרות הזו מאפשרת להשתמש ב-Workload Identity. ‫Workload Identity מאפשר לעומסי עבודה באשכולות GKE להתחזות לחשבונות שירות של ניהול זהויות והרשאות גישה (IAM) כדי לגשת לשירותי Google Cloud.

כש-workloadIdentityEnabled מוגדר כ-false (ברירת המחדל), Apigee משתמש בחשבונות השירות של IAM לכל רכיב של Apigee Hybrid. מידע נוסף זמין במאמר מידע על חשבונות שירות.

אם הערך של workloadIdentityEnabled הוא true, Apigee משתמש בחשבונות שירות של Kubernetes במקום בחשבונות שירות של IAM, ויתעלם ממאפייני ההגדרה הבאים:

httpProxy

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

ראו גם: 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

ערך ברירת המחדל: HTTPS

הסכימה שבה נעשה שימוש בשרת ה-proxy. הערכים האפשריים הם HTTP או HTTPS. הערכים חייבים להיות באותיות רישיות בלבד.

httpProxy.username בסיסי הוצג בגרסה: 1.1.1

ערך ברירת מחדל: ללא

אם שרת ה-Proxy של HTTP דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק שם משתמש.

httpProxy.password בסיסי הוצג בגרסה: 1.1.1

ערך ברירת מחדל: ללא

אם ה-HTTP proxy דורש אימות בסיסי, צריך להשתמש במאפיין הזה כדי לספק סיסמה.

ingressGateways

הגדרת שער הכניסה של Apigee ל-Apigee Hybrid.

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

מאפיין (property) סוג תיאור
ingressGateways[].image.pullPolicy Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

ingressGateways[].image.tag Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: 1.18.7-asm.26-distroless

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

ingressGateways[].image.url Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-asm-ingress

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

ingressGateways[].name בסיסי הוצג בגרסה: 1.8.0

ערך ברירת מחדל: ללא

חובה

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

  • האורך המקסימלי הוא 17 תווים
  • להכיל רק תווים אלפאנומריים באותיות קטנות, '-' או '.'
  • להתחיל בתו אלפאנומרי
  • להסתיים בתו אלפאנומרי

מידע נוסף זמין במאמר DNS Subdomain Names במסמכי התיעוד של Kubernetes.

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

ערך ברירת המחדל: 75

סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים.

אם השימוש במעבד (CPU) יעלה מעל הערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים ב-ReplicaSet, עד ingressGateways[].replicaCountMax.

מידע נוסף על שינוי קנה מידה ב-Kubernetes זמין במאמר בנושא התאמה אופקית של קבוצות Pod לעומס במאמרי העזרה של Kubernetes.

ingressGateways[].tolerations.effect Advanced הוצג בגרסה: 1.10.1

ערך ברירת מחדל: ללא

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫effect מציין את ההשפעה שתהיה להתאמה בין toleration לבין taint. הערכים של effect יכולים להיות:

  • NoExecute
  • NoSchedule
  • PreferNoSchedule

פרטים נוספים זמינים במאמר Taints and Tolerations: Concepts (הכתמות וסובלנות: מושגים).

ingressGateways[].tolerations.key Advanced הוצג בגרסה: 1.10.1

ערך ברירת מחדל: ללא

נדרש כדי להשתמש בתכונה Taints and Tolerations של Kubernetes.

‫key מזהה את הפודים שאליהם אפשר להחיל את הסבילות.

פרטים נוספים זמינים במאמר בנושא Taints (הכתמות) ו-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.image.pullPolicy Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

istiod.image.tag Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: 1.18.7-asm.26-distroless

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

istiod.image.url Advanced הוצג בגרסה: 1.8.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-asm-istiod

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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

ערך ברירת המחדל: v0.14.2

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

kubeRBACProxy.image.url Advanced הוצג בגרסה: 1.2.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-kube-rbac-proxy

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

אם אתם לא רוצים להשתמש ב-Google Docker Hub, אתם יכולים להוריד את התמונות ולהשתמש בכתובת שבה מתארח קובץ האימג' של Docker באופן פנימי.

kubeRBACProxy.resources.limits.cpu Advanced הוצג בגרסה: 1.10.4

ערך ברירת המחדל: 500m

מגבלת המעבד (CPU) למשאב בקונטיינר Kubernetes, במילי-ליבות.

kubeRBACProxy.resources.limits.memory Advanced הוצג בגרסה: 1.10.4

ערך ברירת המחדל: 128Mi

מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.

kubeRBACProxy.resources.requests.cpu Advanced הוצג בגרסה: 1.10.4

ערך ברירת המחדל: 5m

המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.

kubeRBACProxy.resources.requests.memory Advanced הוצג בגרסה: 1.10.4

ערך ברירת המחדל: 64Mi

הזיכרון שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במביבייט.

logger

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

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

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

מאפיין (property) סוג תיאור
logger.annotations Advanced הוצגה בגרסה: 1.5.0

ערך ברירת מחדל: ללא

מפת צמדי מפתח/ערך אופציונלית שמשמשת להוספת הערות ל-pods. מידע נוסף מופיע במאמר בנושא הערות בהתאמה אישית.

logger.enabled בסיסי הוצג בגרסה: 1.0.0

ערך ברירת המחדל: false

המתג מפעיל או משבית את הרישום ביומן באשכול. במקרים שבהם לא מדובר ב-GKE, הערך הוא true. במקרים שבהם מדובר ב-Anthos או ב-GKE, הערך הוא 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.fluentd.buffer_chunk_limit Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 512k

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

logger.fluentd.buffer_queue_limit Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 6

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

logger.fluentd.flush_interval Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 5s

מרווח הזמן להמתנה לפני הפעלת ניקוי המאגר הבא, בשניות.

logger.fluentd.max_retry_wait Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 30

המרווח המקסימלי בין ניסיונות חוזרים של כתיבה, בשניות.

logger.fluentd.num_threads Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 2

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

logger.image.pullPolicy Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

logger.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 2.1.8

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

logger.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-fluent-bit

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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

logger.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 30

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

mart.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-mart-server

המיקום של קובץ האימג' של Docker בשביל השירות הזה. בודקים את קובץ values.yaml כדי למצוא את כתובת ה-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.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.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.

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 כקלט.

מידע נוסף:

mart.targetCPUUtilizationPercentage Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 75

ניצול המעבד (CPU) של תהליך ה-MART ביחידת ה-pod. הערך בשדה הזה מאפשר ל-MART לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.

mart.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 30

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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

ערך ברירת המחדל: v0.11.0

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.adapter.image.url Advanced הוצג בגרסה: 1.8.1

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-prometheus-adapter

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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.resources.requests.cpu Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: 128m

המעבד שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, באלפיות ליבה.

metrics.appStackdriverExporter.resources.requests.memory Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: 512Mi

הזיכרון שנדרש לפעולה רגילה של StackdriverExporter במאגר Kubernetes, במביבייט.

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.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 Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 48h

כמות הזמן ש-Prometheus ממתין לפני הסרת נתונים ישנים מהאחסון המקומי, בשעות.

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

ערך ברירת המחדל: v2.45.0

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.prometheus.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-prom-prometheus

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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.sslCertPath בסיסי הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

חובה

הנתיב לאישור ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים.

כך עושים זאת:

metrics.prometheus.sslKeyPath בסיסי הוצג בגרסה: 1.0.0

ערך ברירת מחדל: ללא

חובה

הנתיב למפתח ה-SSL לתהליך איסוף המדדים של Prometheus. ‫Prometheus הוא כלי ש-Apigee יכול להשתמש בו כדי לאסוף ולעבד מדדים.

כך עושים זאת:

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

ערך ברירת המחדל: v0.9.0

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

metrics.sdSidecar.image.url Advanced הוצג בגרסה: 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 Advanced הוצגה בגרסה: 1.4.0

‫Deprecated: החל מגרסה 1.8 של Hybrid, ‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. כך עושים זאת:

metrics.stackdriverExporter.resources.requests.memory Advanced הוצגה בגרסה: 1.4.0

‫Deprecated: החל מגרסה 1.8 של Hybrid, ‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. כך עושים זאת:

metrics.stackdriverExporter.resources.limits.cpu Advanced הוצגה בגרסה: 1.4.0

‫Deprecated: החל מגרסה 1.8 של Hybrid, ‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. כך עושים זאת:

metrics.stackdriverExporter.resources.limits.memory Advanced הוצגה בגרסה: 1.4.0

‫Deprecated: החל מגרסה 1.8 של Hybrid, ‏ metrics:stackdriverExporter הוחלף ב-metrics:appStackdriverExporter וב-metrics:proxyStackdriverExporter. כך עושים זאת:

metrics.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 300

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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.image.pullPolicy Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

mintTaskScheduler.image.tag Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

mintTaskScheduler.image.url Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-mint-task-scheduler

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

mintTaskScheduler.resources.requests.cpu Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: 500m

המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.

mintTaskScheduler.resources.requests.memory Advanced הוצגה בגרסה: 1.7.0

ערך ברירת המחדל: 512Mi

הזיכרון שנדרש לפעולה רגילה של המשאב במאגר 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 (סובלנויות): מושגים.

nodeSelector

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

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

מאפיין (property) סוג תיאור
nodeSelector.apigeeData.key Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: cloud.google.com/gke-nodepool

‫ApigeeData הוא הצומת של מסד הנתונים Cassandra. מפתח התווית של בורר הצמתים לטירגוט צמתי Kubernetes לעבודה עם נתוני שירותי Apigee.

איך מגדירים מאגרי צמתים ייעודיים

nodeSelector.apigeeData.value Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: apigee-data

‫apigee-data הוא הצומת של מסד הנתונים Cassandra. ערך התווית של בורר הצמתים לטירגוט צמתי Kubernetes לעבודה עם נתונים של שירותי Apigee.

איך מגדירים מאגרי צמתים ייעודיים

nodeSelector.apigeeRuntime.key Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: cloud.google.com/gke-nodepool

‫Apigee Runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. מפתח של תווית לבחירת צמתים (Node) לטירגוט צמתים של Kubernetes לשירותי זמן ריצה של Apigee.

איך מגדירים מאגרי צמתים ייעודיים

nodeSelector.apigeeRuntime.value Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: apigee-runtime

‫apigee-runtime הוא הצומת של סביבת זמן הריצה של הפרויקט. תווית של בורר צמתים ערך לטירגוט צמתים של Kubernetes לשירותי זמן ריצה של Apigee.

איך מגדירים מאגרי צמתים ייעודיים

nodeSelector.requiredForScheduling Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: false

ערך ברירת המחדל של המאפיין requiredForScheduling הוא false. אם הערך הזה מוחלף ב-true, המשמעות היא שאם Kubernetes לא יכול למצוא צמתים עם מפתח/ערך התווית שהוגדרו, לא יתבצע תזמון של ה-Pods הבסיסיים בצמתי עובד של מכונות וירטואליות.

בגרסת הייצור, הערך של 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.envoy.image.pullPolicy Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

redis.envoy.image.tag Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: v1.27.0

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

redis.envoy.image.url Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-envoy

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

redis.image.pullPolicy Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

redis.image.tag Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

redis.image.url Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-redis

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

redis.replicaCount בסיסי הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: 2

‫Redis הוא אחסון משוכפל. המאפיין הזה מציין את מספר צמתי Redis שמועסקים כ-StatefulSet.

redis.resources.requests.cpu Advanced הוצגה בגרסה: 1.6.0

ערך ברירת המחדל: 500m

השימוש במעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.

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.image.pullPolicy Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

runtime.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

runtime.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: כתובת ה-URL למשאב התמונה של ההתקנה, לדוגמה: gcr.io/apigee-release/hybrid/apigee-runtime

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

runtime.livenessProbe.failureThreshold Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 12

מספר הפעמים שבהן 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.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.replicaCountMax בסיסי הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 4

מספר הרפליקות המקסימלי שזמין לשינוי גודל אוטומטי.

runtime.replicaCountMin בסיסי הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1

מספר הרפליקות המינימלי שזמין לשינוי גודל אוטומטי.

runtime.resources.requests.cpu Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 500m

המעבד שנדרש לפעולה רגילה של המשאב במאגר Kubernetes, במילי-ליבות.

runtime.resources.requests.memory Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 512Mi (ראו הערה בהמשך)

הזיכרון שנדרש לפעולה רגילה של המשאב בקונטיינר של Kubernetes, במביבייט (Mi) או בג'יביבייט (Gi).

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

ערך ברירת המחדל: 180

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

synchronizer.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-synchronizer

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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

synchronizer.targetCPUUtilizationPercentage Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 75

ניצול יחידת העיבוד המרכזית (CPU) של תהליך הסנכרון ב-pod. הערך בשדה הזה מאפשר ל-Synchronizer לבצע שינוי אוטומטי של קנה המידה כשהשימוש במעבד מגיע לערך הזה, עד replicaCountMax.

synchronizer.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 30

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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.9.12-2

תווית הגרסה של קובץ האימג' של 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.0.0

ערך ברירת המחדל: 500m

מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.

udca.fluentd.resources.limits.memory Advanced הוצג בגרסה: 1.0.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.image.pullPolicy Advanced הוצג בגרסה: 1.0.0

ערך ברירת מחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

udca.image.tag Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

udca.image.url Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-udca

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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.replicaCountMin בסיסי הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 1

מספר הפודים המינימלי לפריסת UDCA. מכיוון ש-UDCA מוטמע כ-ReplicaSet, הפודים הם רפליקות.

אם השימוש במעבד (CPU) יעלה על udca.targetCPUUtilizationPercentage, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים, עד udca.replicaCountMax.

udca.resources.limits.cpu Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 500m

מגבלת הזיכרון של המשאב בקונטיינר Kubernetes, במביבייט.

udca.resources.limits.memory Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 500Mi

מגבלת הזיכרון של המשאב בקונטיינר 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.

udca.targetCPUUtilizationPercentage Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 75

סף השימוש במעבד לצורך שינוי קנה המידה של מספר הפודים ב-ReplicaSet, כאחוז מסך משאבי המעבד הזמינים. בשיטה ההיברידית נעשה שימוש משולב בכל המכולות ב-pod לאיסוף נתונים (גם fluentd וגם UDCA) כדי לחשב את רמת הניצול הנוכחית.

אם השימוש במעבד (CPU) עולה מעל הערך הזה, המערכת ההיברידית תגדיל בהדרגה את מספר הפודים ב-ReplicaSet, עד udca.replicaCountMax.

udca.terminationGracePeriodSeconds Advanced הוצג בגרסה: 1.0.0

ערך ברירת המחדל: 600

הזמן שעובר בין בקשה למחיקת פוד לבין השבתת הפוד, בשניות. במהלך התקופה הזו, כל ה-hooks של prestop יופעלו וכל התהליכים הפעילים יסתיימו בצורה תקינה.

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 v.1.3 (אי אפשר לבטל את ההגדרה של חבילות ההצפנה של TLS 1.3):

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256

מופעל כברירת מחדל עבור TLS v.1.2:

  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

אם רוצים להפעיל גרסאות ישנות יותר של 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"
...
virtualhosts[].name בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

חובה

השם של המארח הווירטואלי.

virtualhosts[].maxTLSProtocolVersion בסיסי הוצג בגרסה: 1.3.0

ערך ברירת מחדל: ללא

הגרסה המקסימלית של פרוטוקול TLS שאפשר לבחור ב-Envoy. ‫Envoy משתמש באופן אוטומטי בגרסת פרוטוקול ה-TLS האופטימלית בין virtualhosts[].minTLSProtocolVersion לבין virtualhosts[].maxTLSProtocolVersion. ‫Apigee hybrid תומך ב-TLSv1.0 עד TLSv1.3.

הערך חייב להיות מספר. לדוגמה:

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. ‫Apigee hybrid תומך ב-TLSv1.0 עד TLSv1.3.

הערך חייב להיות מספר. לדוגמה:

virtualhosts:
  - name: default
    minTLSProtocolVersion: "1.2"

המספר מייצג את מספר גרסת ה-TLS בפורמט #.#. בדוגמה שלמעלה, 1.2 מייצג את גרסת ה-TLS של Istio‏ TLSV1_2.

אפשר לעיין גם ב ServerTLSSettings.TLSProtocol במסמכי התיעוד של Istio.

virtualhosts[].selector בסיסי הוצג בגרסה: 1.2.0

ערך ברירת המחדל: app: apigee-ingressgateway

חובה

צמד של סלקטור-ערך של מפתח/ערך שמפנה לסלקטורים שונים של כניסה.

  • ‫apigee-ingressgateway: להתקנות של Apigee Hybrid באמצעות שער כניסה של Apigee.
  • ‫istio-ingressgateway: להתקנות של Apigee Hybrid באמצעות Anthos Service Mesh (גרסאות Apigee Hybrid 1.8 ואילך).

אם לא מספקים תווית של סלקטור, ההגדרה מסופקת ל-Apigee ingress gateway.

virtualhosts[].sslCertPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

צריך לציין sslCertPath/sslKeyPath או sslSecret.

הנתיב במערכת לקובץ אישור TLS.

virtualhosts[].sslKeyPath בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

צריך לציין sslCertPath/sslKeyPath או sslSecret.

הנתיב במערכת לקובץ המפתח הפרטי של TLS.

virtualhosts[].sslSecret בסיסי הוצג בגרסה: 1.2.0

ערך ברירת מחדל: ללא

צריך לציין sslCertPath/sslKeyPath או sslSecret.

השם של קובץ שמאוחסן בסוד של Kubernetes ומכיל את אישור ה-TLS ואת המפתח הפרטי. צריך ליצור את הסוד באמצעות נתוני המפתח והאישור של TLS כקלט.

מידע נוסף:

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.issueScanInterval Advanced הוצג בגרסה: 1.10.0

ערך ברירת המחדל: 60

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

watcher.image.pullPolicy Advanced הוצגה בגרסה: 1.4.0

ערך ברירת המחדל: IfNotPresent

ההגדרה הזו קובעת מתי kubelet מושך את קובץ האימג' של Docker של הפוד. הערכים האפשריים כוללים:

  • ‫IfNotPresent: לא מתבצעת משיכה של תמונה חדשה אם היא כבר קיימת.
  • ‫Always: תמיד ימשוך את התמונה, גם אם היא כבר קיימת.

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

watcher.image.tag Advanced הוצגה בגרסה: 1.4.0

ערך ברירת המחדל: 1.10.5

תווית הגרסה של קובץ האימג' של Docker בשירות הזה.

watcher.image.url Advanced הוצגה בגרסה: 1.4.0

ערך ברירת המחדל: gcr.io/apigee-release/hybrid/apigee-watcher

המיקום של קובץ האימג' של Docker בשביל השירות הזה.

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 Advanced הוצג בגרסה: 1.3.0

ערך ברירת מחדל: ללא

צריך לציין את serviceAccountPath או את serviceAccountRef.

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 (סובלנויות): מושגים.