apigeectl

‫apigeectl הוא ממשק שורת פקודה (CLI) להתקנה ולניהול של Apigee Hybrid באשכול Kubernetes. מידע על הורדה והתקנה של apigeectl זמין במאמר הורדה והתקנה של apigeectl.

היקפים להחלת apigeectl

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

היקףרכיביםapigeectl דגל
אחסון Cassandra --datastore
אחסון בזיכרון Redis --redis
סביבה Runtime
Synchronizer
UDCA		 --all-envs
--env
ארגון Apigee Connect Agent
MART
Watcher		 --org
דיווח Logger
Metrics		 --telemetry

תחביר apigeectl

apigeectl [command] [flags]

כאשר:

  • ‫command: מציינים את הפעולה שרוצים לבצע. רשימה מלאה של הפקודות מופיעה במאמר פקודות apigeectl.

  • ‫flags: מציין את הפרמטרים של הפקודה. רשימה מלאה של הדגלים מופיעה במאמר apigeectl flags.

פקודות apigeectl

בטבלה הבאה מפורטות הפקודות של apigeectl:

פקודה תיאור
apply

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

‫apigeectl apply בלי דגלים יחולו שינויים על כל הרכיבים באשכול.

‫apigeectl flags: --all-envs, --datastore, --dry-run, --env, -f, --file-override-config, --help, --org, --print-yaml, --redis, --settings virtualhosts, --telemetry, --v

check-ready

בודקים את הסטטוס של הפודים של רכיב ההיברידי. כשכל ה-pods של הרכיבים מוכנים, מוצגת ההודעה 'All containers ready'. בסקריפטים אוטומטיים, הפקודה יוצאת עם סטטוס 0 כשכל הקונטיינרים מוכנים. אם יש לפחות פוד אחד שלא מוכן, הפקודה יוצאת עם סטטוס 1.

‫apigeectl flags: -f, --file-override-config, --help, --v

delete

מחיקת רכיבים היברידיים מהאשכול. כדי להסיר את כל הרכיבים, משתמשים בדגל --all. אם לא מציינים את --all, רק הרכיבים הספציפיים ל-Apigee מוסרים (הרכיבים שהותקנו עם apigeectl init לא נמחקים). רכיבים ספציפיים ל-Apigee הם רכיבים שמותקנים באמצעות הפקודה apply.

‫apigeectl delete בלי דגלים אופציונליים מחיל את הפקודה delete על כל הרכיבים שנפרסו באשכול.

apigeectl diagnostic delete -f OVERRIDES_FILE מוחק את מרחב השמות apigee-diagnostic שנוצר על ידי apigeectl diagnostic. הדגל -f / --file-override-config נדרש עם apigeectl diagnostic delete

דגלים של apigeectl: --all, --all-envs, --datastore, --env, -f, --file-override-config, --help, --org, --redis, --telemetry, --v

מידע נוסף זמין במאמר הסרת זמן ריצה היברידי.
diagnostic

מפעיל את כלי איסוף האבחון, שתופס נתוני אבחון ברכיבי Kubernetes של מופע Apigee Hybrid לפי דרישה, ומאחסן אותם בקטגוריות של Google Cloud Storage.

כדי להשתמש בכלי לאיסוף נתונים לצורך אבחון, צריך קטגוריה בשם ב-Google Cloud Storage, חשבון שירות עם התפקיד Storage Admin וקטע diagnostic: שנוסף לקובץ overrides. כך עושים זאת:

כשמפעילים את כלי איסוף האבחון, הוא יוצר מרחב שמות של Kubernetes‏ apigee-diagnostic. צריך למחוק את הקובץ הזה באמצעות apigeectl diagnostic delete לפני שמפעילים שוב את הכלי לאיסוף נתונים לצורך אבחון.

מפעילים את כלי איסוף האבחון: 

apigeectl diagnostic -f OVERRIDES_FILE

מחיקת כלי לאיסוף נתוני אבחון: 

apigeectl diagnostic delete -f OVERRIDES_FILE

דגלים של apigeectl: --file-override-config

encode

מחזירה רשימה של שמות מוצפנים של כל ה-ApigeeDeployments עבור הארגון שצוין או הסביבה שצוינה בארגון שצוין. השמות המקודדים כוללים את שם הרכיב עם שם מגובב של הארגון, ואם משתמשים בדגל --env, שם מגובב של הסביבה. ‫Apigee hybrid יוצר שמות מגובבים של ארגונים וסביבות כדי למנוע התנגשויות במרחב השמות.

חובה להשתמש ב---org org-name או גם ב---org org-name וגם בדגלים --env env-name עם encode. לדוגמה:

./apigeectl encode --org hybrid-example
List of ApigeeDeployments are:
  apigee-connect-agent-hybrid-example-6a82f8a
  apigee-mart-hybrid-example-6a82f8a
  apigee-watcher-hybrid-example-6a82f8a
 
./apigeectl encode --org hybrid-example --env example-env
List of ApigeeDeployments are:
  apigee-runtime-hybrid-example-example-env-9e87e2d
  apigee-synchronizer-hybrid-example-example-env-9e87e2d
  apigee-udca-hybrid-example-example-env-9e87e2d

הדגלים של apigeectl: --env, --org

help עזרה אונליין בנושא הדפסת תמונות.
init

הכלי מתקין את Apigee Operators ואת CRDs במרחב השמות apigee-system.

מריצים את apigeectl init אחרי התקנה חדשה או שדרוג, לפני שמריצים את apigeectl apply.

‫apigeectl flags: -f, --file-override-config, --help, --v

version הפקודה מדפיסה את פרטי הגרסה של ה-CLI.

הסימון apigeectl: --help

דגלים של apigeectl

בטבלה הבאה מפורטים הדגלים של apigeectl:

