techangels/bats

Bats Docker镜像

概述

本Docker镜像嵌入了https://github.com/sstephenson/bats%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AAbash%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E7%8E%AF%E5%A2%83%E6%9D%A5%E8%BF%90%E8%A1%8C%E5%92%8C%E6%B5%8B%E8%AF%95bash%E8%84%9A%E6%9C%AC%E3%80%82%E9%80%9A%E8%BF%87%E8%AF%A5%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E6%88%B7%E5%8F%AF%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2Bats%E6%B5%8B%E8%AF%95%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%97%A0%E9%9C%80%E5%9C%A8%E6%9C%AC%E5%9C%B0%E7%B3%BB%E7%BB%9F%E4%B8%AD%E5%8D%95%E7%8B%AC%E5%AE%89%E8%A3%85%E4%BE%9D%E8%B5%96%E3%80%82

核心功能和特性

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

使用场景和适用范围

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

使用方法和配置说明

基本使用

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

bash
docker run \
  -v $(PWD):/app \
  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 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版本信息。