Supervisori installimine ja konfigureerimine Ubuntu 16.04-s

Supervisor on klient/server süsteem, mida kasutatakse mitme UNIX-i protsesside, täpsemalt projekti või kliendiga seotud protsesside juhtimiseks. Näiteks võite kasutada supervisorit oma veebirakenduse suvalise arvu töötajate järjekordade loomiseks ja jälgimiseks.

Selle süsteemi komponendid on:

• supervisor: süsteemi serveriosa.
• supervisorctl: käsurea liides, mida kasutatakse serveriga suhtlemiseks.
• Veebiserver: lihtne veebiserver ja põhifunktsioonidega veebikasutajaliides võrreldes supervisorctl-ga .
• XML-RPC liides: sama HTTP-server, mida kasutab veebiklient, teenindab XML-RPC liidest, mida saab kasutada järelevalveprogrammide juhtimiseks.

Selles õpetuses installime supervisori uusima versiooni, näitame, kuidas luua ja hallata programme supervisorctl, ning konfigureerida veebiliidese meie programmide haldamiseks.

Paigaldamine ja põhikonfiguratsioon

Installime supervisori easy_installpythoni häälestustööriistade funktsiooni kaudu .

Esmalt värskendage oma kohalike pakettide loendit ja seejärel installige python setuptools.

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

Nüüd saame paigaldada supervisori.

sudo easy_install supervisor

Kui installimine on lõppenud, peame genereerima oma konfiguratsioonifaili. Looge supervisorsees nimega kaust /etc.

sudo mkdir /etc/supervisor

Ja seejärel teostage järgmine.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Kui te pole rootkasutajaga sisse logitud , võite saada Permission deniedveateate (isegi sudo). See on tingitud ümbersuunamisest. Selle ületamiseks logige sisse administraatorina.

sudo su

Seejärel saate käsu uuesti käivitada.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Nüüd saate jätta rootkasutaja exitkäsuga. echo_supervisord_confKäsu andis meie juhendaja paigaldus.

Põhikonfiguratsioon

Avage /etc/supervisor/supervisord.conffail ja kontrollige selle sisu. Pange tähele, et see konfiguratsioonifail järgib INIsüntaksit ja see on jagatud osadeks (esinevad sulgudes nagu [section-name]).

Juhendaja poolt hallatavate programmide lisamiseks peame lihtsalt looma vastavad [program]jaotised. Kuid selleks, et vältida peamise konfiguratsioonifailiga segamist iga kord, kui peame programmi lisama (või muutma), kasutame [include]jaotist. Otsige üles see jaotis, tühjendage selle kommentaarid ja seejärel muutke seda nii, et see näeks välja järgmine.

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

Nüüd loome iga programmi jaoks, mida tahame lisada, kataloogis .inifaili /etc/supervisor/conf.d/. Loome selle kausta.

sudo mkdir /etc/supervisor/conf.d

Supervisor serveri käivitamine

Nagu eelnevalt märgitud, koosneb supervisor serverist ja sellega ühenduse loovatest klientidest. Programmide haldamiseks ja juhtimiseks peame serveri käivitama. Selleks registreerime järelevalveserveri asukohas systemd, et serverit saaks süsteemi käivitamisel käivitada.

Selleks looge fail nimega supervisord.serviceon /etc/systemd/systemkataloog.

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

Lisage faili järgmine sisu.

[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

Aktiveerige järelevalveteenus.

sudo systemctl start supervisord.service

Kuni teenusefail asub /etc/systemd/systemkataloogis, käivitatakse see automaatselt süsteemi käivitamisel.

Saate vaadata teenuse olekut.

systemctl status supervisord.service

Samuti saate vaadata logisid.

sudo journalctl -u supervisord.service

Programmide lisamine

Ülevaataja juhitavad programmid on antud [program]konfiguratsiooni erinevate osade kaupa. Iga programmi jaoks, mida me tahame hallata, loome eraldiseisva konfiguratsioonifaili, mis annab teavet käsu käivitatava tee, mis tahes keskkonnamuutujate kohta, kuidas toimida seiskamise korral.

Kõigepealt loome lihtsa skripti, mis logib ajatempli. Looge fail nimega hello_supervisor.sh(kõikjal, kus soovite, viitame selle skripti täielikule teele).

touch hello_supervisor.sh

Nüüd pange sinna järgmine sisu

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

Nüüd tehke see käivitatavaks

chmod +x hello_supervisor.sh

Praktikas on see skript üsna kasutu. Siiski saame seda kasutada järelevaataja võimu demonstreerimiseks. Looge vastav konfiguratsioonifail, käivitades järgmise.

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

Nüüd sisestage sellesse faili järgmine sisu.

[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

Märkus. Asendage kindlasti USERoma kasutajanimega.

Vaatame selle konfiguratsiooni samm-sammult üle.

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

Esiteks algab konfigureerimine programmi nimega hello_supervisor määratlemisega . Samuti teatab see käivitatava käivitatava faili täieliku tee.

autostart=true

Sellel real on kirjas, et see programm peaks supervisori käivitamisel automaatselt käivituma.

autorestart=true

Kui programm mingil põhjusel sulgub, teavitab see rida juhendajat, et ta protsessi automaatselt taaskäivitaks.

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

Need read määravad vastavalt logifaili asukoha stderrja stdout.

Programmide haldamine

Nüüd, kui oleme supervisori installinud ja konfigureerinud, saame oma protsesse hallata.

Pärast uue programmi lisamist peaksime käivitama järgmised kaks käsku, et teavitada serverit konfiguratsioonifailide uuesti lugemisest ja muudatuste rakendamisest.

sudo supervisorctl reread
sudo supervisorctl update

Nüüd täitke supervisorctlklient.

sudo supervisorctl

Teid tervitatakse registreeritud protsesside loendiga. Näete proccess nimetatakse hello_supervisorkoos RUNNINGolekut.

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

helpSaadaolevate käskude loendi kuvamiseks tippige .

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

Lühidalt öeldes saame start, stopja restartprogrammid, edastades programmi nime argumendina vastavale käsule.

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> 

Samuti saame tailkäsuga vaadata programmi väljundit .

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

Sest stderrtoodangu, mida saab kasutada tailsamuti.

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!

Autor tuginedes statuskäsk, saate vaadata olekut kõik registreeritud programmid.

Kui olete lõpetanud, võite lõpetada.

supervisor> quit

Veebiserveri klient

Juurdepääsu lubamiseks ülevaataja veebiserverile avage järelevaataja konfiguratsioonifail ja leidke [inet_http_server]jaotis.

nano /etc/supervisor/supervisord.conf

Nüüd värskendage selle jaotise konfiguratsiooni järgmisega.

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

Asendage your_usernameja your_passwordsoovitud mandaatidega, salvestage oma muudatused ja taaskäivitage järelevalveteenus.

sudo systemctl restart supervisord.service

Ärge unustage lubada TCPjuurdepääsu 9001tulemüüri pordile ja seejärel juurdepääsu http://{server-ip}:9001brauserist. Kui küsitakse, esitage oma usernameja password. Nüüd saate oma protsesse veebist juhtida.

Järeldus

Oleme installinud supervisordi uusima versiooni, õppinud, kuidas seda süsteemi automaatseks käivitamiseks süsteemiga konfigureerida, ja vaadanud üle ka rakenduse põhikasutuse supervisorctl. Täpsema konfiguratsiooni ja kasutusjuhtude jaoks võite vaadata ametlikku järelevaataja dokumentatsiooni .