如何用Docker私有化部署pep8speaksPEP 8审查机器人自建完整教程私有仓库也能用【免费下载链接】pep8speaksA GitHub :octocat: app to automatically review Python code style over Pull Requests项目地址: https://gitcode.com/gh_mirrors/pe/pep8speakspep8speaks是一款开源的 PEP 8 代码风格审查机器人以 GitHub App 的形式在 Pull Request 上自动检查 Python 代码规范并把结果汇总成一条持续更新的评论。如果你只想在公开仓库里用直接安装官方 App 即可但私有仓库需要自己私有化部署。本教程用 Docker 带你从零搭好这台 PEP 8 审查机器人全程约 10 分钟私有仓库也能用。为什么要用 Docker 私有化部署 解锁私有仓库官方 App 只面向公开仓库自建部署后机器人可以审查你所有私有仓库的 PR资源占用极轻512 MB 内存 1 核 CPU 的入门级服务器就能跑官方实例正是这个配置可稳定处理约 100 次请求/分钟全容器化交付镜像由 Dockerfile 基于 Python 3.8 Alpine uv Gunicorn 构建默认监听 8000 端口docker-compose一条命令启动、一条命令更新。部署前准备服务器与核心文件一览你需要一台 Linux 服务器Ubuntu 22.04 可直接用以下命令装好 Docker 全家桶apt update apt install -y docker.io apt install -y docker-compose部署涉及的关键文件如下建议先通读一遍文件作用Dockerfile构建容器镜像暴露 8000 端口Gunicorn 4 workerdocker-compose.yml容器编排端口映射、环境变量注入、崩溃自动重启.env.sample环境变量模板复制为.env后填入真实值DEPLOYMENT-GUIDE.md官方部署指南硬件要求与操作步骤三步完成 pep8speaks 服务启动第 1 步获取项目git clone https://gitcode.com/gh_mirrors/pe/pep8speaks cd pep8speaks cp .env.sample .env第 2 步填写环境变量.env里共 6 个变量含义一目了然变量说明APP_SECRET_KEYFlask 会话密钥App 创建时生成的签名密钥GITHUB_TOKEN机器人访问 API 的 TokenGITHUB_APP_WEBHOOK_SECRETWebhook 签名校验密钥必须与 GitHub App 中设置一致LOG_LEVEL日志级别生产环境建议INFOFLASK_DEBUG生产环境请设为0BOT_USERNAME机器人评论名默认pep8speaks第 3 步启动并检查健康状态docker-compose up -d # 后台启动容器 docker-compose ps # 查看容器状态 docker-compose logs -f --tail 100 # 跟踪最近 100 行日志端口默认 8000如需修改在docker-compose.yml中设置SERVICE_PORT即可。容器配置了restart: always掉线后会自动拉起。对接 GitHubWebhook 配置要点 服务起来后还差最后一步对接 GitHub创建你自己的 GitHub App在Webhook设置中将 URL 指向你的服务器域名例如https://pep8.example.com/根路径即可将Webhook secret填为.env里的GITHUB_APP_WEBHOOK_SECRET值域名需指向服务器 IP 并配置好 HTTPS——Webhook 只接受安全通道。server.py 会校验签名把pull_request、issue_comment、installation等事件分发给 pep8speaks/handlers.py 中对应的处理函数签名不符的请求会被直接拒绝并记录日志。定制审查规则.pep8speaks.yml 配置指南 ⚙️每个被审查的仓库都可在根目录放一个.pep8speaks.yml常用选项scanner.linter选择pycodestyle或flake8作为检查器max-line-length、ignore、exclude行宽上限、忽略规则、排除路径diff_only: True只扫描 PR 改动的代码更快更聚焦no_blank_comment: True无错误时不评论避免刷屏message自定义机器人评论的开头、结尾文案。内置默认值见 data/default_pep8speaks.yml仓库内配置优先覆盖默认值。常见问题速答问私有仓库到底能不能用能。这正是私有化部署的核心价值——App 拿到私有仓库权限后PR 提交即自动触发 PEP 8 检查。问512 MB 内存够吗官方线上实例就是 512 MB / 1 核配置跑日常中小团队完全够用。问机器人不评论了怎么排查先看docker-compose logs -f若日志出现Received an unauthorized request说明 Webhook secret 两边不一致核对.env与 GitHub App 设置即可。部署完成后在任意仓库的 PR 上 机器人还能让它suggest diff生成修复建议或pep8ify直接提交一个 autopep8 自动修复 PR。至此你的私有仓库也拥有了一位 7×24 小时在线的代码风格审查员 ✅【免费下载链接】pep8speaksA GitHub :octocat: app to automatically review Python code style over Pull Requests项目地址: https://gitcode.com/gh_mirrors/pe/pep8speaks创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考