Að setja upp og stilla umsjónarmann á Ubuntu 16.04

Supervisor er viðskiptavinur/miðlarakerfi sem notað er til að stjórna fjölda UNIX ferla, nánar tiltekið ferlum sem tengjast verkefni eða viðskiptavin. Til dæmis gætirðu notað umsjónarmann til að hleypa af stað og fylgjast með handahófskenndum fjölda starfsmanna biðraða í vefforritinu þínu.

Íhlutir þessa kerfis eru:

• supervisord: Miðlarahluti kerfisins.
• supervisorctl: Skipanalínuviðmótið sem notað er til að hafa samskipti við netþjóninn.
• Vefþjónn: Einfaldur vefþjónn og netnotendaviðmót með grunnvirkni miðað við supervisorctl .
• XML-RPC tengi: Sami HTTP netþjónn sem vefþjónninn notar, þjónar XML-RPC tengi sem hægt er að nota til að stjórna umsjónarforritum.

Í þessari kennslu munum við setja upp nýjustu útgáfuna af supervisor, sýna hvernig á að hrogna og stjórna forritum í gegnum supervisorctlog stilla vefviðmót til að stjórna forritunum okkar.

Uppsetning og grunnstilling

Við munum setja upp umsjónarmann í gegnum easy_install, eiginleika uppsetningarverkfæra Python.

Uppfærðu fyrst staðbundna pakkalistann þinn og settu síðan upp Python setuptools.

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

Nú getum við sett upp umsjónarmann.

sudo easy_install supervisor

Þegar uppsetningunni er lokið verðum við að búa til stillingarskrána okkar. Búðu til möppu sem heitir supervisorinni /etc.

sudo mkdir /etc/supervisor

Og framkvæma síðan eftirfarandi.

echo_supervisord_conf >  /etc/supervisor/supervisord.conf

Ef þú ert ekki skráður inn með rootnotandanum gætirðu fengið Permission deniedvillu (jafnvel með sudo). Þetta er vegna tilvísunarinnar. Til að sigrast á þessu skaltu skrá þig inn sem rót.

sudo su

Þá geturðu keyrt skipunina aftur.

echo_supervisord_conf > /etc/supervisor/supervisord.conf

Þú getur nú skilið rootnotandann eftir með exitskipunina. The echo_supervisord_confstjórn var veitt af leiðbeinanda uppsetningu okkar.

Grunnstilling

Opnaðu /etc/supervisor/supervisord.confskrána og athugaðu innihald hennar. Þú munt taka eftir því að þessi stillingarskrá fylgir INIsetningafræðinni og henni er deilt með köflum (táknað með sviga eins og í [section-name]).

Til að bæta við forritum til að stjórna af umsjónarmanni þurfum við bara að búa til viðeigandi [program]hluta. Hins vegar, til að forðast að klúðra aðalstillingarskránni í hvert skipti sem við þurfum að bæta við (eða breyta) forriti, munum við nota [include]hlutann. Finndu þennan hluta, afskrifaðu hann og breyttu honum svo þannig að hann líti út eins og eftirfarandi.

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

Nú fyrir hvert forrit sem við viljum bæta við munum við búa til .iniskrá inni í /etc/supervisor/conf.d/möppunni. Við skulum búa til þessa möppu.

sudo mkdir /etc/supervisor/conf.d

Ræsir umsjónarþjóninn

Eins og áður hefur komið fram er umsjónarmaður samsettur af netþjóni og viðskiptavinum sem tengjast honum. Til að geta stjórnað og stjórnað forritum þurfum við að ræsa þjóninn. Til að gera það munum við skrá umsjónarþjóninn í systemd, þannig að hægt sé að ræsa þjóninn við ræsingu kerfisins.

Til að gera það skaltu búa til skrá sem heitir supervisord.serviceí /etc/systemd/systemmöppunni.

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

Bættu eftirfarandi innihaldi við skrána.

