Supervisor instalēšana un konfigurēšana Ubuntu 16.04

Supervisor ir klienta/servera sistēma, ko izmanto, lai kontrolētu vairākus UNIX procesus, konkrētāk, procesus, kas saistīti ar projektu vai klientu. Piemēram, varat izmantot supervizoru, lai izveidotu un pārraudzītu patvaļīgu skaitu savas tīmekļa lietojumprogrammas darbinieku rindas.

Šīs sistēmas sastāvdaļas ir:

• supervisor: sistēmas servera daļa.
• supervisorctl: komandrindas interfeiss, ko izmanto, lai mijiedarbotos ar serveri.
• Tīmekļa serveris: vienkāršs tīmekļa serveris un tīmekļa lietotāja interfeiss ar pamata funkcionalitāti salīdzinājumā ar supervisorctl .
• XML-RPC interfeiss: tas pats HTTP serveris, ko izmanto tīmekļa klients, apkalpo XML-RPC interfeisu, ko var izmantot, lai kontrolētu uzraudzības programmas.

Šajā apmācībā mēs instalēsim visjaunāko supervizora versiju, parādīsim, kā izveidot un pārvaldīt programmas, izmantojot supervisorctl, un konfigurēsim tīmekļa saskarni, lai pārvaldītu mūsu programmas.

Uzstādīšana un pamata konfigurācija

Mēs instalēsim supervizoru, izmantojot easy_installpython iestatīšanas rīku līdzekli.

Vispirms atjauniniet vietējo pakotņu sarakstu un pēc tam instalējiet python setuptools.

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

Tagad mēs varam uzstādīt supervizoru.

sudo easy_install supervisor

Kad instalēšana ir pabeigta, mums ir jāģenerē mūsu konfigurācijas fails. Izveidojiet mapi ar nosaukumu supervisoriekšpusē /etc.

sudo mkdir /etc/supervisor

Un pēc tam izpildiet tālāk norādīto.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Ja neesat pieteicies ar rootlietotāju, var tikt parādīts Permission deniedkļūdas ziņojums (pat ar sudo). Tas ir saistīts ar novirzīšanu. Lai to novērstu, piesakieties kā root.

sudo su

Pēc tam jūs varat palaist komandu vēlreiz.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Tagad varat atstāt rootlietotāju ar exitkomandu. echo_supervisord_confKomanda sniedza mūsu vadītājs uzstādīšana.

Pamatkonfigurācija

Atveriet /etc/supervisor/supervisord.conffailu un pārbaudiet tā saturu. Ņemiet vērā, ka šis konfigurācijas fails ievēro INIsintakse un ir sadalīts sadaļās (attēlotas ar iekavām, kā parādīts [section-name]).

Lai pievienotu programmas, kuras pārvalda vadītājs, mums vienkārši jāizveido atbilstošās [program]sadaļas. Tomēr, lai izvairītos no nejaukšanās ar galveno konfigurācijas failu katru reizi, kad mums ir jāpievieno (vai jāmaina) programma, mēs izmantosim [include]sadaļu. Atrodiet šo sadaļu, noņemiet komentārus un pēc tam rediģējiet to, lai tā izskatītos šādi.

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

Tagad katrai programmai, kuru vēlamies pievienot, mēs direktorijā izveidosim .inifailu /etc/supervisor/conf.d/. Izveidosim šo mapi.

sudo mkdir /etc/supervisor/conf.d

Uzrauga servera palaišana

Kā minēts iepriekš, uzraugs sastāv no servera un klientiem, kas ar to izveido savienojumu. Lai varētu pārvaldīt un kontrolēt programmas, mums ir jāstartē serveris. Lai to izdarītu, mēs reģistrēsim pārrauga serveri systemd, lai serveri varētu palaist sistēmas startēšanas laikā.

Lai to izdarītu, izveidot failu sauc supervisord.servicešajā /etc/systemd/systemdirektorijā.

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

Pievienojiet failam šādu saturu.

