plugins/codecov

drone-codecov

镜像概述

drone-codecov是Drone CI的官方插件，用于在CI/CD流程中集成Codecov代码覆盖率分析平台。该镜像由https://github.com/drone-plugins/drone-codecov%E9%A1%B9%E7%9B%AE%E7%BB%B4%E6%8A%A4%EF%BC%8C%E9%80%9A%E8%BF%87Drone CI自动构建和推送。其核心功能是将项目构建过程中生成的代码覆盖率报告自动上传至Codecov，实现代码覆盖率的可视化分析与监控。

核心功能与特性

• 无缝集成Drone CI：作为Drone CI的原生插件，可直接在Drone流水线配置中使用
• 自动报告上传：支持将各类测试框架生成的覆盖率报告（如Cobertura、JaCoCo、lcov等）上传至Codecov
• 轻量级设计：基于精简基础镜像构建，资源占用低，执行效率高
• 官方维护：由Drone插件团队维护，确保与Drone CI和Codecov平台的兼容性

使用场景

• 持续集成流程中代码覆盖率自动分析
• 多语言项目（如Java、Python、JavaScript等）的覆盖率报告上传
• 代码质量门禁控制，基于覆盖率指标进行构建结果判断
• 团队协作中的代码质量监控与改进

使用方法与配置说明

在Drone CI中配置

在Drone流水线配置文件（.drone.yml）中添加如下步骤：

yaml
steps:
- name: codecov
  image: plugins/codecov
  settings:
    token:
      from_secret: codecov_token  # Codecov仓库令牌，建议通过Drone Secrets管理
    file: ./coverage.xml  # 覆盖率报告文件路径，支持通配符（如./coverage/*.xml）
    fail_ci_if_error: true  # 上传失败时是否标记CI为失败（可选，默认false）
    verbose: false  # 是否启用详细日志输出（可选，默认false）

配置参数说明

环境变量支持

除上述配置参数外，插件还支持通过环境变量进行配置：

• CODECOV_TOKEN：等同于token配置参数
• CODECOV_FILE：等同于file配置参数
• CODECOV_FAIL_ON_ERROR：等同于fail_ci_if_error配置参数
• CODECOV_VERBOSE：等同于verbose配置参数

本地测试（Docker Run）

如需本地测试插件功能，可使用以下Docker命令：

bash
docker run --rm \
  -e DRONE_REPO=your/repo \
  -e DRONE_COMMIT_SHA=abc123 \
  -e DRONE_BRANCH=main \
  -e CODECOV_TOKEN=your-codecov-token \
  -v $(pwd):/drone/src \
  plugins/codecov \
  --file ./coverage.xml

说明：

• -v $(pwd):/drone/src 将当前目录挂载到容器内的工作目录
• DRONE_* 环境变量模拟Drone CI提供的运行时信息
• --file 指定覆盖率报告文件路径