Supervisor diegimas ir konfigūravimas Ubuntu 16.04

Supervisor yra kliento / serverio sistema, naudojama daugeliui UNIX procesų, konkrečiau, procesams, susijusiems su projektu ar klientu, valdyti. Pavyzdžiui, galite naudoti prižiūrėtoją, kad sukurtumėte ir stebėtumėte savavališką savo žiniatinklio programos darbuotojų eilių skaičių.

Šios sistemos komponentai yra šie:

• supervisor: sistemos serverio dalis.
• supervisorctl: komandų eilutės sąsaja, naudojama sąveikai su serveriu.
• Žiniatinklio serveris: paprastas žiniatinklio serveris ir žiniatinklio vartotojo sąsaja su pagrindinėmis funkcijomis, palyginti su supervisorctl .
• XML-RPC sąsaja: tas pats HTTP serveris, kurį naudoja žiniatinklio klientas, aptarnauja XML-RPC sąsają, kurią galima naudoti prižiūrėtojo programoms valdyti.

Šiame vadove mes įdiegsime naujausią supervizoriaus versiją, parodysime, kaip sukurti ir valdyti programas per supervisorctl, ir sukonfigūruosime žiniatinklio sąsają programoms valdyti.

Įdiegimas ir pagrindinė konfigūracija

Prižiūrėtoją easy_installįdiegsime naudodami python sąrankos įrankių funkciją.

Pirmiausia atnaujinkite vietinių paketų sąrašą ir įdiekite python setuptools.

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

Dabar galime įdiegti supervizorių.

sudo easy_install supervisor

Kai diegimas bus baigtas, turime sugeneruoti konfigūracijos failą. Sukurkite aplanką, pavadintą supervisorviduje /etc.

sudo mkdir /etc/supervisor

Ir tada atlikite toliau nurodytus veiksmus.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Jei nesate prisijungę naudodami rootvartotoją, galite gauti Permission deniedklaidą (net ir naudodami sudo). Taip yra dėl peradresavimo. Norėdami tai išspręsti, prisijunkite kaip root.

sudo su

Tada galite paleisti komandą dar kartą.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Dabar galite palikti rootvartotoją su exitkomanda. echo_supervisord_confKomanda buvo pateikta mūsų vadovui montavimas.

Pagrindinė konfigūracija

Atidarykite /etc/supervisor/supervisord.conffailą ir patikrinkite jo turinį. Atkreipkite dėmesį, kad šis konfigūracijos failas atitinka INIsintaksę ir yra padalintas į skyrius (pavaizduotas skliausteliuose, kaip nurodyta [section-name]).

Norėdami pridėti programas, kurias valdys prižiūrėtojas, tereikia sukurti atitinkamas [program]skiltis. Tačiau, kad nesusimaišytume su pagrindiniu konfigūracijos failu kiekvieną kartą, kai reikės pridėti (arba pakeisti) programą, naudosime [include]skyrių. Raskite šią skiltį, panaikinkite komentarą ir redaguokite, kad atrodytų taip.

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

Dabar kiekvienai programai, kurią norime pridėti, kataloge sukursime .inifailą /etc/supervisor/conf.d/. Sukurkime šį aplanką.

sudo mkdir /etc/supervisor/conf.d

Paleidžiamas priežiūros serveris

Kaip minėta anksčiau, prižiūrėtojas susideda iš serverio ir prie jo prisijungusių klientų. Kad galėtume valdyti ir valdyti programas, turime paleisti serverį. Norėdami tai padaryti, užregistruosime priežiūros serverį systemd, kad serverį būtų galima paleisti paleidžiant sistemą.

Norėdami tai padaryti, sukurti failą pavadinimu supervisord.serviceį /etc/systemd/systemkatalogą.

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

Pridėkite šį turinį prie failo.