דגל תיאור
--all ‫delete בלבד: מחיקת כל ההתקנה של Apigee hybrid, למעט ASM ‏ (Istio) ו-cert-manager מהאשכול.
--all-envs

הפקודה apigeectl מופעלת על כל הסביבות בארגון שצוין בקובץ התצורה של ההגדרות שמוגדרות מחדש.
--datastore

ההגדרה חלה על היקף מאגר הנתונים (Cassandra).
--dry-run מפעילה את הפקודה שצוינה בלי לשנות את האשכול. אפשר להשתמש באפשרות --print-yaml כדי להוציא את מפרט האובייקט שעבר רינדור לקובץ.

צריך להשתמש ב---dry-run עם אחד משני הערכים הבאים, בהתאם לגרסה של kubectl שמופעלת. משתמשים בפקודה gcloud version כדי לבדוק את הגרסה של kubectl:

  • ‫kubectl גרסה 1.17.x או גרסה ישנה יותר: --dry-run=true
  • ‫kubectl גרסה 1.18.x ואילך: --dry-run=client
--env env-name

ההגדרה חלה על הסביבה שצוינה. הדגל הזה יחיל את ההגדרה על רכיבים בהיקף הסביבה: apigee-runtime, ‏ apigee-synchronizer ו-apigee-udca.

צריך להשתמש ב---env עם הדגל --org. לדוגמה: 

apigeectl apply --org hybrid-example --env example-env \
      -f overrides/overrides.yaml
-f
‑‑file-override-config		 מציין קובץ YAML שמכיל מאפייני הגדרה בהתאמה אישית לפריסה היברידית. ערך ברירת המחדל הוא ./overrides.yaml. נדרש קובץ שינויים לפקודות apply,‏ check-ready,‏ delete ו-init.

חובה לציין את הנתיב המלא באמצעות הדגל הזה. מידע נוסף זמין במאמר בנושא ניהול רכיבים של מישור זמן הריצה.
-h
--help		 הצגת עזרה לגבי הפקודה.
--org

התצורה מוחלת על הארגון שצוין. הדגל הזה יחיל את ההגדרה על הרכיבים apigee-connect-agent, ‏ apigee-mart ו-apigee-watcher בהיקף הארגון.
--print-yaml מדפיס את הפלט של תבנית ההגדרות ל-stdout. דוגמה לשימוש בדגל הזה מופיעה במאמר הדפסת ההגדרה לקובץ.
--redis

ההגדרה חלה על היקף אחסון הנתונים בזיכרון (Redis).
--restore

הפעולה משחזרת את Cassandra לתמונת מצב שנשמרה בעבר, שצוינה במאפיין snapshotTimestamp בתצורת restore של הקובץ overrides.yaml. הגיבוי משוחזר מקטגוריה של Cloud Storage או משרת מרוחק, בהתאם להגדרות של backup בקובץ overrides.yaml. מידע נוסף זמין במאמר בנושא שחזור אזור מגיבוי.
-s
--settings virtualhosts

מציינת הגדרה שהפקודה חלה עליה. בשלב הזה, הדגל הזה נתמך רק בהגדרה virtualhosts, שהיא חלק מהרכיב runtime. משתמשים בדגל הזה אם מבצעים שינויים במאפיין virtualhosts בלבד.

לדוגמה, אם מבצעים שינוי בהגדרות של virtualhosts בקובץ הביטולים, אפשר להחיל אותו על האשכול באמצעות הפקודה הבאה:

apigeectl apply -f my-overrides.yaml --settings virtualhosts \
    --org example-org --env example-env
--telemetry

ההגדרה חלה על רכיבי טלמטריה כמו apigee-logger ו-apigee-metrics.
--v int

הדפסת יומנים מפורטים (verbose) ל-std err. ‫int הוא מספר שלם שמגדיר את רמת הפירוט. השדה int נדרש עם --v. האפשרות הזו פועלת בדיוק כמו האפשרות kubectl --v.

הערה: האפשרות הזו מחליפה את האפשרות --verbose שלא נמצאת יותר בשימוש.

דוגמאות

אתחול הגדרות האשכול

מחילים את הגדרות רכיבי הדרישות המוקדמות על האשכול באמצעות init. צריך להריץ את הפקודה init לפני apply. 

apigeectl init -f my_overrides.yaml

החלת הגדרת האשכול

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

בדוגמה הבאה מוסבר איך להחיל את ההגדרה של רכיבי מישור זמן ריצה היברידי על האשכול:

apigeectl apply -f my_overrides.yaml

החלת ההגדרה לרכיב יחיד

כדי להגביל את הפקודה apply לרכיב מסוים, משתמשים בדגלים שמתוארים במאמר דגלים של apigeectl.

בדוגמה הבאה, ההגדרה חלה רק על רכיב Cassandra:

apigeectl apply --datastore -f my_overrides.yaml

הדפסת ההגדרה לקובץ

אם אתם מנסים לנפות באגים בבעיה בהתקנה, כדאי להדפיס את כל הגדרות האשכול לקובץ כדי שתוכלו לבדוק את הגדרות התצורה. הדגל --print-yaml מדפיס את ההגדרה ההיברידית ל-stdout, והדגל --dry-run מאפשר להריץ את הפקודה בלי לבצע שינויים באשכול.

apigeectl apply -f my_overrides.yaml --dry-run=client --print-yaml > apigee-hybrid.yaml

בדיקת הסטטוס של ה-Pod

בדוגמה הבאה נבדק הסטטוס של פודים שנפרסו באשכול:

apigeectl check-ready -f overrides/overrides.yaml
All containers ready in namespace 'my-namespace'

מחיקת ה-hybrid מהאשכול

פרטים נוספים זמינים במאמר בנושא הסרת זמן ריצה היברידי.