Instalarea și configurarea supraveghetorului pe Ubuntu 16.04

• Instalare și configurare de bază
• Pornirea serverului de supraveghere
• Adăugarea de programe
• Gestionarea programelor
• Clientul WebServer
• Concluzie

Supervizorul este un sistem client / server utilizat pentru a controla o serie de procese UNIX, mai precis procese legate de un proiect sau un client. De exemplu, puteți utiliza supraveghetorul pentru a genera și monitoriza un număr arbitrar de cozi de lucrători din aplicația dvs. web.

Componentele acestui sistem sunt:

• supervisord: bucata de server a sistemului.
• supervorctl: Interfața de linie de comandă folosită pentru interacțiunea cu serverul.
• Web server: Un server web simplu și o interfață de utilizator web cu funcționalități de bază în comparație cu supervorctl .
• Interfața XML-RPC: Același server HTTP utilizat de clientul web, servește o interfață XML-RPC care poate fi utilizată pentru controlul programelor de supraveghere.

În acest tutorial vom instala cea mai actualizată versiune de supervizor, vom demonstra cum să generați și să gestionați programele supervisorctlși să configurați o interfață web pentru a gestiona programele noastre.

Instalare și configurare de bază

Vom instala supervizorul prin easy_install, o caracteristică a seturilor de configurare ale lui Python.

Mai întâi, actualizați lista locală de pachete și apoi instalați python setuptools.

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

Acum putem instala supervizorul.

sudo easy_install supervisor

Odată ce instalarea este completă, trebuie să generăm fișierul de configurare. Creați un folder numit supervisorîn interior /etc.

sudo mkdir /etc/supervisor

Apoi executați următoarele.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Dacă nu sunteți autentificat cu rootutilizatorul, puteți primi o Permission deniederoare (chiar și cu sudo). Acest lucru se datorează redirecționării. Pentru a depăși acest lucru, conectați-vă ca root.

sudo su

Apoi puteți rula comanda din nou.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Acum puteți lăsa rootutilizatorul cu exitcomanda. echo_supervisord_confComanda a fost asigurată de instalarea noastră supervizor.

Configurație de bază

Deschideți /etc/supervisor/supervisord.conffișierul și verificați conținutul acestuia. Veți observa că acest fișier de configurare urmează INIsintaxa și este împărțit pe secțiuni (reprezentate prin paranteze ca în [section-name]).

Pentru a adăuga programe care vor fi gestionate de către supervizor, trebuie doar să creăm [program]secțiunile corespunzătoare . Totuși, pentru a evita încurcarea cu fișierul principal de configurare de fiecare dată când trebuie să adăugăm (sau să schimbăm) un program, vom folosi [include]secțiunea. Găsiți această secțiune, decomandați-o și apoi modificați-o astfel încât să arate după cum urmează.

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

Acum pentru fiecare program pe care dorim să îl adăugăm, vom crea un .inifișier în interiorul /etc/supervisor/conf.d/directorului. Vă permite să creăm acest folder.

sudo mkdir /etc/supervisor/conf.d

Pornirea serverului de supraveghere

Așa cum am menționat anterior, supervizorul este format dintr-un server și clienți care se conectează la acesta. Pentru a putea gestiona și controla programele, trebuie să pornim serverul. Pentru a face acest lucru, vom înregistra serverul de supraveghere în systemd, astfel încât serverul să poată fi pornit la pornirea sistemului.

Pentru aceasta, creați un fișier numit supervisord.serviceîn /etc/systemd/systemdirector.

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

Adăugați următorul conținut în fișier.

[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

Activați serviciul de supraveghere.

sudo systemctl start supervisord.service

Atâta timp cât fișierul de serviciu este localizat în /etc/systemd/systemdirector, acesta va fi pornit automat la pornirea sistemului.

Puteți verifica starea serviciului.

systemctl status supervisord.service

De asemenea, puteți consulta jurnalele.

sudo journalctl -u supervisord.service

Adăugarea de programe

Programele controlate de supervizor sunt date de diferite [program]secțiuni din configurație. Pentru fiecare program pe care dorim să îl gestionăm, vom crea un fișier de configurare autonom care informează calea executabilă a comenzii, orice variabile de mediu, cum se poate efectua în cazul unei opriri.

Mai întâi, să creăm un script simplu care înregistrează un timestamp. Creați un fișier numit hello_supervisor.sh(oriunde doriți, vom face referire la calea completă a acestui script).

touch hello_supervisor.sh

Acum, puneți în ea următorul conținut

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

Acum face-l executabil

chmod +x hello_supervisor.sh

În termeni practice, acest scenariu este inutil. Cu toate acestea, îl putem folosi pentru a demonstra puterea supraveghetorului. Creați fișierul de configurare corespunzător executând următoarele.

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

Acum introduceți următorul conținut în acest fișier.

[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

Notă: Asigurați-vă că înlocuiți USERcu numele de utilizator.

Vom examina această configurație pas cu pas.

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

În primul rând, configurația începe prin definirea unui program de nume hello_supervisor . De asemenea, informează calea completă a executabilului care trebuie rulat.

autostart=true

Această linie afirmă că acest program ar trebui să fie automat început atunci când supervizorul este pornit.

autorestart=true

Dacă programul renunță, din orice motiv, această linie informează supraveghetorul să repornească automat procesul.

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

Aceste linii definesc locația fișierului de înregistrare pentru stderrși stdout, respectiv.

Gestionarea programelor

Acum că am instalat și configurat supraveghetorul, suntem capabili să ne gestionăm procesele.

După adăugarea unui program nou, ar trebui să executăm următoarele două comenzi, pentru a informa serverul să recitească fișierele de configurare și să aplice orice modificări.

sudo supervisorctl reread
sudo supervisorctl update

Acum executați supervisorctlclientul.

sudo supervisorctl

Veți fi întâmpinat cu o listă a proceselor înregistrate. Veți vedea un proces proclamat hello_supervisorcu un RUNNINGstatut.

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

Tastați helppentru o listă de comenzi disponibile.

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

Pe scurt, putem start, stopși restartprograme prin care trece numele programului ca argument la comanda respectivă.

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> 

Putem, de asemenea, să aruncăm o privire la ieșirea programului cu tailcomanda.

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

Pentru stderrieșire, puteți utiliza tail, de asemenea.

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!

Invocând statuscomanda, puteți vizualiza starea tuturor programelor înregistrate.

După ce ai terminat, poți renunța.

supervisor> quit

Clientul WebServer

Pentru a permite accesul la serverul de supraveghere, deschideți fișierul de configurare de supraveghere și localizați [inet_http_server]secțiunea.

nano /etc/supervisor/supervisord.conf

Acum actualizați configurația acestei secțiuni cu următoarele.

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

Înlocuiți your_usernameși your_passwordcu datele de acreditare dorite, salvați-vă modificările și reporniți serviciul de supraveghere.

sudo systemctl restart supervisord.service

Nu uitați să permiteți TCPaccesul la portul de 9001pe firewall și apoi accesul http://{server-ip}:9001din browser. Când vi se cere, furnizați-vă usernameși password. Acum puteți controla procese de pe web.

Concluzie

Am instalat cea mai actualizată versiune de supervizare, am învățat cum să o configurăm pentru pornirea automată a sistemului cu systemd și, de asemenea, am revizuit o utilizare de bază a supervisorctl. Pentru cazuri de configurare și utilizare mai avansate, puteți consulta documentația oficială de control .