shellspec/shellspec-scratch

ShellSpec Docker镜像

镜像概述和主要用途

ShellSpec是一个全功能的BDD（行为驱动开发）单元测试框架，专为shell脚本设计。这些Docker镜像旨在简化ShellSpec的运行流程，特别适合集成到持续集成(CI)系统中。镜像提供多种基础版本以适应不同需求，部分标签集成了Kcov工具用于代码覆盖率分析。

核心功能和特性

• 支持BDD风格的shell脚本单元测试，符合POSIX标准
• 提供三种基础镜像：轻量级Alpine、功能丰富的Debian和极简的Scratch
• 部分标签包含Kcov工具，支持生成代码覆盖率报告
• 多版本标签策略：包含最新发布版、开发主分支及特定版本号
• 自动化构建和测试，确保镜像质量

使用场景和适用范围

• shell脚本的单元测试与行为验证
• CI/CD流水线中的自动化测试环节
• 需要代码覆盖率分析的shell项目开发
• 对镜像大小有严格要求的环境（Scratch版本）
• 跨平台shell脚本兼容性测试

镜像版本和标签

Alpine基础镜像

!Docker Cloud Build Status !Docker Cloud Automated build !Docker Pulls

Docker Hub地址：https://hub.docker.com/r/shellspec/shellspec

可用标签：

• shellspec/shellspec:latest - 最新稳定发布版本
• shellspec/shellspec:kcov - 包含Kcov的最新稳定版本
• shellspec/shellspec:master - 开发主分支版本
• shellspec/shellspec:master-kcov - 包含Kcov的开发主分支版本
• shellspec/shellspec:[VERSION] - 特定版本（如shellspec/shellspec:0.28.1）
• shellspec/shellspec:[VERSION]-kcov - 包含Kcov的特定版本

Debian基础镜像

!Docker Cloud Build Status !Docker Cloud Automated build !Docker Pulls

Docker Hub地址：https://hub.docker.com/r/shellspec/shellspec-debian

可用标签：

• shellspec/shellspec-debian:latest - 最新稳定发布版本
• shellspec/shellspec-debian:kcov - 包含Kcov的最新稳定版本
• shellspec/shellspec-debian:master - 开发主分支版本
• shellspec/shellspec-debian:master-kcov - 包含Kcov的开发主分支版本
• shellspec/shellspec-debian:[VERSION] - 特定版本
• shellspec/shellspec-debian:[VERSION]-kcov - 包含Kcov的特定版本

Scratch基础镜像

!Docker Cloud Build Status !Docker Cloud Automated build !Docker Pulls

Docker Hub地址：https://hub.docker.com/r/shellspec/shellspec-scratch

可用标签（无Kcov版本）：

• shellspec/shellspec-scratch:latest - 最新稳定发布版本
• shellspec/shellspec-scratch:master - 开发主分支版本
• shellspec/shellspec-scratch:[VERSION] - 特定版本

使用方法和配置说明

基本测试运行

将包含shell脚本和测试文件的工作目录挂载到容器的/work目录，执行shellspec命令：

bash
# 使用Alpine基础镜像
docker run --rm -v "$(pwd):/work" shellspec/shellspec

# 使用Debian基础镜像
docker run --rm -v "$(pwd):/work" shellspec/shellspec-debian

# 使用Scratch基础镜像
docker run --rm -v "$(pwd):/work" shellspec/shellspec-scratch

生成代码覆盖率报告

使用带kcov标签的镜像，通过--kcov参数生成覆盖率报告：

bash
# 生成覆盖率报告到当前目录的coverage文件夹
docker run --rm -v "$(pwd):/work" shellspec/shellspec:kcov shellspec --kcov=coverage

# 查看报告（本地浏览器打开coverage/index.html）

CI集成示例（GitLab CI）

在.gitlab-ci.yml中配置：

yaml
shellspec-test:
  image: shellspec/shellspec:latest
  stage: test
  script:
    - shellspec
  artifacts:
    paths:
      - coverage/  # 若使用kcov标签

自定义测试命令

可传递额外参数给shellspec命令：

bash
# 运行特定测试文件
docker run --rm -v "$(pwd):/work" shellspec/shellspec shellspec spec/my_script_spec.sh

# 启用详细输出
docker run --rm -v "$(pwd):/work" shellspec/shellspec shellspec -v