Supervisorin asentaminen ja määrittäminen Ubuntu 16.04:ään

Supervisor on asiakas/palvelinjärjestelmä, jolla ohjataan useita UNIX-prosesseja, tarkemmin sanottuna projektiin tai asiakkaaseen liittyviä prosesseja. Voit esimerkiksi käyttää supervisoria luomaan ja valvomaan mielivaltaisen määrän web-sovelluksesi työntekijöiden jonoja.

Tämän järjestelmän komponentit ovat:

• supervisor: Järjestelmän palvelinosa.
• supervisorctl: komentoriviliittymä, jota käytetään vuorovaikutuksessa palvelimen kanssa.
• Web-palvelin: Yksinkertainen verkkopalvelin ja web-käyttöliittymä, jossa on perustoiminnot verrattuna supervisorctl:ään .
• XML-RPC-liitäntä: Sama HTTP-palvelin, jota web-asiakas käyttää, palvelee XML-RPC-liitäntää, jota voidaan käyttää valvojan ohjelmien ohjaamiseen.

Tässä opetusohjelmassa asennamme viimeisimmän supervisor-version, näytämme kuinka supervisorctlluodaan ja hallinnoidaan ohjelmia kautta ja määritämme verkkokäyttöliittymän ohjelmiemme hallintaa varten.

Asennus ja peruskonfigurointi

easy_installAsennamme supervisorin kautta , joka on pythonin asennustyökalujen ominaisuus.

Päivitä ensin paikallinen pakettiluettelo ja asenna sitten python setuptools.

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

Nyt voimme asentaa valvojan.

sudo easy_install supervisor

Kun asennus on valmis, meidän on luotava määritystiedostomme. Luo kansio, jonka nimi on supervisorsisällä /etc.

sudo mkdir /etc/supervisor

Ja sitten suorita seuraava.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Jos et ole kirjautunut sisään rootkäyttäjällä, saatat saada Permission deniedvirheilmoituksen (jopa sudo). Tämä johtuu uudelleenohjauksesta. Voit voittaa tämän kirjautumalla sisään root-käyttäjänä.

sudo su

Sitten voit suorittaa komennon uudelleen.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Voit nyt jättää rootkäyttäjälle exitkomennon. echo_supervisord_confKomento tarjosi esimiehemme asennus.

Peruskokoonpano

Avaa /etc/supervisor/supervisord.conftiedosto ja tarkista sen sisältö. Huomaa, että tämä asetustiedosto noudattaa INIsyntaksia, ja se on jaettu osioihin (esitetty suluilla, kuten kohdassa [section-name]).

Jos haluat lisätä ohjelmia valvojan hallittavaksi, meidän tarvitsee vain luoda asianmukaiset [program]osiot. Käytämme [include]osiota kuitenkin, jotta vältytään sekoittamasta pääasetustiedostoa aina, kun meidän on lisättävä (tai muutettava) ohjelmaa . Etsi tämä osio, poista sen kommentti ja muokkaa sitä seuraavan näköiseksi.

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

Nyt jokaiselle ohjelmalle, jonka haluamme lisätä, luomme .initiedoston /etc/supervisor/conf.d/hakemistoon. Luodaan tämä kansio.

sudo mkdir /etc/supervisor/conf.d

Käynnistetään valvojapalvelin

Kuten aiemmin mainittiin, valvoja koostuu palvelimesta ja siihen muodostavista asiakkaista. Jotta voimme hallita ja hallita ohjelmia, meidän on käynnistettävä palvelin. Tätä varten rekisteröimme valvojan palvelimen sisään systemd, jotta palvelin voidaan käynnistää järjestelmän käynnistyksen yhteydessä.

Tehdä niin, luo tiedosto nimeltä supervisord.servicevuonna /etc/systemd/systemhakemistossa.

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

Lisää tiedostoon seuraava sisältö.

