Panduan Pengguna ZEVENET Interface Line Interface ZCLI

DIPOS oleh Zevenet | 1 April 2020

Apa itu ZCLI

zcli adalah singkatan dari Antara Muka Perintah ZEVENET. Alat ini membolehkan menguruskan beberapa pengimbang beban dari baris perintah atau automasi tindakan pengimbang beban dalam skrip operasi.

zcli adalah pembungkus dari ZAPI (Antarmuka Pengaturcaraan Aplikasi ZEVENET), ia memiliki fitur pelengkap otomatis untuk menavigasi lebih mudah melalui modul pengimbang beban dan objeknya.

Ia boleh digunakan dengan pengimbang beban ZEVENET dengan versi EE 6.1 atau lebih tinggi.

Langkah pertama dengan zcli

Pemasangan

zcli terdapat di repositori rasmi ZEVENET APT dan ia boleh dipasang dalam pengimbang beban ZEVENET menggunakan:

apt-get update && apt-get install zcli

Juga, pakej ini juga sah untuk Debian, Ubuntu atau distro yang berpusat di deb pakej untuk melancarkan perintah dari jauh ke pengimbang beban anda.

Profil Pengguna

Profil Pengguna mengandungi maklumat berkenaan dengan load balancer dimana perintah akan dijalankan dan pengguna yang akan melaksanakan perintah tersebut. The pengguna Fitur hanya tersedia untuk ZEVENET Enterprise dan dikelola dalam modul RBAC, perintah yang akan dilaksanakan bergantung pada izin pengguna. zcli mampu menguruskan profil yang berbeza.

Persediaan

Sebelum berlari zcli a Kekunci ZAPI adalah diperlukan. Ia boleh diaktifkan dari ZEVENET Web GUI, dalam menu Sistem> Pengguna.

Konfigurasi kunci ZEVENET zcli zapi

Apabila zcli dipasang, ia boleh dimulakan dengan menjalankan zcli di cengkerang. Sekiranya dijalankan dari load balancer, ia akan berjalan dengan profil lalai localhost yang menguruskan pengimbang beban tempatan dan kunci ZAPI akan diminta. Dalam kes lain, pembantu konfigurasi akan dimulakan.

Pembuatan profil ZEVENET zcli

Sekiranya tetapan profil mesti diubah atau profil lain harus dibuat, zcli profil objek harus dilaksanakan.

Adalah mungkin untuk menetapkan profil semasa zcli masa memohon menggunakan -p pilihan seperti yang ditunjukkan di bawah.

sh:~$ zcli -p my_profile

atau menggunakan perintah dengan zcli dalam mod interaktif:

zcli: profile apply my_profile

Contoh ditunjukkan di bawah:

Mod interaktif ZEVENET zcli dengan profil

Bagaimana ia digunakan

zcli mempunyai dua mod kerja:

1. Dilancarkan tanpa hujah, the zcli shell dijalankan dalam mod interaktif. Mod ini menyediakan pelengkap automatik dan tidak selesai setelah perintah dijalankan, untuk keluar dari zcli tempurung, taip berhenti atau tekan Ctrl + D.

2. zcli dipanggil dengan hujah. Ini akan melaksanakan perintah, tanpa memasuki zcli shell interaktif, dan pengembalian kembali ke konsol sistem.

Mari lihat di bawah arahan yang terdapat di antara muka baris arahan ZEVENET.

arahan

Perintah mempunyai sintaks berikut:

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

Sebagai contoh:

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

Cari di bawah keterangan setiap parameter.

pilihan: Mereka ditetapkan di zcli permohonan. Senarai pilihan lengkap diperincikan dalam bantuan.
objek: Ini adalah jenis objek pengimbang beban yang dipilih.
tindakan: Ini adalah kata kerja yang akan dilaksanakan.
senarai id: Mereka adalah pengenal yang merujuk pada objek. ID ini berkaitan dengan modul.
parameter: Mereka adalah parameter yang harus ditetapkan dalam objek. Sebilangan besarnya, objek tersebut diharapkan ketika suatu objek dibuat / ditambahkan atau diubah.

Semua parameter ini dapat digunakan dalam format JSON menggunakan -j (–Json) pilihan.

Argumen perintah yang diharapkan dapat diambil dengan menekan Masukkan. Kadang-kadang parameter tidak diperluas sehingga argumen sebelumnya ditetapkan.

Penerangan bantuan ZEVENET zcli

zcli mempunyai fungsi penyelesaian automatik yang boleh dicetuskan menekan dua kali TAB .

Pelengkap automatik ZEVENET zcli

Bantuan yang dikemas kini boleh diperiksa dengan arahan di bawah.

sh:~$ zcli help

Data Keluaran

. zcli prompt akan menukar warna bergantung pada kod kesalahan arahan. Jadi output akan ditunjukkan dalam hijau sekiranya arahan itu berjaya atau merah sekiranya terdapat kesalahan semasa pelaksanaan perintah. Juga, nama profil akan dicetak sebagai kelabu apabila zcli tidak dapat menyambung ke pengimbang beban. Untuk kesalahan seperti ini, adalah berguna untuk mengkaji konfigurasi profil dan kunci ZAPI pengimbang beban.

Keluaran dicetak dalam format JSON berwarna, tetapi dapat dilumpuhkan menggunakan pilihan -nc (-Tidak berwarna). Beberapa pesan maklumat dapat ditunjukkan, pesan tersebut dihilangkan ketika zcli dilancarkan dalam mod pelaksanaan perintah (tanpa interaktif zcli).

Mesej ralat dipaparkan melalui STDERR output.

Contoh Perintah

Senarai contoh yang lengkap boleh ditanyakan di Dokumentasi ZAPI. Berikut adalah beberapa contoh berguna:

Dapatkan maklumat sistem

sh:~$ zcli system get

Dapatkan statistik sistem

sh:~$ zcli statistic-system get

Senaraikan gambaran keseluruhan ladang

sh:~$ zcli farm list

Buat ladang

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

Dapatkan semula konfigurasi ladang

sh:~$ zcli farm get farm1

Ubah suai ladang

sh:~$ zcli farm set farm1 -listener https

Mulakan semula ladang

sh:~$ zcli farm restart farm1

Buat perkhidmatan

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

Ubah suai perkhidmatan

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

Tambahkan backend

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

Ubah suai latar belakang

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

Padamkan sandaran belakang

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

Tetapkan backend dalam mod penyelenggaraan

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

Tetapkan backend dalam mod penyelenggaraan

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

Repositori Kod Sumber

. zcli projek kod sumber boleh didapati di URL https://github.com/zevenet/zcli

Nikmati zcli, Antara Muka Perintah ZEVENET!

Berkongsi pada:

Dokumentasi di bawah syarat-syarat Lesen Dokumentasi Bebas GNU.

Adakah artikel ini berguna?

Artikel yang berkaitan