git利用post-receive自动化部署

封面图 • 2025-09-21 • git

使用 `git` 的 `post-receive` 钩子实现自动化部署是一种常见的做法，尤其适用于在服务器上自动更新代码。以下是详细的步骤和示例。

---

## ✅ 一、准备工作

1. **确保 Git 已安装**  
   在你的服务器上安装 Git：

```bash
   sudo apt-get install git  # Debian/Ubuntu
   sudo yum install git      # CentOS/RHEL
   ```

2. **创建一个用于部署的仓库（远程仓库）**  
   这个仓库可以是裸仓库（bare repository），只用于接收推送，不包含工作目录。

```bash
   mkdir /path/to/repo.git
   cd /path/to/repo.git
   git init --bare
   ```

3. **在本地开发机器上添加远程仓库**  
   假设你的远程仓库地址为 `ssh://user@server:/path/to/repo.git`

```bash
   git remote add deploy ssh://user@server:/path/to/repo.git
   ```

---

## ✅ 二、配置 post-receive 钩子

进入你创建的裸仓库目录下的 `hooks` 文件夹：

```bash
cd /path/to/repo.git/hooks
```

创建或编辑 `post-receive` 文件：

```bash
nano post-receive
```

### 🧾 示例脚本（post-receive）

```bash
#!/bin/bash
# 自动部署脚本

# 指定部署目录
DEPLOY_DIR="/var/www/myapp"

# 切换到部署目录
cd $DEPLOY_DIR || exit

# 拉取最新代码（注意：这里不能用 git pull，因为裸仓库没有工作区）
# 所以我们使用 git reset 来重置工作区
git reset --hard HEAD

# 如果需要运行构建命令（如 npm install, composer install 等）
# 可以在这里添加
npm install
npm run build

# 如果有其他操作（如重启服务）
# systemctl restart nginx
```

保存并退出后，赋予执行权限：

```bash
chmod +x post-receive
```

---

## ✅ 三、测试部署

从本地推送代码到远程仓库：

```bash
git push deploy main
```

如果一切正常，服务器上的 `/var/www/myapp` 目录会自动更新为最新的代码。

---

## ✅ 四、常见问题与注意事项

### 🔧 1. 权限问题
确保 `post-receive` 脚本有执行权限，并且部署目录对运行该脚本的用户可写。

### 🧪 2. 使用非 bare 仓库
如果你不想用裸仓库，也可以在普通仓库中使用 `post-receive`，但要注意不要在工作目录中直接 `git pull`，因为这可能引发冲突。

### 📦 3. 构建工具
如果项目需要编译（如 Vue、React、Laravel 等），可以在 `post-receive` 中添加构建命令。

### 🛡️ 4. 安全性
- 不要将敏感信息（如密码）写入脚本。
- 使用 SSH 密钥认证，避免明文密码。
- 限制推送权限（如通过 `gitolite` 或 `gitlab` 控制访问）。

---

## ✅ 五、进阶建议

- 使用 **CI/CD 工具**（如 GitHub Actions、GitLab CI、Jenkins）替代手动脚本。
- 使用 **Docker** 或 **容器化部署** 提高一致性。
- 使用 **环境变量** 来管理不同环境（如 dev、prod）的配置。

---

如果你需要我帮你生成一个适合你项目的具体 `post-receive` 脚本，欢迎提供更多信息（比如项目类型、部署路径、构建命令等）。