בדף הזה מוסבר על השדות השונים שבהם אפשר להשתמש כדי להגדיר את Config Sync באמצעות הדגל --config בפקודה apply של Google Cloud CLI והדגל --fleet-default-member-config בפקודה enable בגרסת beta. לא מומלץ יותר להשתמש בסכימת השדות הזו ב
alpha בערוץ ההפצה של הפקודה enable
, ועדיף להשתמש ב
סכימת ה-API החדשה
.
פורמט הקובץ שמשמש עם הפלאגים האלה של gcloud CLI דומה לפורמט של אובייקט ConfigManagement. עם זאת, הפורמטים שונים ואי אפשר להשתמש בהם לסירוגין.
הגדרה משותפת לניהול הגדרות
| מפתח | תיאור |
|---|---|
spec.version |
הגרסה של ניהול ההגדרות. אם אתם מגדירים את Config Management לאשכול, גרסת ברירת המחדל היא הגרסה הנוכחית של התקנת Config Management באשכול. אחרת, אם מדובר בהגדרה לכל צי המחשבים או אם אין התקנה קיימת באשכול היעד, ברירת המחדל היא הגרסה האחרונה. |
הגדרות של סנכרון תצורות
| מפתח | תיאור |
|---|---|
spec.cluster |
שם האשכול שמשמש את Config Sync
cluster-name-selector
annotation או ClusterSelector,
כדי להחיל הגדרות רק על קבוצת משנה של אשכולות. מגדירים את השדה הזה אם Config Sync משתמש בשם שונה משם החברות בצי של האשכול באמצעות הערת cluster-name-selector או ClusterSelector. |
spec.upgrades |
(Preview)
הגדרת השדרוג של Config Sync, לא בשימוש אחרי Config Sync
גרסה 1.21.0. הערך הנתמך היחיד הוא manual, ששווה ללא הגדרת השדה הזה.
|
spec.configSync.enabled |
אם true, מתקין ומנהל את
Config Sync.
אם false, כלומר אם מוגדרת הגדרה קודמת של Config Sync, היא תוסר ויתעלמו משאר ההגדרות של .spec.configSync.
נדרש ל-CLI של gcloud בגרסה 429.0.0 ובגרסאות קודמות. אופציונלי ל-CLI של gcloud בגרסה 430.0.0 ואילך. ברירת מחדל: true |
spec.configSync.sourceType |
סוג המקור שממנו Config Sync צריך לבצע סנכרון.
מקבלים git או oci. ברירת מחדל: git. |
spec.configSync.syncRepo |
כתובת ה-URL של מאגר Git או של תמונת OCI לשימוש כמקור אמין. אם אין לכם מאגר מוכן, אתם יכולים להשמיט את השדה הזה. |
spec.configSync.syncBranch |
הענף במאגר Git שממנו יתבצע הסנכרון. המערכת מתעלמת מהשדה הזה אם הערך של .spec.configSync.sourceType הוא oci. השדה הזה הוא אופציונלי, וערך ברירת המחדל הוא master. מומלץ להשתמש בשדה spec.configSync.syncRev כדי לציין שם של ענף. אם משתמשים בשני השדות, השדה spec.configSync.syncRev מקבל קדימות על פני השדה spec.configSync.syncBranch.
|
spec.configSync.policyDir |
הנתיב במאגר Git או בתמונת OCI לספריית הבסיס שמכילה את ההגדרה שרוצים לסנכרן. ברירת מחדל: ספריית הבסיס של המאגר. |
spec.configSync.syncWait |
התקופה בשניות בין סנכרונים עוקבים. ברירת מחדל: 15. |
spec.configSync.syncRev |
הגרסה (תג או גיבוב) או ההסתעפות ב-Git שממנה רוצים לסנכרן. המערכת מתעלמת מהשדה הזה אם הערך של .spec.configSync.sourceType הוא oci. השדה הזה הוא אופציונלי וערך ברירת המחדל שלו הוא HEAD. כשמשתמשים בגיבוב,
הוא חייב להיות גיבוב מלא, ולא צורה מקוצרת.
|
spec.configSync.preventDrift |
אם true, מופעלת פונקציית ה-webhook של Config Sync admission כדי למנוע סטיות על ידי דחיית שינויים סותרים שנדחפים לאשכולות פעילים. ברירת מחדל: false.
Config Sync תמיד מתקן סטיות, בלי קשר לערך של השדה הזה. |
spec.configSync.stopSyncing |
אם true, מפסיק לסנכרן הגדרות עבור אשכול יחיד.
ברירת המחדל היא false. |
spec.configSync.secretType |
סוג הסוד שהוגדר לגישה אל .spec.configSync.syncRepo.
אם בחרתם באפשרות git כסוג המקור, הערך חייב להיות ssh, cookiefile, gcenode, gcpserviceaccount, token או none.
אם בחרתם באפשרות oci כסוג המקור, הערך חייב להיות gcenode, gcpserviceaccount או none.
האימות של השדה הזה הוא תלוי אותיות רישיות. חובה. |
spec.configSync.gcpServiceAccountEmail |
Google Cloud חשבון השירות שמשמש להוספת הערות לחשבון השירות של Kubernetes של בקר RootSync או RepoSync. השדה הזה משמש רק אם הערך של spec.configSync.secretType הוא gcpserviceaccount. |
spec.configSync.metricsGcpServiceAccountEmail |
הוצא משימוש: אם מופעל איחוד זהויות של עומסי עבודה ל-GKE, לא נדרש חשבון שירות לייצוא מדדי Config Sync. Google Cloud במקום זאת, כדאי להשתמש בחשבון שירות של Kubernetes. |
spec.configSync.sourceFormat |
אם המדיניות מוגדרת לערך unstructured, מוגדר מאגר לא היררכי.
ברירת מחדל: hierarchy. |
spec.configSync.deploymentOverrides |
רשימה של הגדרות לביטול ברירת המחדל של משאבים לפריסות של Config Sync.
השדה רלוונטי רק לפריסות של Config Sync עם קונטיינרים שהם לא reconciler של root או של מרחב שמות, כמו reconciler-manager. אם אתם חייבים לבטל את ההגדרה של כלי להשוואה בין קבצים של שורש או מרחב שמות, השתמשו במקום זאת ב
שדות rootsync או reposync. זה שינוי אופציונלי. |
spec.configSync.deploymentOverrides.name |
השם של פריסת Config Sync שרוצים לבטל. אי אפשר להשאיר את השדה הזה ריק. |
spec.configSync.deploymentOverrides.namespace |
מרחב השמות של פריסת Config Sync שרוצים לבטל. אי אפשר להשאיר את השדה הזה ריק. |
spec.configSync.deploymentOverrides.containers |
רשימה של הגדרות לביטול ברירת המחדל של בקשות ומגבלות של קונטיינרים של Config Sync. זה שינוי אופציונלי. |
spec.configSync.deploymentOverrides.containers.name |
השם של מאגר Config Sync שרוצים לבטל את ההגדרה שלו. אי אפשר להשאיר את השדה הזה ריק. |
spec.configSync.deploymentOverrides.containers.cpuRequest |
בקשת ה-CPU של הקונטיינר. שימוש ב יחידות משאבי CPU ב-Kubernetes. זה שינוי אופציונלי. |
spec.configSync.deploymentOverrides.containers.cpuLimit |
המגבלה על יחידת העיבוד המרכזית (CPU) של המאגר. שימוש ב יחידות משאבי CPU ב-Kubernetes. זה שינוי אופציונלי. |
spec.configSync.deploymentOverrides.containers.memoryRequest |
בקשת הזיכרון עבור הקונטיינר. שימוש ב יחידות משאבי זיכרון ב-Kubernetes. זה שינוי אופציונלי. |
spec.configSync.deploymentOverrides.containers.memoryLimit |
מגבלת הזיכרון של המאגר. שימוש ב יחידות משאבי זיכרון ב-Kubernetes. זה שינוי אופציונלי. |
הגדרת שרת proxy למאגר Git
אם מדיניות האבטחה של הארגון מחייבת ניתוב תנועה דרך שרת proxy מסוג HTTPS, אפשר להשתמש ב-URI של ה-proxy כדי להגדיר את Config Sync לתקשורת עם מארח Git. יש תמיכה ב-Proxy רק כשמשתמשים בסוג הרשאה cookiefile, none או token.
| מפתח | תיאור |
|---|---|
spec.configSync.httpsProxy |
הגדרת משתנה סביבה HTTPS_PROXY שמשמש לגישה למאגר Git. לדוגמה:
https://proxy.internal.business.co:443.שרת ה-proxy של HTTPS מקבל רק כתובות URL מסוג https או כתובות URL ללא קישוט.
כתובות URL שמכילות http:// נדחות.אם משתמשים בכתובת URL פשוטה, צריך לוודא שהתקשורת בין שרת ה-proxy לבין מארח Git מאובטחת. |
דוגמה למפרט של gcloud apply
applySpecVersion: 1
spec:
configSync:
enabled: true
sourceFormat: unstructured
syncRepo: https://github.com/GoogleCloudPlatform/anthos-config-management-samples
syncBranch: main
secretType: none
policyDir: config-sync-quickstart/multirepo/root
דוגמה למפרט של gcloud apply עם שינויים בברירת המחדל של משאב הפריסה
אם רוצים להתאים אישית את הבקשות והמגבלות של משאבי Config Sync, מוסיפים את השדה deploymentOverrides במפרט ההחלה. לדוגמה, קובץ ה-YAML הבא מבטל את המגבלות של המעבד והזיכרון עבור מאגר reconciler-manager:
applySpecVersion: 1
spec:
configSync:
enabled: true
deploymentOverrides:
- name: reconciler-manager
namespace: config-management-system
containers:
- name: reconciler-manager
cpuRequest: 50m
cpuLimit: 100m
memoryRequest: 256Mi
memoryLimit: 512Mi