[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

Suaktyvinkite prižiūrėtojo paslaugą.

sudo systemctl start supervisord.service

Kol paslaugos failas yra /etc/systemd/systemkataloge, jis bus automatiškai paleistas paleidžiant sistemą.

Galite patikrinti paslaugos būseną.

systemctl status supervisord.service

Be to, galite peržiūrėti žurnalus.

sudo journalctl -u supervisord.service

Programų pridėjimas

Prižiūrėtojo valdomos programos pateikiamos skirtinguose [program]konfigūracijos skyriuose. Kiekvienai programai, kurią norime valdyti, sukursime atskirą konfigūracijos failą, informuojantį komandos vykdomąjį kelią, bet kokius aplinkos kintamuosius, kaip elgtis išjungus.

Pirmiausia sukurkime paprastą scenarijų, kuris registruoja laiko žymą. Sukurkite failą pavadinimu hello_supervisor.sh(kur norite, mes nurodysime visą šio scenarijaus kelią).

touch hello_supervisor.sh

Dabar įdėkite į jį šį turinį

#!/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

Dabar padarykite jį vykdomą

chmod +x hello_supervisor.sh

Praktiškai šis scenarijus yra beveik nenaudingas. Tačiau mes galime jį panaudoti norėdami parodyti prižiūrėtojo galią. Sukurkite atitinkamą konfigūracijos failą vykdydami toliau nurodytus veiksmus.

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

Dabar į šį failą įdėkite šį turinį.

[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

Pastaba: būtinai pakeiskite USERsavo vartotojo vardu.

Mes peržiūrėsime šią konfigūraciją žingsnis po žingsnio.

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

Pirma, konfigūracija prasideda apibrėžiant programą pavadinimu hello_supervisor . Tai taip pat informuoja visą vykdomojo failo kelią.

autostart=true

Šioje eilutėje nurodoma, kad ši programa turi būti automatiškai paleista, kai paleidžiamas vadovas.

autorestart=true

Jei programa dėl kokių nors priežasčių išsijungia, ši eilutė informuoja prižiūrėtoją, kad jis automatiškai paleis procesą iš naujo.

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

Šios linijos apibrėžia LOGFILE vietą stderrir stdout, atitinkamai.

Programų valdymas

Dabar, kai įdiegėme ir sukonfigūravome prižiūrėtoją, galime valdyti savo procesus.

Pridėję naują programą, turėtume paleisti šias dvi komandas, kad informuotume serverį iš naujo perskaityti konfigūracijos failus ir pritaikyti bet kokius pakeitimus.

sudo supervisorctl reread
sudo supervisorctl update

Dabar vykdykite supervisorctlklientą.

sudo supervisorctl

Jūs būsite pasveikinti su registruotų procesų sąrašu. Pamatysite procesą, iškviestą hello_supervisorsu RUNNINGbūsena.

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

Įveskite helpgalimų komandų sąrašą.

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

Trumpai tariant, mes galime start, stopo restartprogramas, perduodant programos pavadinimą kaip argumentą atitinkamai komandai.

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> 

Taip pat galime pažvelgti į programos išvestį naudodami tailkomandą.

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

Išėjimui taip pat stderrgalite naudoti tail.

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!

Iškvietę statuskomandą galite peržiūrėti visų registruotų programų būseną.

Kai baigsite, galite mesti.

supervisor> quit

Žiniatinklio serverio klientas

Norėdami leisti prieigą prie prižiūrėtojo žiniatinklio serverio, atidarykite prižiūrėtojo konfigūracijos failą ir suraskite [inet_http_server]skyrių.

nano /etc/supervisor/supervisord.conf

Dabar atnaujinkite šio skyriaus konfigūraciją taip.

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

Pakeiskite your_usernameir your_passwordsu norimais kredencialais, išsaugokite pakeitimus ir iš naujo paleiskite priežiūros paslaugą.

sudo systemctl restart supervisord.service

Nepamirškite leisti TCPprieigos prie 9001ugniasienės prievado ir tada pasiekti http://{server-ip}:9001iš naršyklės. Kai paprašys, pateikite savo usernameir password. Dabar galite valdyti savo procesus iš žiniatinklio.

Išvada

Įdiegėme naujausią supervisor versiją, išmokome ją sukonfigūruoti, kad sistema būtų automatiškai paleista naudojant systemd, taip pat peržiūrėjome pagrindinį naudojimą supervisorctl. Išplėstesnės konfigūracijos ir naudojimo atvejų galite rasti oficialioje priežiūros dokumentacijoje .