techangels/bats

Bats Docker镜像

概述

本Docker镜像嵌入了https://github.com/sstephenson/bats——一个bash测试框架，旨在提供便捷的环境来运行和测试bash脚本。通过该镜像，用户可快速部署Bats测试环境，无需在本地系统中单独安装依赖。

核心功能和特性

• 内置Bats框架：镜像已预安装Bats，可直接用于执行bash单元测试
• 测试文件挂载：支持将本地测试文件或目录挂载到容器中运行
• Docker客户端集成：包含Docker客户端，允许在容器内执行与Docker相关的测试
• 轻量级设计：简化的镜像结构，便于快速启动和集成到CI/CD流程

使用场景和适用范围

• bash脚本开发中的单元测试验证
• CI/CD流水线中集成bash脚本自动化测试
• 需要隔离环境的bash测试场景
• Docker相关bash脚本的测试（如容器构建、运行验证等）

使用方法和配置说明

基本使用

将本地测试目录挂载到容器中，执行测试：

bash
docker run \
  -v $(PWD):/app \
  docker.xuanyuan.run/techangels/bats \
    /app/my-tests

参数说明：

• -v $(PWD):/app：将当前工作目录挂载到容器内的/app目录
• techangels/bats：镜像名称
• /app/my-tests：容器内测试文件或目录的路径

在容器内使用Docker

由于镜像包含Docker客户端，可在容器内执行Docker相关测试。需挂载Docker套接字并配置环境变量：

bash
docker run -t \
  -v $PWD:/app \
  -v /var/run/docker.sock:/docker.sock \
  -e DOCKER_HOST="unix:///docker.sock" \
  --rm docker.xuanyuan.run/techangels/bats /app/tests

参数说明：

• -v /var/run/docker.sock:/docker.sock：挂载Docker套接字，使容器内Docker客户端能与主机Docker引擎通信
• -e DOCKER_HOST="unix:///docker.sock"：设置Docker主机地址环境变量

测试脚本示例

以下是一个验证Bats版本的测试脚本示例：

bash
#!/usr/bin/env bats

@test "无命令/参数时，镜像返回Bats版本" {
  run bash -c 'docker run -it --rm techangels/bats:${VERSION} | grep "Bats" | grep "Bats 0.4.0"'
  [ "$status" -eq 0 ]
}

说明：该脚本使用Bats的@test注解定义测试用例，通过run命令执行Docker命令，并验证输出中是否包含预期的Bats版本信息。