physitrack/ci-rubocop Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

ci-rubocop 镜像文档

镜像概述

ci-rubocop是一个独立的Docker镜像，集成了rubocop（Ruby代码静态分析工具）、pronto（轻量级代码审查工具）及pronto-rubocop（pronto的rubocop插件）。该镜像从主仓库提取，专为在CI环境或本地开发环境中通过命令行执行代码质量检查而设计。

核心功能与特性

• 集成rubocop：提供Ruby代码风格和质量的静态分析，支持自定义规则配置
• 包含pronto：轻量级代码审查工具，可针对代码变更（如提交或分支差异）进行增量检查
• pronto-rubocop插件：将rubocop分析能力集成到pronto中，实现针对性的代码质量反馈
• 独立运行：无需额外安装依赖，可直接在命令行环境使用

使用场景

• CI/CD流程：在持续集成过程中自动检查代码风格和质量，确保合并前代码符合规范
• 本地开发：开发人员在提交代码前进行本地检查，提前发现并修复代码风格问题
• 代码审查辅助：针对特定分支或提交的代码变更进行定向分析，提高审查效率

使用方法

本地开发环境使用

基础rubocop检查

挂载代码目录并运行完整的rubocop分析：

bash
docker run --rm -v $(pwd):/app ci-rubocop rubocop /app

使用pronto检查代码变更

检查当前分支与main分支的差异：

bash
docker run --rm -v $(pwd):/app \
  -v ~/.ssh:/root/.ssh \  # 挂载SSH密钥（如需访问私有仓库）
  ci-rubocop pronto run origin/main --exit-code

CI环境配置示例

GitLab CI配置

在.gitlab-ci.yml中添加代码质量检查阶段：

yaml
code_quality:
  image: ci-rubocop
  script:
    - pronto run origin/main --exit-code
  only:
    - merge_requests
    - main

GitHub Actions配置

创建.github/workflows/rubocop.yml：

yaml
name: Rubocop Check
on: [pull_request, push]

jobs:
  rubocop:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run rubocop via ci-rubocop
        uses: docker://ci-rubocop
        with:
          args: pronto run origin/${{ github.base_ref }} --exit-code

注意事项

• 确保挂载的代码目录具有正确的读写权限，避免因权限问题导致文件访问失败
• 使用pronto时，需确保容器内可访问Git仓库（可通过挂载SSH密钥或配置HTTPS凭证实现）
• 可通过在代码目录中添加.rubocop.yml文件自定义rubocop规则
• --exit-code参数使pronto在发现问题时返回非零退出码，便于CI流程中断