Linux git 服务端部署钩子 hooks

封面图 • 2025-05-18 • git

在 Linux 上部署 Git 服务端时，可以通过使用 Git 的钩子（hooks）来实现各种自动化任务。钩子是在特定事件发生时触发的脚本，例如 `pre-receive`、`post-receive`、`update` 等。

以下是如何配置和使用 Git 钩子的步骤：

### 1. 创建 Git 仓库

首先，你需要创建一个 Git 仓库。假设你已经有一个 Git 仓库目录 `/path/to/repo.git`，并且它是裸仓库（bare repository）。

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

### 2. 进入 hooks 目录

Git 仓库的钩子脚本位于仓库目录下的 `hooks` 文件夹中。进入该文件夹：

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

### 3. 编写钩子脚本

Git 提供了许多钩子，其中一些常见的钩子包括：

- **`pre-receive`**: 在接收到新的提交之前执行。
- **`post-receive`**: 在接收到新的提交之后执行。
- **`update`**: 每次推送一个分支时执行。
- **`post-update`**: 在 `git push` 完成后执行。
- **`pre-rebase`**: 在执行 `git rebase` 之前执行。
- **`post-checkout`**: 在 `git checkout` 或 `git switch` 之后执行。

#### 示例：`post-receive` 钩子

假设你想在每次有人推送代码到服务器时自动将代码部署到某个目录。你可以编写一个 `post-receive` 脚本来完成这个任务。

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

```bash
nano post-receive
```

然后添加以下内容：

```bash
#!/bin/bash

# 定义工作目录
WORKING_DIR=/path/to/deploy

# 清理旧版本
rm -rf $WORKING_DIR/*

# 获取最新的代码
GIT_REPO=/path/to/repo.git
GIT_WORK_TREE=$WORKING_DIR git checkout -f

# 可选：安装依赖或运行构建命令
# npm install
# npm run build

echo "Deployment complete."
```

保存并退出编辑器。

### 4. 设置脚本可执行权限

确保钩子脚本是可执行的：

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

### 5. 测试钩子

现在你可以测试你的钩子是否正常工作。假设你在本地有一个 Git 仓库，并且你已经将远程设置为服务器上的仓库。

在本地仓库中进行更改并推送：

```bash
git add .
git commit -m "Test deployment"
git push origin master
```

如果一切正常，你应该会在服务器上看到 `post-receive` 脚本输出的信息。

### 6. 其他钩子示例

#### `pre-receive` 钩子

如果你想在接收代码之前检查某些条件（例如，防止某些特定的提交被推送到仓库），可以在 `pre-receive` 中添加逻辑。

```bash
#!/bin/bash

while read oldrev newrev refname; do
    # 检查某些条件
    if [[ "$refname" == "refs/heads/master" ]]; then
        echo "Master branch cannot be pushed directly."
        exit 1
    fi
done
```

#### `update` 钩子

`update` 钩子在每次推送一个分支时触发。你可以用它来限制哪些用户可以推送某些分支。

```bash
#!/bin/bash

branch="$2"
newrev="$3"

if [ "$branch" == "master" ]; then
    echo "Master branch is restricted."
    exit 1
fi

exit 0
```

### 总结

通过使用 Git 的钩子，你可以在不同的事件发生时自动执行脚本，从而实现自动化部署、验证代码、限制访问等功能。钩子脚本非常灵活，可以根据你的需求进行自定义。