Docker部署Pull：快速搭建私有同步服务的完整教程
项目地址: https://gitcode.com/gh_mirrors/pu/pull 想要自动化同步GitHub分叉仓库吗？Pull是一个强大的GitHub应用，能够通过自动化的Pull请求让你的分叉仓库与上游保持同步。本教程将带你快速搭建私有同步服务，让你轻松管理多个分叉项目。🚀
🔧 准备工作与环境配置
在开始部署之前，确保你的系统已安装Docker和Docker Compose。这是搭建私有同步服务的基础环境要求。
必备环境组件：
- Docker Engine (版本20.10+)
- Docker Compose (版本2.0+)
- 至少1GB可用内存
🐳 快速Docker部署步骤
第一步：克隆项目代码
git clone https://gitcode.com/gh_mirrors/pu/pull
cd pull
第二步：配置环境变量
创建.env文件，配置必要的GitHub应用参数：
# GitHub应用配置
APP_ID=你的GitHub应用ID
APP_NAME=你的应用名称
APP_SLUG=应用slug
WEBHOOK_SECRET=你的webhook密钥
PRIVATE_KEY=你的私钥内容
# 可选配置
PORT=3000
LOG_LEVEL=info
第三步：启动服务
使用Docker Compose一键启动所有服务：
docker-compose up -d
📊 服务架构与组件说明
Pull服务采用微服务架构设计，包含以下核心组件：
主要服务容器：
- app服务：主应用服务，监听端口3000
- worker服务：后台任务处理，支持水平扩展
- mongodb：数据存储服务
- redis：缓存和队列服务
核心配置文件：
- Dockerfile：定义应用容器镜像
- docker-compose.yml：编排所有服务
- deno.json：Deno运行时配置
⚙️ 高级配置与自定义
自定义同步规则
通过修改src/configs/app-config.ts来调整同步策略：
- 合并方法：支持merge、squash、rebase、hardreset
- 同步频率：可配置检查间隔
- 分支保护：遵循GitHub分支保护规则
工作器扩展配置
根据你的负载需求，可以轻松扩展worker服务：
docker compose up -d --scale worker=3
🔍 监控与维护
服务健康检查
- 访问
http://localhost:3000/health检查应用状态 - 使用Docker日志监控服务运行状况
手动同步触发
如果需要立即同步特定仓库，可以执行：
docker exec -it pull-app-1 deno task full-sync
💡 最佳实践建议
- 安全性优先：妥善保管私钥和webhook密钥
- 资源规划：根据仓库数量调整worker实例数
- 日志管理：定期检查日志文件排查问题
🚀 部署成功验证
部署完成后，你的私有同步服务已经就绪！现在可以：
- 配置GitHub应用指向你的服务地址
- 在目标仓库中安装Pull应用
- 享受自动化同步带来的便利
通过这个完整教程，你已经成功搭建了一个功能强大的GitHub分叉同步服务。Pull的Docker部署方案让运维变得简单高效，让你专注于代码开发而不是仓库维护。🎉
记住定期更新镜像以获取最新功能和安全修复，保持你的同步服务始终处于最佳状态！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
