Namestitev in konfiguracija nadzornika v Ubuntu 16.04

Supervizor je sistem odjemalec/strežnik, ki se uporablja za nadzor številnih procesov UNIX, natančneje procesov, povezanih s projektom ali stranko. Uporabite lahko na primer nadzornika za ustvarjanje in spremljanje poljubnega števila čakalnih vrst delavcev vaše spletne aplikacije.

Sestavni deli tega sistema so:

• supervisord: strežniški del sistema.
• supervisorctl: vmesnik ukazne vrstice, ki se uporablja za interakcijo s strežnikom.
• Spletni strežnik: Preprost spletni strežnik in spletni uporabniški vmesnik z osnovno funkcionalnostjo v primerjavi z supervisorctl .
• Vmesnik XML-RPC: isti strežnik HTTP, ki ga uporablja spletni odjemalec, služi vmesniku XML-RPC, ki se lahko uporablja za nadzor nadzornih programov.

V tej vadnici bomo namestili najnovejšo različico nadzornika, prikazali, kako ustvariti in upravljati programe prek supervisorctl, ter konfigurirali spletni vmesnik za upravljanje naših programov.

Namestitev in osnovna konfiguracija

Nadzornika bomo namestili prek easy_install, kar je značilnost pythonovih orodij za nastavitev.

Najprej posodobite seznam lokalnih paketov in nato namestite python setuptools.

sudo apt-get update && sudo apt-get install python-setuptools

Zdaj lahko namestimo nadzornika.

sudo easy_install supervisor

Ko je namestitev končana, moramo ustvariti konfiguracijsko datoteko. Ustvarite mapo z imenom supervisorznotraj /etc.

sudo mkdir /etc/supervisor

In nato izvedite naslednje.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Če niste prijavljeni z rootuporabnikom, se lahko Permission deniedprikaže napaka (tudi z sudo). To je posledica preusmeritve. Če želite to premagati, se prijavite kot root.

sudo su

Nato lahko znova zaženete ukaz.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Zdaj lahko rootuporabniku pustite exitukaz. echo_supervisord_confUkaz je poskrbel naš mentor namestitve.

Osnovna konfiguracija

Odprite /etc/supervisor/supervisord.confdatoteko in preverite njeno vsebino. Opazili boste, da ta konfiguracijska datoteka sledi INIsintaksi in je razdeljena po razdelkih (predstavljena z oklepaji kot v [section-name]).

Za dodajanje programov, ki jih bo upravljal nadzornik, moramo samo ustvariti ustrezne [program]razdelke. Da pa se ne bi motili z glavno konfiguracijsko datoteko vsakič, ko bomo morali dodati (ali spremeniti) program, bomo uporabljali [include]razdelek. Poiščite ta razdelek, ga odstranite iz komentarja in ga nato uredite, da bo videti takole.

