pebbletech/git-deploy
pebbletech
自动构建
基于Git钩子的部署策略镜像，用于对环境变量变更、服务管理、服务器配置等常见部署任务进行版本控制，支持多环境管理与自动化部署。
3 次收藏下载次数: 0状态：自动构建维护者：pebbletech仓库类型：镜像最近更新：9 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Git-Deploy
基于Git钩子的部署策略，旨在将版本控制引入环境变量变更、服务管理、服务器配置等常见部署任务。
服务器依赖
- Docker 1.5+
- Systemd 218+
配置步骤
- 配置环境文件
bashcp git-deploy/sample.env git-deploy.env vim git-deploy.env
选项说明：
| Key | 用途 |
|---|---|
| DEST | Duplicity备份目标地址，参考Duplicity文档 |
| PASSPHRASE | 用于通过GPG对称加密/解密备份 |
| HOOK_REPO | 外部Git仓库，钩子将从中获取；若未定义，则从每个仓库的'hooks'文件夹获取 |
| HOOK_REPO_VERIFY | 若为'true'，则hook_repo必须由本地GPG密钥环中信任的密钥签名 |
| AWS_ACCESS_KEY_ID | 若使用AWS S3作为DEST则需要此密钥 |
| AWS_SECRET_ACCESS_KEY | 同上 |
- 在CI服务器上运行git-deploy Docker镜像
bashcp git-deploy/git-deploy.service . systemctl enable $PWD/git-deploy.service systemctl start git-deploy
- 添加所需公钥
SSH：
bashdocker exec -it git-deploy sh -c "curl https://github.com/someuser.keys >> .ssh/authorized_keys"
GPG：
bashdocker exec -it git-deploy bash gpg --recv-keys E90A401336C8AAA9 gpg --edit-key E90A401336C8AAA9 gpg> trust gpg> save
- 为部署服务器可管理的每个环境设置Git-Deploy仓库
bashssh git@ci.someserver.com mkrepo staging.git
使用方法
- 克隆目标环境的git-deploy仓库
git clone git@ci.someserver.com:staging.git deploy
- 设置应用环境变量、部署细节和服务
cd deploy/apps/some-app vim some-app.env vim some-app@.service vim some-app-helper@@.service vim some-app-helper.env vim config.yml
- 创建共享环境变量（可选）
vim deploy/global.env
- 调整Git钩子（可选）
vim deploy/hooks/post-receive
- 部署应用
git add . git commit -m 'Added some-app' git push staging master
变更将通过定义的Git钩子反映在目标环境中。
查看SSH日志
可通过覆盖特定日志路径（如/var/log/secure）查看SSH日志，调整git-deploy.service如下：
bashExecStart=/usr/bin/docker run \ -p 22:2222 \ --env-file="/home/core/git-deploy.env" \ -e SSH_LOG_FILE=/var/log/secure \ -v /var/log/secure:/var/log/secure \ -v /etc/hosts.deny:/etc/hosts.deny \ --name="git-deploy" \ pebble/git-deploy
这允许读取并处理日志，例如用DenyHosts拒绝特定主机。
调试
若需手动调试仓库钩子，可将/git卷挂载到debian容器：
bashdocker run -ti --volumes-from=git-deploy debian bash vim /git/somerepo.git/.git/hooks/post-receive
测试
运行测试需满足：
- 安装https://github.com/sstephenson/bats
- 开放2222端口
- ~/.ssh有有效SSH公钥
运行测试：
bats test/test.bats
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 git-deploy 镜像标签
docker pull docker.xuanyuan.run/pebbletech/git-deploy:<标签>
DockerHub 原生拉取命令
docker pull pebbletech/git-deploy:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"