[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

Aktivoi valvojapalvelu.

sudo systemctl start supervisord.service

Niin kauan kuin palvelutiedosto sijaitsee /etc/systemd/systemhakemistossa, se käynnistetään automaattisesti järjestelmän käynnistyksen yhteydessä.

Voit tarkistaa palvelun tilan.

systemctl status supervisord.service

Voit myös tarkistaa lokit.

sudo journalctl -u supervisord.service

Ohjelmien lisääminen

Supervisorin ohjaamat ohjelmat annetaan [program]konfiguraation eri osioissa. Jokaiselle ohjelmalle, jota haluamme hallita, luomme erillisen konfigurointitiedoston, joka ilmoittaa komennon suoritettavan polun, mahdolliset ympäristömuuttujat ja kuinka toimia sammutettaessa.

Luodaan ensin yksinkertainen komentosarja, joka kirjaa aikaleiman. Luo tiedosto nimeltä hello_supervisor.sh(missä tahansa haluat, viittaamme tämän skriptin koko polkuun).

touch hello_supervisor.sh

Laita siihen nyt seuraava sisältö

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

Tee siitä nyt suoritettava

chmod +x hello_supervisor.sh

Käytännössä tämä kirjoitus on melko hyödytön. Voimme kuitenkin käyttää sitä osoittamaan valvojan voimaa. Luo vastaava asetustiedosto suorittamalla seuraava.

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

Laita seuraava sisältö tähän tiedostoon.

[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

Huomautus: Muista korvata se USERkäyttäjänimelläsi.

Tarkistamme tämän kokoonpanon vaihe vaiheelta.

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

Ensin konfigurointi alkaa määrittämällä ohjelma, jonka nimi on hello_supervisor . Se ilmoittaa myös suoritettavan suoritettavan tiedoston täyden polun.

autostart=true

Tällä rivillä sanotaan, että tämä ohjelma tulee käynnistää automaattisesti, kun valvoja käynnistetään.

autorestart=true

Jos ohjelma jostain syystä sulkeutuu, tämä rivi kehottaa valvojaa käynnistämään prosessin automaattisesti uudelleen.

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

Nämä rivit määrittävät lokitiedoston sijainnin stderrja stdoutvastaavasti.

Ohjelmien hallinta

Nyt kun olemme asentaneet ja konfiguroineet supervisorin, pystymme hallitsemaan prosessejamme.

Kun olet lisännyt uuden ohjelman, meidän pitäisi suorittaa seuraavat kaksi komentoa, jotta palvelin lukee määritystiedostot uudelleen ja ottamaan käyttöön muutokset.

sudo supervisorctl reread
sudo supervisorctl update

Suorita nyt supervisorctlasiakas.

sudo supervisorctl

Sinua toivotetaan tervetulleeksi luettelolla rekisteröidyistä prosesseista. Näet prosessin, hello_supervisorjossa on RUNNINGtila.

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

Kirjoita helpluettelo käytettävissä olevista komennoista.

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

Lyhyesti sanottuna voimme start, stopja restartohjelmat välittämällä ohjelman nimen argumenttina vastaavalle komennolle.

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> 

Voimme myös katsoa ohjelman tulostetta tailkomennolla.

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

Voit käyttää myös stderrtulostukseen 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!

Kutsumalla statuskomennon voit tarkastella kaikkien rekisteröityjen ohjelmien tilaa.

Kun olet valmis, voit lopettaa.

supervisor> quit

Web-palvelin asiakas

Jos haluat sallia pääsyn valvojan verkkopalvelimeen, avaa valvojan määritystiedosto ja etsi [inet_http_server]osio.

nano /etc/supervisor/supervisord.conf

Päivitä nyt tämän osion kokoonpano seuraavasti.

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

Korvaa your_usernameja your_passwordhaluamillasi tunnistetiedoilla, tallenna muutokset ja käynnistä valvojapalvelu uudelleen.

sudo systemctl restart supervisord.service

Muista sallia palomuurin TCPportin käyttö 9001ja sitten pääsy http://{server-ip}:9001selaimesta. Anna pyydettäessä oma usernameja password. Voit nyt ohjata prosessejasi verkosta.

Johtopäätös

Olemme asentaneet uusimman version supervisordista, oppineet määrittämään sen järjestelmän automaattista käynnistystä varten systemd:llä ja tarkistanut myös :n peruskäytön supervisorctl. Tarkemmat konfigurointi- ja käyttötapaukset löydät virallisesta valvojan dokumentaatiosta .