fixl/anybadge Docker 镜像 - 轩辕镜像

anybadge 镜像

一个包含 anybadge 的 Docker 容器，可与 3 Musketeers 配合使用。

镜像概述和主要用途

本镜像封装了 anybadge 工具，旨在提供便捷的徽章生成能力，特别适用于 CI/CD 流水线环境。通过容器化方式消除环境依赖，确保在不同系统中生成徽章的一致性，可无缝集成 3 Musketeers 工作流。

核心功能和特性

• 内置 anybadge 工具，支持生成自定义 SVG 格式徽章
• 容器化设计，无需本地安装 anybadge 依赖
• 支持挂载本地目录，直接将生成的徽章保存到宿主环境
• 提供辅助脚本，扩展镜像管理能力

使用场景和适用范围

• CI/CD 流水线中生成状态徽章（如测试覆盖率、构建结果、版本信息等）
• 自动化文档或项目 README 中动态生成可视化指标徽章
• 与 3 Musketeers 工具链结合，实现跨平台一致的开发/部署流程

使用方法和配置说明

构建镜像

bash
make build

检查镜像标签

查看镜像的配置标签信息：

bash
docker inspect --format='{{ range $k, $v := .Config.Labels }}{{ printf "%s=%s\n" $k $v}}{{ end }}' anybadge:latest

生成徽章

基本命令格式，将当前目录挂载到容器内 /src 目录，生成徽章并保存到本地：

bash
docker run --rm -v ${PWD}:/src anybadge \
    anybadge --value=$score --file=<badgeName>.svg <badgeLabel>

• $score: 徽章显示的数值（如百分比、版本号等）
• <badgeName>.svg: 输出的 SVG 徽章文件名
• <badgeLabel>: 徽章左侧显示的标签文本

额外脚本

docker-size

创建显示 Docker 镜像压缩大小和内部层信息的标签。

此脚本需与 Docker 引擎交互，可能需要挂载 Docker 套接字（如 -v /var/run/docker.sock:/var/run/docker.sock）。

docker-version

从传入的镜像标签推导版本号（例如 myimage:v1.2.3 推导出 1.2.3），不验证镜像是否实际存在。