Publikoval Michal Kočí dňa 16.7.2015 o 11:00 v kategóriach Node.js a Raspberry Pi
Ak používate Git ako verzovací systém pre zdrojové kódy vašej aplikácie, možno ste postrehli, že je docela populárne (a právom) robiť deployment aplikácie práve cez Git. Dnes sa pozrieme ako na to, ak máte Raspberry Pi a na ňom hostujete svoje webové aplikácie.
Lebo je to šikovné, rýchle a jednoduché. Ale nie nutné. Ak máte Node.js aplikáciu, tak deployment (alebo inak povedané rollout) znamená, že musíte na váš server dostať zdrojové súbory vašej aplikácie (javascript, css, html, obrázky, ...) rovnako aj všetky závislosti (obvykle obsah adresára node_modules).
Pokiaľ sa jedná o *nixový server, môžete použiť na nahratie súborov scp (secure copy), ftp (ak máte na serveri ftp nainštalované) alebo obdobný nástroj. Na serveri potom potrebujete dostať aplikáciu do správneho adresára.
Ak súčasťou toho, čo ste na server dostali nie sú závislosti (node_modules), musíte si ich na serveri nainštalovať. A potom reštartnúť web, samozrejme len v prípade, že nemáte sledovanie zmien ktoré si ho reštartne samo (ukázali sme si v minulom príspevku).
To je docela dosť práce, navyše manuálnej a tak je veľká šanca, že niekde spravíte chybu a ak aj nie, tak sa pravdepodobne pri každom ďalšom deploymente budete viac a viac nudiť. Nebolo by lepšie robiť to celé automatizovane? Samozrejme, že bolo...
Princíp je veľmi jednoduchý. Najskôr si na serveri nainštalujete Git a pripravíte si prázdne repository pre váš projekt. Potom si pre toto repository pripravíte tzv. hook, teda skript, ktorý sa spustí po nejakej aktivite - v našom prípade to bude post-update, teda hook ktorý sa vykoná po git push.
Tento skript si pripravíme a v ňom zabezpečíme, že si vaša aplikácia, ktorá bude niekde inde na serveri nainštalovaná (cez git clone) potiahne aktuálnu verziu (git pull). Ak v repository nemáte commitnuté externé závislosti (node_modules), tak ich skript nainštaluje. A ak máte nastavené sledovanie zmien v adresári, aplikácia sa reštartne a vy hneď bežíte novú verziu.
V prvom rade si naištalujte samotný Git:
sudo apt-get install git
Či sa vám nainštaloval správne si overíte ľahko, necháte si vypísať verziu:
git --version
Dobre, Git nainštalovaný, teraz si potrebujete vytvoriť samotné repository. Môžete ho mať napríklad v adresári git, ktorý bude vo vašom domovskom adresári:
cd ~ mkdir git cd git
Pre účely nášho príkladu budeme ďalej predpokladať, že:
Ak sa čokoľvek z vyššie uvedeného vo vašom prípade líši, tak to v príkladoch nižšie patrične zmeňte.
Chceli by ste sa rýchlo a ľahko naučiť programovať webové aplikácie v Javascripte a bežať ich na Node.js? Jednoduché. Rád vás to naučím na mojom školení Node.js - serverových aplikácií v Javascripte.
Poďme si teda vytvoriť samotné repository, stále sme v adresári ~/git
mkdir myfirstapp.git cd myfirstapp.git git init --bare
Vytvorili sme myfirstapp.git adresár a v ňom sme inicializovalé prázdne repository. Do neho budeme pushovať aplikáciu, ktorú chceme deployovať. V tomto adresári sa vytvoril adresár hooks a v ňom ukážkové hook skripty, všetky majú príponu .sample a tak sú neaktívne.
Drobné upozornenie. Toto je klasické repositoty, ktoré si udržiava informácie o obsiahnutých súboroch, commitoch, branchoch a podobne. Čiže priamo tento adresár nechcete použiť na bežanie vášho webu - ten budete bežať z iného adresára, klonu tohto repository.
Ešte než si pripravíme hook, vráťme sa na váš vývojový počítač a pridajme si toto repository. Vychádzam z toho, že váš adresár, v ktorom máte vývojovú verziu aplikácie je naklonovaný z vášho hlavného Git repository (napríklad z bitbucketu alebo githubu).
Pozrieť sa aké remoty máte na adresár napojené viete týmto príkazom spusteným v danom adresári:
git remote -v
Ukáže vám všetky remotes, teda ich názvy a cesty pre fetch a push. Pokiaľ ste s remotes nič nerobili, tak vám pravdepodobne vypísalo dva riadky, oba s názvom origin a s cestou k vášmu repository, jeden pre fetch a druhý pre push.
Čo je na Gite úžasné je, že adresár môžete mať napojený na viac remotov, čo sa hodí aj v tomto prípade. Jeden (obvykle origin) máte napojený na vaše hlavné git repository a druhý (budeme ho volať prod) budete mať na deployment.
Pridajme si teda ďalší remote, patrične upravte parametre príkazu (užívateľské meno, IP adresu a prípadne adresár vášho Rapsberry Pi git repository):
git remote add prod ssh://jasam@10.0.1.10/home/jasam/git/myfirstapp.git
Čiže, pridali sme nový remote s názvom prod, pristupovať k nemu sa bude cez ssh, pripájať sa bude na počítač s IP 10.0.1.10, použitý bude užívateľ jasam a na Raspberry Pi je toto git repository na ceste /home/jasam/git/myfirstapp.git.
Môžete si zase vylistovať remoty (cez git remote -v), teraz by v nich mal byť ako origin, tak aj prod.
Najvyšší čas pushnúť do vášho Raspberry Pi. Spravte teda push, samozrejme do remotu prod, buď cez grafickú aplikáciu ak nejakú používate (napríklad TortoiseGit či SourceTree) alebo cez príkazový riadok:
git push prod
Výborne, práve ste pushli aktuálnu verziu na vaše Raspberry Pi. To ešte nie je nakonfigurované na deployment, ale aby sme všetko riadne pripravili, je dobré mať na ňom už aplikáciu v danom repository.
Vaša aplikácia je nainštalovaná v adresári /var/www/myfirstapp a dostali ste ju tam buď nejak manuálne, alebo ste ju tam manuálne vytvorili, to je jedno. Čo chceme dosiahnuť je, že tento adresár bude klonom repository, nebudete v ňom robiť manuálne zmeny, ale všetky zmeny budete robiť na vašom vývojovom stroji a publikovať do produkcie cez git.
Začnime teda tým, že tento adresár zmažete, ak existuje. Áno, zmaže to váš adresár, takže s rozumom, uistite sa, že všetky zmeny máte v Gite a pushnuté na Raspberry Pi aby v momente, keď nastavíme klon ste mali späť adresár s tou verziou, ktorú chcete.
cd /var/www sudo rm -rf myfirstapp
Adresár je v tomto momente zmazaný, poďme si naklonovať repository:
git clone ~/git/myfirstapp.git cd myfirstapp
Naklonovali ste repository, ktoré sa nachádza v adresári ~/git/myfirstapp.git do adresára /var/www/myfirstapp - tento vám rovno vytvoril git. V ňom teraz nájdete samotnú aplikáciu.
Ak do repository necommitujete node_modules ale nejaké moduly používate, musíte si ich ešte nainštalovať. Či ich komitovať alebo nie je na vás, názory sa rôznia, ja osobne tento adresár nekomitujem.
Ak používate npm, tak viete, že je dobré si pri inštalácii balíčka zvoliť jeho uloženie (respektíve informácie o ňom) do konfiguračného súboru package.json. Na to sa používa parameter --save alebo --save-dev.
Rozdiel v nich je, že parameter --save by ste mali používať pre balíčky, ktoré sú potrebné pre beh aplikácie a --save-dev na balíčky, ktoré používate iba na vývojovom prostredí. Napríklad gulp a podobné nástroje potrebujete pri vývoji, pred commitom a podobne, ale nie sú nutné pre beh aplikácie a tak ich inštalujete iba pre dev.
Ak to takto robíte, robíte to dobre a potom pri inštalácii balíčkov na produkčnom serveri použijete nasledujúci príkaz:
npm install --production
Ak to tak nerobíte, možno by ste mali, v tom prípade použite príkaz bez parametra --production a to isté bude platiť za chvíľu, keď budeme robiť post-update hook.
npm install
Paráda, blížime sa k úspešnému koncu. Máme rozbehané git repository, máme na lokálnom počítači toto repository pridané ako remote, ostáva už len vytvoriť samotný hook.
Prejdite do adresára hooks vo vašom repository (nie v jeho klone) a vytvorte v ňom súbor post-update:
cd ~/git/myfirstapp.git/hooks nano post-update
A do tohto skriptu zapíšte nasledovné:
#!/usr/bin/env bash pwd echo "Switching to directory" cd /var/www/myfirstapp echo "Unsetting git directory" unset GIT_DIR echo "Updating local folder" git pull echo "Installing dependencies" npm install --production echo "Done"
Skript sa dá osekať a vypisuje priebežne čo robí, aby ste videli pri pushhnutí čo presne sa deje. Ak nechcete, riadky začínajúce s pwd a echo odstráňte.
Skript najskôr vypíše aktuálny adresár a prepne sa do adresára, kde je repository naklonované. Odnastaví premennú GIT_DIR, ak to nespravíte, nebude vám to fungovať - skript beží v kontexte Gitu a tak treba túto premennú odnastaviť. Keď je skript prepnutý do správneho adresára, poriahne si poslednú nakomitovanú verziu a nainštaluje npm balíčky.
Uložte súbor a máte hotovo. Keď najbližšie spravíte push do tohto repository, automaticky sa vám zaktualizuje aplikácia a ak používate napríklad forever-service, ktorý sme inštalovali v predminulom príspevku, aplikácia sa pekne zreštartuje. A všetko pri pushnutí uvidíte vo výstupe, bude to vyzerať takto nejak:
remote: /home/jasam/git/myfirstapp.git remote: Switching to directory remote: Unsetting git directory remote: Updating local folder remote: From /home/jasam/git/myfirstapp remote: 3e9d573..5522bca master -> origin/master remote: Updating 3e9d573..5522bca remote: Fast-forward remote: app.js | 2 +- remote: 1 file changed, 1 insertion(+), 1 deletion(-) remote: Installing dependencies remote: npm WARN package.json myfirstapp@1.0.0 No README data remote: Done here
Možno to nebolo málo krokov, uznávam, ale raz nastavíte a váš deployment bude nabudúce na jeden jediný príkaz (git push) a tak námaha teraz vynaložená sa vám veľa krát vráti.
Ak nechceš premeškať príspevky ako je tento, sleduj ma na Twitteri, alebo ak máš RSS čítačku, môžeš sledovať môj RSS kanál.