[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

Aktivizējiet pārrauga pakalpojumu.

sudo systemctl start supervisord.service

Kamēr pakalpojuma fails atrodas /etc/systemd/systemdirektorijā, tas tiks automātiski palaists sistēmas startēšanas laikā.

Jūs varat pārbaudīt pakalpojuma statusu.

systemctl status supervisord.service

Varat arī pārbaudīt žurnālus.

sudo journalctl -u supervisord.service

Programmu pievienošana

Programmas, ko kontrolē supervizors, ir norādītas dažādās [program]konfigurācijas sadaļās. Katrai programmai, kuru vēlamies pārvaldīt, mēs izveidosim atsevišķu konfigurācijas failu, kas informēs komandas izpildāmo ceļu, vides mainīgos, kā rīkoties izslēgšanas gadījumā.

Vispirms izveidosim vienkāršu skriptu, kas reģistrē laikspiedolu. Izveidojiet failu ar nosaukumu hello_supervisor.sh(kur vien vēlaties, mēs norādīsim pilnu šī skripta ceļu).

touch hello_supervisor.sh

Tagad ievietojiet tajā šādu saturu

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

Tagad padariet to izpildāmu

chmod +x hello_supervisor.sh

Praktiski šis skripts ir diezgan bezjēdzīgs. Tomēr mēs varam to izmantot, lai demonstrētu uzrauga spēku. Izveidojiet atbilstošo konfigurācijas failu, izpildot tālāk norādīto.

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

Tagad ievietojiet šajā failā šādu saturu.

[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

Piezīme. Noteikti aizstājiet USERar savu lietotājvārdu.

Mēs soli pa solim pārskatīsim šo konfigurāciju.

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

Pirmkārt, konfigurācija sākas, definējot programmu ar nosaukumu hello_supervisor . Tas arī informē pilnu izpildāmā faila ceļu.

autostart=true

Šajā rindiņā ir norādīts, ka šī programma ir jāsāk automātiski, kad tiek startēts supervisor.

autorestart=true

Ja programma kāda iemesla dēļ tiek aizvērta, šī rindiņa informē vadītāju, lai automātiski restartētu procesu.

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

Šīs rindas attiecīgi nosaka žurnālfaila atrašanās vietu stderrun stdout.

Programmu pārvaldība

Tagad, kad esam uzstādījuši un konfigurējuši supervizoru, varam pārvaldīt savus procesus.

Pēc jaunas programmas pievienošanas mums vajadzētu palaist šādas divas komandas, lai informētu serveri, lai tas atkārtoti izlasītu konfigurācijas failus un piemērotu visas izmaiņas.

sudo supervisorctl reread
sudo supervisorctl update

Tagad izpildiet supervisorctlklientu.

sudo supervisorctl

Jūs sagaidīs reģistrēto procesu saraksts. Jūs redzēsit procesu, kas izsaukts hello_supervisorar RUNNINGstatusu.

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

Ievadiet helppieejamo komandu sarakstu.

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

Īsāk sakot, mēs varam start, stopun restartprogrammas, nododot programmas nosaukumu kā argumentu attiecīgajai 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> 

Mēs varam arī apskatīt programmas izvadi ar tailkomandu.

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

Par stderrizejas, jūs varat izmantot tailkā labi.

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!

Izsaucot statuskomandu, var apskatīt visu reģistrēto programmu statusu.

Kad esat pabeidzis, varat beigt.

supervisor> quit

Tīmekļa servera klients

Lai atļautu piekļuvi pārrauga tīmekļa serverim, atveriet uzrauga konfigurācijas failu un atrodiet [inet_http_server]sadaļu.

nano /etc/supervisor/supervisord.conf

Tagad atjauniniet šīs sadaļas konfigurāciju ar tālāk norādīto.

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

Nomainiet your_usernameun your_passwordar vēlamajiem akreditācijas datiem, saglabājiet modifikācijas un restartējiet uzrauga pakalpojumu.

sudo systemctl restart supervisord.service

Atcerieties atļaut TCPpiekļuvi 9001ugunsmūra portam un pēc tam piekļūt http://{server-ip}:9001no pārlūkprogrammas. Kad tiek prasīts, norādiet savu usernameun password. Tagad varat kontrolēt savus procesus no tīmekļa.

Secinājums

Mēs esam instalējuši visjaunāko supervisord versiju, iemācījušies to konfigurēt sistēmas automātiskai palaišanai ar systemd, kā arī pārskatījuši pamata lietojumu supervisorctl. Lai uzzinātu vairāk par konfigurācijas un lietošanas gadījumiem, varat skatīt oficiālo uzrauga dokumentāciju .