[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

Virkjaðu umsjónarþjónustuna.

sudo systemctl start supervisord.service

Svo lengi sem þjónustuskráin er staðsett í /etc/systemd/systemmöppunni verður hún sjálfkrafa ræst við ræsingu kerfisins.

Þú getur athugað stöðu þjónustunnar.

systemctl status supervisord.service

Einnig er hægt að skoða logs.

sudo journalctl -u supervisord.service

Bætir við forritum

Forritin sem stjórnað er af umsjónarmanni eru gefin upp af mismunandi [program]hlutum í uppsetningunni. Fyrir hvert forrit sem við viljum stjórna munum við búa til sjálfstæða stillingarskrá sem upplýsir um keyrsluslóð skipana, allar umhverfisbreytur, hvernig á að framkvæma ef lokun verður.

Fyrst skulum við búa til einfalt handrit sem skráir tímastimpil. Búðu til skrá sem heitir hello_supervisor.sh(hvar sem þú vilt, við munum vísa til fullrar slóðar þessa handrits).

touch hello_supervisor.sh

Settu nú eftirfarandi innihald inn í það

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

Gerðu það nú keyranlegt

chmod +x hello_supervisor.sh

Í raun er þetta handrit frekar gagnslaust. Hins vegar getum við notað það til að sýna fram á vald umsjónarmanns. Búðu til samsvarandi stillingarskrá með því að keyra eftirfarandi.

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

Settu nú eftirfarandi innihald í þessa skrá.

[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

Athugið: Vertu viss um að skipta USERút fyrir notandanafnið þitt.

Við munum fara yfir þessa stillingu skref fyrir skref.

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

Í fyrsta lagi byrjar uppsetningin á því að skilgreina forrit með nafninu hello_supervisor . Það upplýsir einnig alla slóð executable sem á að keyra.

autostart=true

Þessi lína segir að þetta forrit ætti að vera sjálfkrafa ræst þegar umsjónarmaður er ræstur.

autorestart=true

Ef forritið hættir, af einhverjum ástæðum, tilkynnir þessi lína umsjónarmanni að endurræsa ferlið sjálfkrafa.

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

Þessar línur skilgreina staðsetningu logskrár fyrir stderrog stdout, í sömu röð.

Stjórna forritum

Nú þegar við höfum sett upp og stillt umsjónarmann getum við stjórnað ferlum okkar.

Eftir að nýju forriti hefur verið bætt við ættum við að keyra eftirfarandi tvær skipanir, til að láta þjóninn vita að endurlesa stillingarskrárnar og beita öllum breytingum.

sudo supervisorctl reread
sudo supervisorctl update

Framkvæmdu nú supervisorctlviðskiptavininn.

sudo supervisorctl

Þú munt taka á móti þér með lista yfir skráða ferla. Þú munt sjá ferli sem kallast hello_supervisormeð RUNNINGstöðu.

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

Sláðu helpinn lista yfir tiltækar skipanir.

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

Í hnotskurn getum við start, stopog restartforrit með því að senda heiti forritsins sem rök fyrir viðkomandi skipun.

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> 

Við getum líka skoðað úttak forritsins með tailskipuninni.

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

Fyrir stderrúttakið geturðu líka notað 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!

Með því að kalla fram statusskipunina geturðu skoðað stöðu allra skráðra forrita.

Þegar þú ert búinn geturðu hætt.

supervisor> quit

Viðskiptavinur vefþjónsins

Til að leyfa aðgang að eftirlitsvefþjóninum skaltu opna stillingarskrá eftirlitsaðila og finna [inet_http_server]hlutann.

nano /etc/supervisor/supervisord.conf

Uppfærðu nú stillingar þessa hluta með eftirfarandi.

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

Skiptu um your_usernameog your_passwordvistaðu breytingarnar þínar og endurræstu umsjónarþjónustuna með þeim skilríkjum sem þú vilt.

sudo systemctl restart supervisord.service

Mundu að leyfa TCPaðgang að gáttinni 9001á eldveggnum þínum og síðan aðgang http://{server-ip}:9001úr vafranum þínum. Þegar spurt er, gefðu upp usernameog password. Þú getur nú stjórnað ferlum þínum af vefnum.

Niðurstaða

Við höfum sett upp nýjustu útgáfuna af supervisord, lært hvernig á að stilla það fyrir sjálfvirka ræsingu kerfisins með systemd og einnig farið yfir grunnnotkun á supervisorctl. Fyrir fullkomnari uppsetningu og notkunartilvik geturðu vísað til opinberra eftirlitsskjala .