Bruno - Git友好的开源API客户端,支持API集合的版本控制,以Docker镜像形式提供基于Alpine的轻量CLI环境。
Bruno Docker镜像文档
镜像概述和主要用途
本镜像为Bruno CLI的Docker化部署版本,基于Alpine Linux构建,集成Node.js运行环境,提供轻量级API客户端工具。Bruno是一款Git友好的开源API客户端,核心功能为API集合的版本控制,支持在开发和测试流程中管理API请求集合。镜像会在Bruno CLI发布新版本时自动触发构建,确保用户获取最新功能。
核心功能和特性
- Git友好:原生支持API集合的版本控制,便于通过Git追踪API请求历史和团队协作
- 开源免费:遵循开源协议,可自由使用和定制功能
- 轻量高效:基于Alpine Linux构建,镜像体积小,资源占用低
- CLI支持:提供完整的命令行接口,支持批量运行API集合和指定环境
- 自动构建:监听Bruno官方版本更新,自动触发Docker镜像构建流程
- 多架构支持:适配多种硬件架构(具体架构可查看镜像标签)
使用场景和适用范围
- 开发环境中运行和测试API请求集合
- 版本控制API测试用例,确保API变更可追溯
- 集成到CI/CD流程,自动化执行API测试
- 团队共享API集合,保持请求配置一致性
镜像信息
DockerHub地址
GitHub仓库
https://github.com/alpine-docker/multi-arch-docker-images/tree/master/bruno
CI构建日志
Docker镜像统一构建流水线:
https://app.circleci.com/pipelines/github/alpine-docker/multi-arch-libs
镜像详情列表:
https://github.com/alpine-docker/multi-arch-libs/tree/master#image-details
镜像标签
所有可用标签请查看:https://hub.docker.com/r/alpine/bruno/tags/
使用方法和配置说明
前提条件
本地需存在Bruno API集合文件夹(如collections),典型文件结构示例:
collections/ ├── environments/ │ ├── dev.bru │ └── prod.bru ├── bruno.json ├── google.bru └── {JSON} Placeholder.bru
示例1:指定环境运行API集合
当API集合位于当前目录的collections文件夹,且需使用dev环境时:
bashdocker run -ti --rm -v "$(pwd)/collections":/apps -w /apps docker.xuanyuan.run/alpine/bruno run --env=dev
运行结果示例:
Running Folder Recursively {JSON} Placeholder (200 OK) - 149 ms google.com (200 OK) - 239 ms variables (200 OK) - 670 ms Requests: 3 passed, 3 total Tests: 0 passed, 0 total Assertions: 0 passed, 0 total
示例2:不指定环境运行API集合
未指定环境时,Bruno将使用默认配置运行集合:
bashdocker run -ti --rm -v "$(pwd)/collections":/apps -w /apps docker.xuanyuan.run/alpine/bruno run
运行结果示例:
Running Folder Recursively google (200 OK) - 417 ms {JSON} Placeholder (200 OK) - 71 ms host as variable (getaddrinfo ENOTFOUND {{host}}) Requests: 2 passed, 1 failed, 3 total Tests: 0 passed, 0 total Assertions: 0 passed, 0 total
查看帮助信息
获取Bruno CLI完整命令说明:
bashdocker run -ti --rm docker.xuanyuan.run/alpine/bruno --help
镜像构建流程
- 启用CI定时任务(每周)在主分支定期触发构建
- 构建并推送
latest标签镜像至DockerHub - 本地运行最新镜像获取应用版本号
- 使用版本号为镜像打标签
- 通过https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md推送版本标签镜像
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/bruno:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务