المحتويات
ما هو ZCLI
zcli هو اختصار ل واجهة سطر الأوامر ZEVENET. تسمح هذه الأداة بإدارة العديد من موازنات التحميل من سطر الأوامر أو أتمتة إجراءات موازن التحميل في البرامج النصية للعملية.
zcli هو المجمع ZAPI (واجهة برمجة تطبيقات ZEVENET) ، لديها ميزة الإكمال التلقائي للتنقل بسهولة من خلال وحدات موازن التحميل وكائناتها.
يمكن استخدامه مع موازنات تحميل ZEVENET مع الإصدار EE 6.1 أو أعلى.
الخطوات الأولى مع zcli
تجهيز و تركيب
zcli متاح في مستودعات ZEVENET APT الرسمية ويمكن تثبيته في موازن تحميل ZEVENET باستخدام:
apt-get update && apt-get install zcli
هذه الحزمة صالحة أيضًا لأي Debian أو Ubuntu أو أي توزيعة مقرها ديب حزم من أجل إطلاق الأوامر عن بعد لموازنات التحميل الخاصة بك.
ملفات تعريف المستخدم
ملفات تعريف المستخدم تحتوي على المعلومات المتعلقة بموازن التحميل حيث سيتم تنفيذ الأوامر والمستخدم الذي سينفذ الأمر. ال المستخدم الميزة متاحة فقط لـ ZEVENET Enterprise وتتم إدارتها في وحدة RBAC ، وسيتم تنفيذ الأوامر بناءً على أذونات المستخدم. zcli قادر على إدارة ملفات تعريف مختلفة.
اقامة
قبل الجري zcli a مفتاح ZAPI مطلوب. يمكن تمكينه من ZEVENET Web GUI ، في القائمة النظام> المستخدم.
مرة zcli مثبت ، يمكن أن يبدأ عن طريق التنفيذ zcli في القشرة. إذا تم تنفيذه من موازن التحميل ، فسيتم تشغيله باستخدام ملف التعريف الافتراضي مؤسسة الكوثر الذي يدير موازن التحميل المحلي وسيتم طلب مفتاح ZAPI. في أي حالة أخرى ، سيتم بدء تشغيل مساعد التكوين.
إذا كان لا بد من تعديل إعدادات ملف التعريف أو إنشاء ملف تعريف آخر ، فإن zcli البيانات الشخصية يجب تنفيذ الكائن.
من الممكن تعيين ملف التعريف أثناء zcli وقت الاحتجاج باستخدام -p الخيار كما هو موضح أدناه.
sh:~$ zcli -p my_profile
أو استخدام الأمر مع zcli في الوضع التفاعلي:
zcli: profile apply my_profile
ويرد أدناه مثال على ذلك:
كيف يتم استخدامها
zcli وضعين للعمل:
1. أطلقت بدون حجج zcli يتم تنفيذ shell في الوضع التفاعلي. يوفر هذا الوضع الإكمال التلقائي ولا ينتهي بمجرد تنفيذ الأمر للخروج من 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 (–جسون) اختيار.
يمكن استرجاع وسيطات الأمر المتوقعة بالضغط أدخل. في بعض الأحيان لا يتم توسيع المعلمات حتى يتم تعيين الوسائط السابقة.
zcli لديه وظيفة الإكمال التلقائي التي يمكن تشغيلها بالضغط على مضاعفة TAB .
يمكن التحقق من المساعدة المحدثة باستخدام الأمر أدناه.
sh:~$ zcli help
بيانات الناتج
• zcli ستغير المطالبة اللون اعتمادًا على رمز خطأ الأمر. لذلك سيتم عرض الإخراج في لون أخضر إذا كان الأمر ناجحًا أو أحمر إذا كان هناك خطأ أثناء تنفيذ الأمر. أيضا ، سيتم طباعة اسم ملف التعريف باسم رمادي متى zcli تعذر الاتصال بموازن التحميل. بالنسبة لمثل هذا النوع من الأخطاء ، من المفيد مراجعة تكوين ملف التعريف ومفتاح موازن التحميل ZAPI.
تتم طباعة الإخراج بتنسيق JSON الملون ، ولكن يمكن تعطيله باستخدام الخيار -NC (- لا ألوان). يمكن عرض بعض رسائل المعلومات ، يتم حذف هذه الرسائل عند zcli يتم تشغيله في وضع تنفيذ الأوامر (بدون تفاعلي zcli).
يتم عرض رسائل الخطأ من خلال ستدير الناتج.
أمثلة على الأوامر
يمكن الاستعلام عن قائمة كاملة من الأمثلة في وثائق 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
أضف خلفية
sh:~$ zcli farm-service-backend add farm1 images -ip 10.0.4.40 -port 443
تعديل الواجهة الخلفية
sh:~$ zcli farm-service-backend set farm1 images 0 -priority 1
حذف الخلفية
sh:~$ zcli farm-service-backend remove farm1 images 0
قم بإلغاء تعيين خلفية في وضع الصيانة
sh:~$ zcli farm-service-backend maintenance farm1 images 0
قم بتعيين خلفية في وضع الصيانة
sh:~$ zcli farm-service-backend non_maintenance farm1 images 0
مستودع شفرة المصدر
• zcli مشروع رمز المصدر متاح في URL https://github.com/zevenet/zcli
استمتع zcli، واجهة سطر الأوامر ZEVENET!