Mis on ZCLI

zcli on lühend ZEVENET käsurea liides. See tööriist võimaldab käsurealt hallata mitut koormusbalanssi või automatiseerida koormus tasakaalustaja toiminguid operatsiooniskriptides.

zcli on ümbris ZAPI (ZEVENETi rakenduse programmeerimisliides), sellel on automaatse täitmise funktsioon, et hõlpsamalt navigeerida koormusbalansi moodulites ja selle objektides.

Seda saab kasutada koos ZEVENET koorma tasakaalustajatega versiooniga 6.1 XNUMX või uuemaga.

Esimesed sammud zcli abil

paigaldamine

zcli on saadaval lehel APT ametlikud hoidlad ja selle saab paigaldada ZEVENETi koorma tasakaalustajasse, kasutades:

apt-get update && apt-get install zcli

See pakett kehtib ka kõigi Debiani, Ubuntu või mis tahes distro kohta, mis asub deb pakette, et käivitada käske kaugjuhitavalt laadimisbilanssidele.

Kasutajaprofiilid

Kasutajaprofiilid sisaldavad teavet koormuse tasakaalustaja kohta, kus käsud täidetakse, ja kasutajale, kes käsku täidab. kasutaja See funktsioon on saadaval ainult ettevõtte ZEVENET Enterprise jaoks ja seda hallatakse RBAC-moodulis. Käskude täitmine sõltub kasutaja õigustest. zcli oskab hallata erinevaid profiile.

Seade

Enne jooksmist zcli a ZAPI-võti on vajalik. Seda saab lubada menüüs ZEVENET Web GUI Süsteem> Kasutaja.

Kunagi zcli on installitud, saab selle käivitada käivitades zcli koores. Kui see käivitatakse koormuse tasakaalustajast, töötab see vaikeprofiiliga localhost , mis haldab kohalikku koormuse tasakaalustajat, küsitakse ZAPI-võtit. Muudel juhtudel käivitatakse konfiguratsiooniassistent.

Kui profiili sätteid tuleb muuta või tuleb luua mõni muu profiil, siis zcli profiil objekt tuleks täita.

Profiili on võimalik seadistada ajal zcli kutsumisaeg kasutades -p nagu allpool näidatud.

sh:~$ zcli -p my_profile

või kasutades käsku zcli interaktiivses režiimis:

zcli: profile apply my_profile

Allpool on toodud näide:

Kuidas seda kasutatakse?

zcli on kaks töörežiimi:

1. Ilma argumentideta käivitatud zcli kest täidetakse interaktiivses režiimis. See režiim pakub automaatse täitmise ja see ei lõpe pärast käskluse täitmist, et väljuda zcli kest, tüüp loobuma või vajutage Ctrl + D.

2. zcli kutsutakse argumentidega. See täidab käsu ilma, et siseneksite zcli interaktiivne kest ja naasmine tagasi süsteemi konsooli.

Vaatame allpool ZEVENETi käsurealiideses olevaid käske.

Käsud

Käsul on järgmine süntaks:

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

Näiteks:

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

Allpool leiate iga parameetri kirjelduse.

valikuid: Need on seatud zcli kutsumine. Täielik valikloend on üksikasjalikult toodud spikris.
objekt: See on selline koormus tasakaalustaja objekt, mis valitakse.
tegevus: See on verb, mis täidetakse.
ID-de nimekiri: Need on objektile viitavad identifikaatorid. Need ID-d on seotud mooduliga.
parameetrid: Need on parameetrid, mille objekt tuleb seada. Enamasti oodatakse neid objekti loomisel / lisamisel või muutmisel.

Kõiki neid parameetreid saab kasutada JSON-vormingus, kasutades -j (–Json).

Oodatud käsuargumendid saab alla vajutades sisene. Mõnikord ei laiendata parameetreid enne, kui eelmised argumendid on paika pandud.

zcli omab automaatse täitmise funktsiooni, mille saab käivitada topelt vajutades TAB nuppu.

Uuendatud abi saab kontrollida alloleva käsu abil.

sh:~$ zcli help

Väljundandmed

. zcli viip muudab värvi sõltuvalt käsu veakoodist. Nii et väljund kuvatakse roheline kui käsk õnnestus või punane kui käsu täitmisel ilmnes tõrge. Samuti prinditakse profiili nimi kujul hall millal zcli ei saanud koormuse tasakaalustajaga ühendust luua. Selliste vigade korral on kasulik vaadata üle profiili konfiguratsioon ja koormuse tasakaalustaja ZAPI võti.

Väljund prinditakse värvilises JSON-vormingus, kuid selle saab valiku abil keelata -nc (–Värvid). Mõnda infosõnumit võidakse kuvada, need sõnumid jäetakse siis ära zcli käivitatakse käsu täitmise režiimis (ilma interaktiivseta zcli).

Veateateid kuvatakse STDERR väljund.

Käskude näited

Näidete täieliku loetelu leiate küsimusest ZAPI dokumentatsioon. Siin on ainult mõned kasulikud näited:

Hankige süsteemiteavet

sh:~$ zcli system get

Hankige süsteemistatistikat

sh:~$ zcli statistic-system get

Loetlege ülevaade farmidest

sh:~$ zcli farm list

Loo talu

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

Hankige talu konfiguratsioon

sh:~$ zcli farm get farm1

Farmi muutmine

sh:~$ zcli farm set farm1 -listener https

Taaskäivitage talu

sh:~$ zcli farm restart farm1

Looge teenus

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

Teenuse muutmine

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

Lisage taustaprogramm

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

Muutke taustaprogrammi

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

Kustuta taustaprogramm

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

Tühjendage taustrežiim hooldusrežiimis

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

Seadista taustrežiim hooldusrežiimis

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

Lähtekoodi hoidla

. zcli lähtekoodi projekt on URL-is saadaval https://github.com/zevenet/zcli

Nautima zcli, käsurealiides ZEVENET!