byterazor/drone-gitlab-badge

drone-gitlab-badge镜像说明

镜像概述

本镜像为Drone CI的插件，用于通过GitLab API更新GitLab项目的徽章。支持amd64和arm64架构，可无缝集成到Drone CI流水线，自动维护项目的状态徽章（如构建状态、测试覆盖率等）。

核心功能

• 通过GitLab API更新指定项目的徽章信息
• 支持自定义徽章名称、图片URL及跳转链接
• 适配Drone CI环境，可嵌入CI/CD流程实现自动化更新

使用场景

• Drone CI流水线完成构建/测试后，自动更新GitLab项目的构建状态徽章
• 展示项目关键指标（代码质量、覆盖率）徽章，提升项目透明度
• 批量维护多个GitLab项目的徽章信息

配置说明

需设置以下环境变量：

• GITLAB_URL：GitLab服务器地址（如[***]
• GITLAB_TOKEN：GitLab私有令牌（需具备项目徽章修改权限）
• GITLAB_PROJECT：项目完整路径（如namespace/project）
• BADGE_NAME：徽章唯一标识名称
• BADGE_IMAGE_URL：徽章图片URL（推荐使用shields.io生成）
• BADGE_URL：徽章点击跳转的目标URL

部署示例

Drone CI流水线配置

在.drone.yml中添加插件步骤：

yaml
steps:
- name: update-gitlab-badge
  image: byterazor/drone-gitlab-badge
  environment:
    GITLAB_URL: https://gitlab.example.com
    GITLAB_TOKEN:
      from_secret: gitlab_token
    GITLAB_PROJECT: my-team/my-project
    BADGE_NAME: build-status
    BADGE_IMAGE_URL: https://img.shields.io/badge/build-passing-brightgreen
    BADGE_URL: https://drone.example.com/my-team/my-project

直接运行Docker容器

bash
docker run --rm \
  -e GITLAB_URL=https://gitlab.example.com \
  -e GITLAB_TOKEN=your_private_token \
  -e GITLAB_PROJECT=my-team/my-project \
  -e BADGE_NAME=coverage \
  -e BADGE_IMAGE_URL=https://img.shields.io/badge/coverage-95%25-green \
  -e BADGE_URL=https://sonarqube.example.com/dashboard?id=my-project \
  byterazor/drone-gitlab-badge

注意：本镜像为早期版本，建议测试后再用于生产环境，作者不保证稳定性。