ما هو 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!