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.

פקודות 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,--verbose

check‑ready

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

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

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, --verbose

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, --verbose

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

‫(Introduced in v1.6.6) שחזור של 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.
--verbose

הדפסת יומנים מפורטים ל-std err.

דוגמאות

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

מחילים את הגדרות רכיבי הדרישות המוקדמות על האשכול באמצעות 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'

מחיקת ההיברידי מהאשכול

בדוגמה הבאה נמחקים רק רכיבי זמן הריצה ההיברידיים באשכול Kubernetes. כדי למחוק את הכול, משתמשים בדגל --all.

apigeectl delete -f my_overrides.yaml