מדריך למשתמש של ZEVENET ממשק שורת הפקודה

פורסם על ידי זאבנט | 1 באפריל, 2020

מה זה ZCLI

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

zcli הוא עטיפה של ZAPI (ממשק תכנות יישומים של ZEVENET), יש לו תכונת השלמה אוטומטית כדי לנווט קל יותר בין מודולי איזון העומסים והאובייקטים שלו.

ניתן להשתמש בו עם מאזני עומס של ZEVENET עם גרסת EE 6.1 ומעלה.

צעדים ראשונים עם zcli

הַתקָנָה

zcli זמין מאגרי APT רשמיים של ZEVENET וניתן להתקין אותו במאזן עומסים של ZEVENET באמצעות:

apt-get update && apt-get install zcli

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

פרופילי משתמשים

פרופילי משתמשים מכיל את המידע ביחס לאיזון העומס בו יבוצעו הפקודות והמשתמש שיבצע את הפקודה. ה המשתמש התכונה זמינה רק עבור ZEVENET Enterprise והיא מנוהלת במודול RBAC, הפקודות יבוצעו תלויות בהרשאות המשתמש. zcli מסוגל לנהל פרופילים שונים.

התקנה

לפני ריצה zcli a מפתח ZAPI נדרש. ניתן להפעיל אותו מממשק המשתמש ZEVENET Web, בתפריט מערכת> משתמש.

תצורת מפתח ZEVENET zcli zapi

פעם zcli מותקן, ניתן להפעיל אותו על ידי ביצוע zcli בקליפה. אם הוא מבוצע מאיזון העומס, הוא יפעל עם פרופיל ברירת המחדל localhost שמנהל את מאזן העומסים המקומי ויתבקש מקש ZAPI. בכל מקרה אחר, עוזר התצורה יופעל.

יצירת פרופיל ZEVENET zcli

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

ניתן להגדיר את הפרופיל במהלך zcli זמן פתיחה באמצעות -p אפשרות כמו שהיא מוצגת למטה.

sh:~$ zcli -p my_profile

או באמצעות הפקודה עם zcli במצב אינטראקטיבי:

zcli: profile apply my_profile

דוגמה מוצגת להלן:

ZEVENET zcli מצב אינטראקטיבי עם פרופיל

איך זה משמש

zcli יש שני מצבי עבודה:

1. הושק ללא ויכוחים zcli הקליפה מבוצעת במצב אינטראקטיבי. מצב זה מספק השלמה אוטומטית והוא אינו מסתיים לאחר ביצוע פקודה, כדי לצאת מהמצב zcli קליפה, סוג להפסיק או לחץ על Ctrl + D.

2. zcli מופעלת בטיעונים. פעולה זו תבצע את הפקודה, מבלי להיכנס ל- zcli מעטפת אינטראקטיבית והחזרה לקונסולת המערכת.

בואו נראה להלן את הפקודות הזמינות בממשק שורת הפקודה ZEVENET.

פקודות

לפקודה התחביר הבא:

sh:~$  zcli [   options   ] [        object      ] [action] [   ids list   ] [    parameters    ]

לדוגמא:

sh:~$ zcli -nc -p test-lb2 farms-services-backend   set    farm1 service1 0 -ip 1.1.1.1 -port 80
           ^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^^   ^^^    ^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^
               options            object           action      ids list         parameters

מצא מתחת לתיאור של כל פרמטר.

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

ניתן להשתמש בכל הפרמטרים הללו בפורמט JSON באמצעות -j (–ג'סון).

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

תיאורי עזרה של ZEVENET zcli

zcli יש פונקציונליות של השלמה אוטומטית הניתנת להפעלה בלחיצה כפולה TAB לַחְצָן.

השלמה אוטומטית של ZEVENET zcli

ניתן לבדוק את העזרה המעודכנת באמצעות הפקודה שלהלן.

sh:~$ zcli help

נתוני פלט

אל האני zcli הפקודה תשנה את הצבע בהתאם לקוד שגיאת הפקודה. אז הפלט יוצג ב ירוק אם הפקודה הייתה מוצלחת או אָדוֹם אם הייתה שגיאה במהלך ביצוע הפקודה. כמו כן, שם הפרופיל יודפס כ- אפור מתי zcli לא הצליח להתחבר למאזנת העומסים. עבור סוג כזה של שגיאות, כדאי לבדוק את תצורת הפרופיל ואת מקש ZAPI לאיזון העומס.

הפלט מודפס בפורמט JSON צבעוני, אך ניתן לבטל אותם באמצעות האפשרות -נ.צ. (–לא צבעים). ניתן להציג הודעות מידע מסוימות, ההודעות הללו מושמטות מתי zcli מופעל במצב ביצוע פקודה (ללא אינטראקטיבי zcli).

הודעות השגיאה מוצגות דרך STDERR פלט.

דוגמאות לפקודה

רשימה מלאה של דוגמאות ניתן לשאול בתיבה תיעוד ZAPI. הנה רק כמה דוגמאות שימושיות:

קבל מידע על המערכת

sh:~$ zcli system get

קבל סטטיסטיקות מערכת

sh:~$ zcli statistic-system get

פרט סקירה של החוות

sh:~$ zcli farm list

ליצור חווה

sh:~$ zcli farm create -profile http -farmname farm1 -vip 10.0.0.241 -vport 443

אחזר את התצורה של חווה

sh:~$ zcli farm get farm1

שנה חווה

sh:~$ zcli farm set farm1 -listener https

הפעל מחדש חווה

sh:~$ zcli farm restart farm1

צור שירות

sh:~$ zcli farm-service add farm1 -id images

שנה שירות

sh:~$ zcli farm-service set farm1 images -urlp /images

הוסף backend

sh:~$ zcli farm-service-backend add farm1 images -ip 10.0.4.40 -port 443

שנה backend

sh:~$ zcli farm-service-backend set farm1 images 0 -priority 1

מחק backend

sh:~$ zcli farm-service-backend remove farm1 images 0

בטל את הגדרת ה- backend במצב התחזוקה

sh:~$ zcli farm-service-backend maintenance farm1 images 0

הגדר backend במצב תחזוקה

sh:~$ zcli farm-service-backend non_maintenance farm1 images 0

מאגר קוד מקור

אל האני zcli פרויקט קוד המקור זמין בכתובת האתר https://github.com/zevenet/zcli

להנות zcli, ממשק שורת הפקודה ZEVENET!

תשתף:

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

האם המאמר הזה היה מועיל?

מאמרים נוספים