Jednoduchý deploy skript nejen pro web v Silexu

Od chvíle, co si hraju se Symfony 2 a Silexem, koketuju rovněž s nejrůznějšími nástroji určenými pro nakopírování hotové aplikace na produkční server. Řešení se nabízejí mraky, od Gitu přes specializované skripty až po různě zaintegrované balíčky, které závisejí na Composeru a PHP knihovnách v projektu. Viz článek o nástroji Magallanes.

Podobně jsem se setkal a vyzkoušel řadu deploy nástrojů vyžadujících konfiguraci psanou v Ruby nebo Pythonu.

Přestože mnoho nástrojů, které jsem vyzkoušel, jsou robustní řešení, žádný mi moc nevyhovoval pro potřebu rychlého překopírování a nějakých vzdálených úprav u malého webu. Nechci nic přidávat do projektu jako takového, nechci se učit Ruby a nechci špinit PHP aplikaci nějakou konfigurací pro věc psanou v Pythonu.

Navíc se nechci přizpůsobovat nějakému univerzálnímu nástroji a vytvářet složitou konfiguraci jen proto, aby udělal zdánlivě jednoduchou věc, kterou potřebuji dle svých představ.

Nakonec jsem tedy využil toho, že v OS X je Bash, ve kterém si mohu vytvořit potřebný deploy skript zcela podle sebe a nepotřebuji k tomu přítomnost žádných dalších aplikací nebo knihoven v projektu.

Deploy skript pro Silex v shellu Bash

Jako základ jsem použil skript uvedený v návodu od Michaela Birche. Na začátku specifikuju lokální složku s projektem. Následuje ji cesta na vzdáleném serveru, ke kterému se má skript připojit. Další dva záznamy specifikují uživatelské jméno pro připojení na vzdálený server a adresu vzdáleného serveru.

Skript po spuštění zobrazí v terminálu datum a čas začátku kopírování a informaci o tom, co bude provádět. Poté je volán příkaz rsync s příslušnými atributy, který zajistí synchronizaci vzdálené složky s lokální kopií.

Jelikož v Silexu využívám cacheování, doplnil jsem příkaz pro smazání složky s cache na vzdáleném serveru.

Poté od sebe odečtu datum a čas začátku a konce operace a zobrazím celkovou délku jejího trvání. Celý záznam je rovněž umístěn do textového souboru, který může posloužit pro nějakou pozdější analýzu.

Volání rsync využívá seznam ze souboru rsync_exclude.txt, ve kterém mám uvedeny soubory a složky, které chci ze synchronizace vyloučit.

Tip: Návod pro Připojení k linuxovému serveru z Windows bez hesla.

Celý skript je zde:

#!/bin/bash
# create a file deploy_log.txt in LOCAL_DIR
# create a file rsync_exclude.txt in LOCAL_DIR
# configure the following
LOCAL_DIR="/Users/janpolzer/Sites/polzer/"
REMOTE_DIR="/var/www/honza/polzer.cz"
REMOTE_USER="honza"
REMOTE_IP="192.168.0.10"

start=`date +%s`

((
echo -e "\n"
echo -e "-----------------------------------\n"
echo "$(date)"
echo -e "\n"
echo 'rsync with production dir on web server'
rsync -acvzh  --exclude-from ${LOCAL_DIR}'rsync_exclude.txt' ${LOCAL_DIR} ${REMOTE_USER}@${REMOTE_IP}:${REMOTE_DIR}
echo 'clearing the cache'
ssh ${REMOTE_USER}@${REMOTE_IP} "rm -r ${REMOTE_DIR}/public/cache/*"
end=`date +%s`
runtime=$((end-start))
echo "Finished after $runtime seconds."
) 2>&1) | tee -a ${LOCAL_DIR}'deploy_log.txt'

Toto řešení mi přijde maximálně jednoduché a konfigurovatelné a nepotřebuji pro něj nic speciálního. Bash je prakticky na každém stroji s Linuxem i OS X a znalost skriptování patří k základní výbavě práce s Linuxem.

Výstup deploy skriptu v okně terminálu:

Jednoduše lze přidat také volání uglifyjs nebo třeba nějakého CSS preprocesoru, jak ukazuje původní návrh skriptu v odkazovaném článku. Do budoucna jím nahradím zřejmě i deploy skripty u aplikací v Symfony 2, pro které zatím využívám hpatoio/DeployBundle.