Hvad er noid-cli #
noid-cli er forkortelsen af RELIANOID Command Line Interface. Dette værktøj gør det muligt at administrere flere belastningsbalancere fra en kommandolinje eller automatisering af belastningsbalanceringshandlinger i operationsscripts.
noid-cli er en indpakning af API (RELIANOID Application Programming Interface), har den en autofuldførelsesfunktion til at navigere lettere gennem load balancer-modulerne og dets objekter.
Det kan bruges med RELIANOID belastningsbalancere med version EE 8.1 eller højere.
Første skridt med noid-cli #
Installation #
noid-cli er tilgængelig i den officielle RELIANOID APT repositories og det kan installeres i en RELIANOID belastningsbalancer ved hjælp af:
apt-get update && apt-get install noid-cli
Denne pakke er også gyldig for enhver Debian, Ubuntu eller enhver distro baseret i deb pakker for at starte kommandoer eksternt til dine belastningsbalancere.
Brugerprofiler #
Brugerprofiler indeholde oplysningerne i forhold til den load balancer, hvor kommandoerne vil blive udført, og den bruger, der skal udføre kommandoen. Det bruger funktion er kun tilgængelig for RELIANOID Enterprise og det administreres i RBAC-modulet, vil kommandoerne blive udført afhængigt af brugerens tilladelser. noid-cli er i stand til at administrere forskellige profiler.
Opsætning #
Før du løber noid-cli a API-nøgle er påkrævet. Det kan aktiveres fra RELIANOID Web GUI, i menuen System > Bruger.
Når noid-cli er installeret, kan den startes ved at udføre noid-cli i skallen. Hvis det udføres fra belastningsbalanceren, vil det køre med standardprofilen localhost som styrer den lokale load balancer og ZAPI-nøglen vil blive anmodet. I alle andre tilfælde vil konfigurationsassistenten blive startet.
Hvis profilindstillingerne skal ændres, eller der skal oprettes en anden profil, noid-cli profil objektet skal udføres.
Det er muligt at indstille profilen under noid-cli invokationstid ved hjælp af -p mulighed, som den er vist nedenfor.
root@noid-ee-01:~$ noid-cli -p min_profil
eller bruge kommandoen med noid-cli i en interaktiv tilstand:
noid-cli: profil anvende min_profil
Hvordan det bruges #
noid-cli har to arbejdstilstande:
1. Lanceret uden argumenter, den noid-cli shell udføres i interaktiv tilstand. Denne tilstand giver autofuldførelse, og den afsluttes ikke, når først en kommando er udført, for at afslutte noid-cli skal, type afslut eller tryk på Ctrl + D.
2. noid-cli påberåbes med argumenter. Dette vil udføre kommandoen uden at gå ind i noid-cli interaktiv shell, og vende tilbage til systemkonsollen.
Lad os se nedenfor, hvilke kommandoer der er tilgængelige i RELIANOID Kommandolinjegrænseflade.
Kommandoer #
En kommando har følgende syntaks:
root@noid-ee-01:~$ noid-cli [ muligheder ] [objekt] [handling] [id-liste] [parametre]
Som et eksempel:
root@noid-ee-01:~$ noid-cli -nc -p test-lb2 farms-services-backend sæt farm1 service1 0 -ip 1.1.1.1 -port 80 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^^^^ muligheder objekt handling ids liste parametre
Find beskrivelsen af hver parameter nedenfor.
optioner: De er sat i noid-cli påkaldelse. Den komplette liste over valgmuligheder er beskrevet i hjælpen.
objekt: Det er den slags load balancer-objekt, der er valgt.
Action: Det er verbet, der vil blive udført.
ids liste: De er de identifikatorer, der refererer til objektet. Disse ID'er er relateret til modulet.
parametre: De er de parametre, der skal indstilles i objektet. For det meste forventes de, når et objekt oprettes/tilføjes eller ændres.
Alle disse parametre kan bruges i JSON-format ved hjælp af -j (-json) mulighed.
De forventede kommandoargumenter kan hentes ved at trykke Indtast. Nogle gange udvides parametre ikke, før de foregående argumenter er indstillet.
noid-cli har en autofuldførelsesfunktion, der kan udløses ved at trykke dobbelt TAB .
Den opdaterede hjælp kan kontrolleres med kommandoen nedenfor.
root@noid-ee-01:~$ noid-cli hjælp
Outputdata #
noid-cli prompt vil ændre farven afhængigt af kommandofejlkoden. Så output vil blive vist i grøn hvis kommandoen var vellykket eller rød hvis der var en fejl under kommandoudførelsen. Profilnavnet vil også blive udskrevet som grå hvornår noid-cli kunne ikke oprette forbindelse til belastningsbalanceren. For sådanne fejl er det nyttigt at gennemgå profilkonfigurationen og ZAPI-nøglen til load balancer.
Outputtet udskrives i et farvet JSON-format, men de kan deaktiveres ved hjælp af indstillingen -nc (– ingen farver). Nogle informationsmeddelelser kan blive vist, disse meddelelser udelades når noid-cli startes i kommandoudførelsestilstand (uden interaktiv noid-cli).
Fejlmeddelelserne vises gennem STDERR udgang.
Eksempler på kommandoer #
En komplet liste over eksempler kan forespørges i ZAPI dokumentation. Her kun nogle nyttige eksempler:
Få systeminfo
root@noid-ee-01:~$ noid-cli system get
Få systemstatistik
root@noid-ee-01:~$ noid-cli statistic-system get
Angiv en oversigt over gårdene
root@noid-ee-01:~$ noid-cli farm liste
Opret en gård
root@noid-ee-01:~$ noid-cli farm opret -profil http -farmname farm1 -vip 10.0.0.241 -vport 443
Hent konfigurationen af en gård
root@noid-ee-01:~$ noid-cli farm få farm1
Ændre en gård
root@noid-ee-01:~$ noid-cli farm sæt farm1 -lytter https
Genstart en gård
root@noid-ee-01:~$ noid-cli farm genstart farm1
Opret en tjeneste
root@noid-ee-01:~$ noid-cli farm-service tilføje farm1 -id billeder
Ændre en tjeneste
root@noid-ee-01:~$ noid-cli farm-service sæt farm1 billeder -urlp /images
Tilføj en backend
root@noid-ee-01:~$ noid-cli farm-service-backend tilføj farm1-billeder -ip 10.0.4.40 -port 443
Rediger en backend
root@noid-ee-01:~$ noid-cli farm-service-backend sæt farm1 billeder 0 -prioritet 1
Slet en backend
root@noid-ee-01:~$ noid-cli farm-service-backend fjern farm1 billeder 0
Frakoble en backend i vedligeholdelsestilstand
root@noid-ee-01:~$ noid-cli farm-service-backend vedligeholdelse farm1 billeder 0
Indstil en backend i vedligeholdelsestilstand
root@noid-ee-01:~$ noid-cli farm-service-backend non_maintenance farm1 billeder 0
god fornøjelse noid-cli, RELIANOID Kommandolinjegrænseflade!
