使用git hooks(post-receive)实现简单的远程自动部署 - Git/Svn

如何使用命令行在本地自动部署到远程服务器？这里我们使用git的post-receive来简单实现.

本文实现的前提是：web端代码与git远程服务器不在同一台机器（如web代码放在腾讯云，git服务使用的github)

git介绍

git服务器端有仓库，我们称之为远程仓库。
git clone下来的，我们称之为本地仓库
git commit的时候，是把代码提交到本地仓库
git push的时候，是把代码从本地上传到远程仓库
git pull的时候，是把代码从远程仓库下载到本地

git自动部署原理

1.git服务端有一个远程仓库
2.开发者电脑上有一个clone下来的本地仓库，用于开发代码
3.web服务器也有一个clone下来的本地仓库，网站展示的内容就在此目录

自动部署的过程就是：从开发者电脑的本地仓库提交到远程仓库的时候，web服务器端的本地仓库自动更新远程仓库的代码。

实现自动部署

git post-receive机制：这个hook是git服务器在受到push请求时，并且接受完代码提交时触发

1、clone两个本地版本

在开发者本机打开git bash

// 开发者电脑上的本地版本
cd /d/project/
git clone git@github.com:username/imqianduan.git imqianduan

登录web服务器，安装 git，假设web目录在/data下

// WEB服务器端的本地版本
cd /data
git clone git@github.com:username/imqianduan.git imqianduan

2、在web服务器端初始化一个Git 裸仓库 (git init –bare)

在/data目录下创建imqianduan-bare.git

cd /data
// imqianduan-bare.git是一个目录，习惯带`.git`后缀这样命名而已
git init --bare imqianduan-bare.git
// 注意：bare仓库不能复制已经有的，新的项目都需要新建(init)

3、设置hooks，配置post-receive

上一步我们创建了imqianduan-bare.git目录，进入此目录的hooks目录
hooks目录下会有很多.sample文件，这些是一些示例文件（不起作用的，起作用的不带.sample后缀）

-rwxr-xr-x 1 root root  452 Jun  5 15:35 applypatch-msg.sample
-rwxr-xr-x 1 root root  896 Jun  5 15:35 commit-msg.sample
-rwxr-xr-x 1 root root  189 Jun  5 15:35 post-update.sample
-rwxr-xr-x 1 root root  398 Jun  5 15:35 pre-applypatch.sample
-rwxr-xr-x 1 root root 1704 Jun  5 15:35 pre-commit.sample
-rwxr-xr-x 1 root root 1239 Jun  5 15:35 prepare-commit-msg.sample
-rw-r--r-- 1 root root 1348 Jun  5 15:35 pre-push.sample
-rwxr-xr-x 1 root root 4951 Jun  5 15:35 pre-rebase.sample
-rwxr-xr-x 1 root root 3611 Jun  5 15:35 update.sample

发现没有post-receive.sample示例文件，我们需要创建一个post-receive

cd imqianduan-bare.git/hooks/
// post-receive文件是没有任何文件名后缀的
// 创建
touch post-receive
// 编辑
vim post-receiv

post-receive粘贴下面的代码，echo输出的内容最终会在开发者电脑端打印出来

#!/bin/sh
#判断是不是远端仓库
IS_BARE=$(git rev-parse --is-bare-repository)
if [ -z "$IS_BARE" ]; then
echo >&2 "fatal: post-receive: IS_NOT_BARE"
exit 1
fi
echo "deploy start================================================"
unset GIT_DIR
# 填写第一步，web服务器上的本地仓库目录
DeployPath="/data/imqianduan"
cd $DeployPath
echo "deploying web: www.imqianduan.com"
git fetch --all
git reset --hard origin/master
echo "deploy end ================================================"

post-receive必须有可执行权限

cd imqianduan-bare.git
chmod +x hooks/post-receive

4、在开发者本地仓库添加远程bare地址

查看一下远程源地址

$ git remote
origin

origin已经存在，就不能再添加origin，我们改名为deploy

// root：web服务器用户名
// x.x.x.x: web服务器的IP
git remote add deploy ssh://root@x.x.x.x/data/imqianduan-bare.git

再次使用git remote查看，会发现多了一个deploy

$ git remote
deploy
origin

提交测试

按顺序，我们必须先git push到远程git服务器后，执行git push deploy才可以拿到本地提交的最新代码。所以我们也可以多次git push到远程git服务器后，再统一git push deploy下载到web服务器端部署

注意：

root@x.x.x.x's password:是要求输入web服务器的root用户名的密码

$ git push && git push deploy
Counting objects: 2, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (2/2), 253 bytes | 253.00 KiB/s, done.
Total 2 (delta 1), reused 0 (delta 0)
remote: Resolving deltas: 100% (1/1)
remote: Processing changes: done
remote: Updating references: 100% (1/1)
To git@github.com:username/imqianduan.git
   e091df4..b9b0084  master -> master
root@x.x.x.x's password:
Counting objects: 2, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (2/2), 253 bytes | 253.00 KiB/s, done.
Total 2 (delta 1), reused 0 (delta 0)
remote: deploy start================================================
remote: deploying web: www.imqianduan.com
remote: Fetching origin
remote: From git@github.com:username/imqianduan.git
remote:    e091df4..b9b0084  master     -> origin/master
remote: HEAD is now at b9b0084 test5
remote: deploy end ================================================
To ssh://x.x.x.x/data/imqianduan-bare.git
   e091df4..b9b0084  master -> master

问题

如果报如下错误，请检查git remote add deply 远程地址的远程地址是否正确

fatal: '/data/imqianduan-bare.git' does not appear to be a git repository
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

检查权限问题
检测post-receive是否有语法错误

如复制的时候，linux下很容易漏了第一个字母，导致变量报错