[include]
files=conf.d/*.conf

Zdaj bomo za vsak program, ki ga želimo dodati, ustvarili .inidatoteko v /etc/supervisor/conf.d/imeniku. Ustvarimo to mapo.

sudo mkdir /etc/supervisor/conf.d

Zagon nadzornega strežnika

Kot smo že omenili, je nadzornik sestavljen iz strežnika in odjemalcev, ki se povezujejo z njim. Da bi lahko upravljali in nadzorovali programe, moramo zagnati strežnik. V ta namen bomo registrirali nadzorni strežnik v systemd, da se bo strežnik lahko zagnal ob zagonu sistema.

Če želite to narediti, ustvarite datoteko, imenovano supervisord.servicev /etc/systemd/systemimeniku.

sudo touch /etc/systemd/system/supervisord.service

V datoteko dodajte naslednjo vsebino.

[Unit]
Description=Supervisor daemon
Documentation=http://supervisord.org
After=network.target

[Service]
ExecStart=/usr/local/bin/supervisord -n -c /etc/supervisor/supervisord.conf
ExecStop=/usr/local/bin/supervisorctl $OPTIONS shutdown
ExecReload=/usr/local/bin/supervisorctl $OPTIONS reload
KillMode=process
Restart=on-failure
RestartSec=42s

[Install]
WantedBy=multi-user.target
Alias=supervisord.service

Aktivirajte storitev nadzornika.

sudo systemctl start supervisord.service

Dokler se servisna datoteka nahaja v /etc/systemd/systemimeniku, se bo samodejno zagnala ob zagonu sistema.

Lahko preverite stanje storitve.

systemctl status supervisord.service

Prav tako si lahko ogledate dnevnike.

sudo journalctl -u supervisord.service

Dodajanje programov

Programe, ki jih nadzoruje nadzornik, podajajo različni [program]razdelki v konfiguraciji. Za vsak program, ki ga želimo upravljati, bomo ustvarili samostojno konfiguracijsko datoteko, ki bo obveščala izvedljivo pot ukaza, morebitne okoljske spremenljivke, kako izvesti v primeru zaustavitve.

Najprej ustvarimo preprost skript, ki beleži časovni žig. Ustvarite datoteko z imenom hello_supervisor.sh(kamor koli želite, bomo sklicevali na celotno pot tega skripta).

touch hello_supervisor.sh

Zdaj vanj vstavite naslednjo vsebino

#!/bin/bash
while true
do 
    # Echo current timestamp to stdout
    echo Hello Supervisor: `date`
    # Echo 'error!' to stderr
    echo An error ocurred at `date`! >&2
    sleep 1
done

Zdaj ga naredite izvršljivega

chmod +x hello_supervisor.sh

V praksi je ta skript precej neuporaben. Lahko pa ga uporabimo za dokazovanje moči nadzornika. Ustvarite ustrezno konfiguracijsko datoteko tako, da zaženete naslednjo.

sudo touch /etc/supervisor/conf.d/hello_supervisor.conf

Zdaj v to datoteko vstavite naslednjo vsebino.

[program:hello_supervisor]
command=/home/USER/hello_supervisor.sh
autostart=true
autorestart=true
stderr_logfile=/var/log/hello_supervisor.err.log
stdout_logfile=/var/log/hello_supervisor.out.log

Opomba: obvezno zamenjajte USERz uporabniškim imenom.

To konfiguracijo bomo pregledali korak za korakom.

[program:hello_supervisor]
command=/home/USER/hello_supervisor.sh

Najprej se konfiguracija začne z definiranjem programa z imenom hello_supervisor . Prav tako sporoča celotno pot izvedljive datoteke, ki jo je treba zagnati.

autostart=true

Ta vrstica navaja, da se mora ta program samodejno zagnati, ko se zažene nadzornik.

autorestart=true

Če se program iz kakršnega koli razloga zapre, ta vrstica obvesti nadzornika, da samodejno znova zažene proces.

stderr_logfile=/var/log/hello_supervisor.err.log
stdout_logfile=/var/log/hello_supervisor.out.log

Te vrstice določajo lokacijo datoteke dnevnika za stderrin stdout.

Upravljanje programov

Zdaj, ko imamo nameščen in konfiguriran nadzornik, lahko upravljamo svoje procese.

Po dodajanju novega programa bi morali zagnati naslednja dva ukaza, da obvestimo strežnik, da ponovno prebere konfiguracijske datoteke in uporabi morebitne spremembe.

sudo supervisorctl reread
sudo supervisorctl update

Zdaj izvedite supervisorctlodjemalca.

sudo supervisorctl

Pozdravil vas bo seznam registriranih procesov. Videli boste proces, ki se imenuje hello_supervisors RUNNINGstatusom.

hello_supervisor                 RUNNING   pid 6853, uptime 0:22:30
supervisor>

Vnesite helpza seznam razpoložljivih ukazov.

supervisor> help

default commands (type help <topic>):
=====================================
add    exit      open  reload  restart   start   tail   
avail  fg        pid   remove  shutdown  status  update 
clear  maintail  quit  reread  signal    stop    version

Na kratko, smo lahko start, stopin restartprogrami, ki jih posreduje ime programa kot argument ustrezni ukaz.

supervisor> stop hello_supervisor 
hello_supervisor: stopped
supervisor> start hello_supervisor 
hello_supervisor: started
supervisor> restart hello_supervisor 
hello_supervisor: stopped
hello_supervisor: started
supervisor> 

Izhod programa si lahko ogledamo tudi z tailukazom.

supervisor> tail hello_supervisor 
Hello Supervisor: Mon Sep 25 19:27:29 UTC 2017
Hello Supervisor: Mon Sep 25 19:27:30 UTC 2017
Hello Supervisor: Mon Sep 25 19:27:31 UTC 2017

Za stderrizhod lahko uporabite tailtudi.

supervisor> tail hello_supervisor stderr
An error ocurred at Mon Sep 25 19:31:12 UTC 2017!
An error ocurred at Mon Sep 25 19:31:13 UTC 2017!
An error ocurred at Mon Sep 25 19:31:14 UTC 2017!

S klicem statusukaza si lahko ogledate stanje vseh registriranih programov.

Ko končate, lahko prenehate.

supervisor> quit

Odjemalec spletnega strežnika

Če želite omogočiti dostop do spletnega strežnika nadzornika, odprite konfiguracijsko datoteko nadzornika in poiščite [inet_http_server]razdelek.

nano /etc/supervisor/supervisord.conf

Zdaj posodobite konfiguracijo tega razdelka z naslednjim.

[inet_http_server]
port=*:9001
username=your_username
password=your_password

Zamenjajte your_usernamein your_passwordz želenimi poverilnicami shranite spremembe in znova zaženite storitev nadzornika.

sudo systemctl restart supervisord.service

Ne pozabite omogočiti TCPdostopa do vrat 9001na požarnem zidu in nato dostopa http://{server-ip}:9001iz brskalnika. Na vprašanje navedite svoje usernamein password. Zdaj lahko nadzirate svoje postopke iz spleta.

Zaključek

Namestili smo najnovejšo različico supervisorda, se naučili, kako jo konfigurirati za samodejni zagon sistema s sistemom systemd, in pregledali tudi osnovno uporabo supervisorctl. Za naprednejšo konfiguracijo in primere uporabe se lahko obrnete na uradno dokumentacijo nadzornika .