apigeectl הוא ממשק שורת פקודה (CLI) להתקנה ולניהול של Apigee Hybrid באשכול Kubernetes.
למידע על הורדה והתקנה של apigeectl, אפשר לעיין במאמר הורדה והתקנה של apigeectl.
התחביר של apigeectl
apigeectl [command] [flags]
כאשר:
command: מציינים את הפעולה שרוצים לבצע. רשימה מלאה של הפקודות מופיעה במאמר פקודות apigeectl.
flags: מציין פרמטרים של פקודה. רשימה מלאה של דגלים זמינה במאמר בנושא דגלי apigeectl.
פקודות apigeectl
בטבלה הבאה מפורטות הפקודות של apigeectl:
| פקודה | תיאור |
|---|---|
apply |
הפקודה מחילה הגדרות של רכיבי זמן ריצה של Apigee hybrid על אשכול Kubernetes. כדי לציין רכיב אחד או יותר (מופרדים באמצעות פסיקים), משתמשים בדגל אם לא מציינים את הדגל |
check‑ready |
בודקת את הסטטוס של ה-pods של רכיב ההיברידי. כשכל ה-pods של הרכיבים מוכנים, מוצגת ההודעה All containers ready (כל הקונטיינרים מוכנים). לתסריטים אוטומטיים, שימו לב שהפקודה יוצאת עם סטטוס 0 כשכל הקונטיינרים מוכנים. אם יש לפחות pod אחד שלא מוכן, הפקודה יוצאת עם סטטוס 1. אם לא מציינים את הדגל |
delete |
מחיקת רכיבים היברידיים מהאשכול. כדי להסיר את כל הרכיבים, משתמשים בדגל אם לא מציינים את הדגל |
help |
עזרה אונליין בנושא הדפסת תמונות. |
init |
הפקודה מחילה הגדרות לרכיבים נדרשים, כמו Istio ו-Apigee Deployment, על האשכול. אפשר להשתמש בדגל |
version |
מדפיס את פרטי הגרסה של ה-CLI. |
דגלים של apigeectl
בטבלה הבאה מפורטים הדגלים apigeectl:
| דגל | תיאור |
|---|---|
-c, --components |
מציין רכיב יחיד שהפקודה חלה עליו.
אם לא מציינים את הדגל הזה, הפקודה חלה על כל הרכיבים (כל הפריסה) באשכול. הערכים האפשריים כוללים:
לדוגמה,
לחלופין, כדי לציין כמה רכיבים, מוסיפים ערכים מופרדים בפסיקים: |
--dry-run |
מריץ את הפקודה שצוינה בלי לשנות את האשכול. אפשר להשתמש באפשרות הזו עם ‑‑print-yaml כדי להוציא את מפרט האובייקט שעבר עיבוד לקובץ.
|
‑f, ‑‑file‑override‑config |
מציין קובץ YAML שמכיל מאפייני תצורה בהתאמה אישית לפריסה היברידית. ערך ברירת המחדל הוא ./overrides.yaml. נדרש קובץ של שינויים חריגים לפקודות apply, check-ready, delete ו-init.
חובה לציין את הנתיב המלא באמצעות הדגל הזה. מידע נוסף זמין במאמר בנושא ניהול רכיבים של מישור זמן הריצה. |
-h, --help |
הצגת עזרה לגבי הפקודה. |
--print-yaml |
מדפיס את הפלט של תבנית ההגדרות ל-stdout. דוגמה לשימוש בדגל הזה מופיעה במאמר הדפסת ההגדרות לקובץ. |
-s, --settings |
מציינת הגדרה שהפקודה חלה עליה. בשלב הזה, הדגל הזה
נתמך רק בהגדרה לדוגמה, אם מבצעים שינוי בהגדרות של apigeectl apply -f my-overrides.yaml --settings virtualhosts -c runtime |
דוגמאות
אתחול הגדרות האשכול
מחילים את הגדרות רכיבי הדרישות המוקדמות על האשכול באמצעות init.
צריך להריץ את הפקודה init לפני apply.
apigeectl init -f my_overrides.yaml
החלת הגדרת האשכול
כדי להחיל הגדרות היברידיות על אשכול Kubernetes, משתמשים בפקודה apply. בפעם הראשונה שמריצים את apply, כל רכיבי זמן הריצה ההיברידיים נוצרים באשכול. אם מבצעים שינויים בהגדרות, מריצים מחדש את הפקודה apply כדי להחיל רק את השינויים, או משתמשים בפקודה -c כדי להחיל רק רכיב ספציפי.
בדוגמה הבאה מוסבר איך להחיל את ההגדרה על רכיבי מישור זמן הריצה ההיברידי באשכול:
apigeectl apply -f my_overrides.yaml
החלת ההגדרה לרכיב יחיד
כדי להגביל את הפקודה apply לרכיב מסוים, משתמשים בדגל -c, כמו שמתואר במאמר דגלים של apigeectl.
בדוגמה הבאה, ההגדרה חלה רק על רכיב ה-Synchronizer:
apigeectl apply -c synchronizer -f my_overrides.yaml
בדוגמה הבאה, ההגדרה חלה רק על רכיבי Cassandra ו-runtime:
apigeectl apply -c cassandra,runtime -f my_overrides.yaml
הדפסת התצורה לקובץ
אם אתם מנסים לנפות באגים בבעיה בהתקנה, כדאי להדפיס את כל הגדרות האשכול לקובץ כדי שתוכלו לבדוק את הגדרות התצורה. הדגל --print-yaml מדפיס את ההגדרה ההיברידית ל-stdout, והדגל --dry-run מאפשר להריץ את הפקודה בלי לבצע שינויים באשכול.
apigeectl apply -f my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml
בדיקת הסטטוס של ה-Pod
בדוגמה הבאה נבדק הסטטוס של פודים שנפרסו באשכול:
apigeectl check-ready All containers ready in namespace 'my-namespace'
מחיקת ההיברידי מהאשכול
בדוגמה הבאה נמחקים רק רכיבי זמן הריצה ההיברידיים באשכול Kubernetes. כדי למחוק את הכול, משתמשים בדגל --all.
apigeectl delete -f my_overrides.yaml