Apa itu ZCLI?

zcli adalah akronim dari Antarmuka Baris Perintah ZEVENET. Alat ini memungkinkan mengelola beberapa penyeimbang beban dari baris perintah atau otomatisasi tindakan penyeimbang beban dalam skrip operasi.

zcli adalah pembungkus dari ZAPI (ZEVENET Application Programming Interface), ia memiliki fitur pelengkapan otomatis untuk menavigasi lebih mudah melalui modul load balancer dan objek-objeknya.

Ini dapat digunakan dengan penyeimbang beban ZEVENET dengan versi EE 6.1 atau lebih tinggi.

Langkah pertama dengan zcli

Instalasi

zcli tersedia di repositori resmi ZEVENET APT dan itu bisa dipasang di load balancer ZEVENET menggunakan:

apt-get update && apt-get install zcli

Selain itu, paket ini juga berlaku untuk Debian, Ubuntu atau distro apa pun yang berbasis di deb paket untuk meluncurkan perintah dari jarak jauh ke penyeimbang beban Anda.

Profil pengguna

Profil pengguna berisi informasi tentang load balancer di mana perintah akan dieksekusi dan pengguna yang akan mengeksekusi perintah. Itu pemakai Fitur ini hanya tersedia untuk ZEVENET Enterprise dan dikelola dalam modul RBAC, perintah akan dijalankan bergantung pada izin pengguna. zcli dapat mengelola berbagai profil.

Pengaturan

Sebelum berlari zcli a Kunci ZAPI Dibutuhkan. Ini dapat diaktifkan dari GUI Web ZEVENET, pada menu Sistem> Pengguna.

Sekali zcli diinstal, itu bisa dimulai dengan mengeksekusi zcli di shell. Jika dijalankan dari penyeimbang beban, ini akan berjalan dengan profil default localhost yang mengelola penyeimbang muatan lokal dan kunci ZAPI akan diminta. Dalam kasus lain, asisten konfigurasi akan dimulai.

Jika pengaturan profil harus diubah atau profil lain harus dibuat, the zcli profil objek harus dieksekusi.

Dimungkinkan untuk mengatur profil selama zcli waktu doa menggunakan -p pilihan seperti yang ditunjukkan di bawah ini.

sh:~$ zcli -p my_profile

atau menggunakan perintah dengan zcli dalam mode interaktif:

zcli: profile apply my_profile

Contohnya ditunjukkan di bawah ini:

Bagaimana ini digunakan

zcli memiliki dua mode kerja:

1. Diluncurkan tanpa argumen, the zcli shell dieksekusi dalam mode interaktif. Mode ini menyediakan pelengkapan otomatis dan tidak selesai setelah perintah dijalankan, untuk keluar dari zcli shell, ketik berhenti atau tekan Ctrl + D.

2. zcli dipanggil dengan argumen. Ini akan menjalankan perintah, tanpa masuk ke dalam zcli shell interaktif, dan kembali ke konsol sistem.

Mari kita lihat di bawah ini perintah yang tersedia di Antarmuka Baris Perintah ZEVENET.

Perintah

Perintah memiliki 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

Temukan di bawah deskripsi setiap parameter.

Pilihan: Mereka diatur dalam zcli doa. Daftar opsi lengkap dirinci dalam bantuan.
obyek: Ini adalah jenis objek penyeimbang beban yang dipilih.
tindakan: Ini adalah kata kerja yang akan dieksekusi.
daftar id: Mereka adalah pengidentifikasi yang merujuk ke objek. ID ini terkait dengan modul.
parameter: Mereka adalah parameter yang ditetapkan di objek. Sebagian besar, mereka diharapkan ketika suatu objek dibuat / ditambahkan atau dimodifikasi.

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

Argumen perintah yang diharapkan dapat diambil dengan menekan Enter. Terkadang parameter tidak diperluas hingga argumen sebelumnya ditetapkan.

zcli memiliki fungsi pelengkapan otomatis yang dapat dipicu menekan dua kali lipat TAB .

Bantuan yang diperbarui dapat diperiksa dengan perintah di bawah ini.

sh:~$ zcli help

Data Keluaran

The zcli prompt akan berubah warna tergantung pada kode kesalahan perintah. Jadi hasilnya akan ditampilkan di hijau apakah perintah itu berhasil atau merah jika ada kesalahan selama eksekusi perintah. Juga, nama profil akan dicetak sebagai Abu-abu ketika zcli tidak dapat terhubung ke penyeimbang beban. Untuk jenis kesalahan seperti itu, sebaiknya tinjau konfigurasi profil dan kunci ZAPI penyeimbang beban.

Outputnya dicetak dalam format JSON berwarna, tetapi mereka dapat dinonaktifkan menggunakan opsi -nc (–Tidak ada warna). Beberapa pesan informasi dapat ditampilkan, pesan-pesan itu dihilangkan ketika zcli diluncurkan dalam mode eksekusi perintah (tanpa interaktif zcli).

Pesan kesalahan ditampilkan melalui STDERR output.

Contoh Perintah

Daftar contoh lengkap dapat ditanyakan di Dokumentasi ZAPI. Di sini hanya beberapa contoh berguna:

Dapatkan info sistem

sh:~$ zcli system get

Dapatkan statistik sistem

sh:~$ zcli statistic-system get

Buat daftar ikhtisar peternakan

sh:~$ zcli farm list

Buat pertanian

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

Ambil kembali konfigurasi sebuah tambak

sh:~$ zcli farm get farm1

Ubah pertanian

sh:~$ zcli farm set farm1 -listener https

Mulai kembali pertanian

sh:~$ zcli farm restart farm1

Buat layanan

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

Ubah layanan

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 backend

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

Hapus backend

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

Batalkan backend dalam mode pemeliharaan

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

Atur backend dalam mode pemeliharaan

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

Repositori Kode Sumber

The zcli proyek kode sumber tersedia di URL https://github.com/zevenet/zcli

Menikmati zcli, Antarmuka Baris Perintah ZEVENET!