git hooks deploy (nodejs)

deploy(部屬) 是個 production 的必經階段，該怎樣做的方便又穩定是個重要的關鍵，先來談談一般 web server deploy (以 nodejs 為例，這邊暫時不談 server side 架構)

(假設使用 bitbucket host git repo)

1. 把 local source code push (本地端原碼推到) bitbucket
2. ssh 連到 web server
3. git pull 想要的版本
4. npm install（更新 package）
5. restart node process (重起線程)

以上的步驟看起來其實也不難，ssh 連到 web server 的步驟也可以使用 key 的方式來減少輸入密碼步驟，進入後需要進行的東做也不是很難，但總是要問自己一下 "還能不能更好？"，立馬想到先前使用些 saas 的經驗，如 heroku, openshift, nodejitsu ... 等，使用方式非常簡單，只需要把 code push 上 saas server，就自動可以跑起來，這種感覺真的太棒了！以 heroku 為例，會要求你在原本的 local repo 加入一個 remote 的位置(如下)，之後想要 deploy 只要 `git push heroku master` 就可以丟上 heroku 並自動重起。

git add remote heroku GIT_REPO_URL

想要自己實作這段就必須使用 git hooks，以 bitbucket 為例(下圖)，可在 repo 設定收到 push 後要執行哪些指令，bitbucket 很貼心的與很多不同的 service 合作，讓 hooks 更方便(一般常見的 git host 都有實作，不論是 github, gitlab...等都有)。


這段收到 push 後必須執行哪些指令的行為就是 git hooks 的 post-receive，收到 push 後想要執行哪些指令，pust-receive 為 bash script，所以可以方變得跟各種 cmd 整合，基本上可以將最上面的步驟 3, 4, 5 整合，pull 想要的版本、更新package、重起 node process，但還是缺少了最重要的東西，git 要 push 到哪？

首先建立一個 git repo 並且使用 bare

	#!/bin/sh
	# go to home
	cd $HOME
	# 先隨便叫他 deploy.git 並放在 user 個人的資料夾下
	git init --bare "$HOME/deploy.git"
	# 把 .sample 拿掉，這樣 hooks 才會執行到
	mv "$HOME/deploy.git/hooks/post-receive.sample" "$HOME/deploy.git/hooks/post-receive"
	# 修改 post-receive 權限
	chmod +x "$HOME/deploy.git/hooks/post-receive"

view raw server-setup.sh hosted with ❤ by GitHub

接著更新 $HOME/deploy.git/hooks/post-receive（範例中使用 forever 來管理 node process，亦可使用 nodeman, pm2 等來管理）

	#!/bin/sh
	echo "Deploy beign"
	# 設定 nodejs 環境（如果是用 nvm 管理 nodejs 才需要）
	. "$HOME/.nvm/nvm.sh"
	# 設定 project 路徑
	export PROJECT_DIR=$HOME/PROJECT
	# 轉移到 project folder
	cd $PROJECT_DIR
	unset GIT_DIR
	# 更新最新版的 code （此部份可以依照專案來決定，在這邊只是因為方便所以直接更新最新版）
	git pull origin master
	# 更新 npm package
	npm install
	# 重起 nodejs process （這邊使用 forever 管理 node process，依照專案使用方式來調整）
	"$PROJECT_DIR/node_modules/forever/bin/forever" restartall
	echo ""
	echo "Deploy success"
	echo ""

view raw post-receive.sh hosted with ❤ by GitHub

最後就是在開發的 repo 中加入 remote 路徑，ssh user, ip 就與 ssh 登入是相同的

git remote add production SSH_USER@SSH_IP:~/deploy.git

完成後 deploy 就與 heroku, nodejitsu, openshift 一樣只要下指令就自動完成 deploy 所有流程（更新最新版 source code，更新 node package，重啟 nodejs process）

git push production master

相關連結
heroku
openshift
nodejitsu
bitbucket
github
gitlab
git hooks
forever
nodeman
pm2