alpine/bruno

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://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环境时：

bash
docker run -ti --rm -v "$(pwd)/collections":/apps -w /apps 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将使用默认配置运行集合：

bash
docker run -ti --rm -v "$(pwd)/collections":/apps -w /apps 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完整命令说明：

bash
docker run -ti --rm alpine/bruno --help

镜像构建流程

1. 启用CI定时任务（每周）在主分支定期触发构建
2. 构建并推送latest标签镜像至DockerHub
3. 本地运行最新镜像获取应用版本号
4. 使用版本号为镜像打标签
5. 通过https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md%E6%8E%A8%E9%80%81%E7%89%88%E6%9C%AC%E6%A0%87%E7%AD%BE%E9%95%9C%E5%83%8F