sirech/dind-ruby

包含Ruby的Docker-in-Docker(DinD)镜像文档

镜像概述

概述

本镜像为Docker-in-Docker(DinD)镜像，已预装Ruby运行环境，专为CI/CD场景设计，提供在隔离容器环境中运行Docker命令和Ruby工具的能力。

主要用途

核心用于在CI/CD流水线中执行ServerSpec测试。ServerSpec是基于Ruby的服务器配置测试框架，需Ruby环境支持；而Docker-in-Docker特性则允许在容器内构建、运行和测试其他Docker容器，满足自动化测试对容器化环境的依赖需求。

核心功能和特性

• Docker-in-Docker支持：内置Docker守护进程，可在容器内部直接运行docker build、docker run等Docker命令，无需依赖宿主机Docker环境。
• 预装Ruby环境：集成Ruby运行时，可直接使用gem管理Ruby包，无需额外配置Ruby开发环境，简化ServerSpec等Ruby工具的使用流程。

使用场景和适用范围

使用场景

• CI/CD流程中的服务器配置验证：通过ServerSpec测试目标服务器或容器的配置项（如服务状态、文件权限、端口监听、软件版本等）。
• 容器化应用的集成测试：在CI/CD中利用DinD特性构建应用镜像，并运行容器进行集成测试。

适用范围

• 采用基础设施即代码(IaC)或配置管理工具（如Ansible、Chef）的团队，需自动化验证配置效果。
• 开发或运维团队在CI/CD流水线中需结合Docker和Ruby工具链进行测试或构建任务。

使用方法和配置说明

基本运行要求

运行本镜像需满足：

• 宿主机已安装Docker引擎。
• 运行容器时必须添加--privileged标志，以确保Docker-in-Docker所需的系统权限。

Docker运行示例

bash
# 后台运行DinD容器
docker run --privileged -d --name dind-ruby-test sirech/dind-ruby

# 进入容器验证环境
docker exec -it dind-ruby-test /bin/bash
# 在容器内验证Docker和Ruby环境
docker --version  # 检查Docker版本
ruby --version    # 检查Ruby版本
gem --version     # 检查gem版本

CI/CD环境集成示例（GitHub Actions）

在.github/workflows/test.yml中配置：

yaml
name: ServerSpec Test
on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Run ServerSpec with dind-ruby
        uses: docker/setup-qemu-action@v3
        with:
          image: sirech/dind-ruby
          options: --privileged
        run: |
          gem install serverspec  # 安装ServerSpec（如镜像未预装）
          rspec spec/  # 执行测试用例

注意事项

• 安全风险：--privileged标志会赋予容器较高系统权限，建议仅在可信环境中使用，避免运行未知或不受信代码。
• 数据持久化：容器内Docker数据默认存储在容器生命周期内，若需持久化镜像或容器数据，可通过挂载卷实现：

  bash
  docker run --privileged -d -v /path/on/host:/var/lib/docker sirech/dind-ruby
  

• 版本兼容性：使用前建议通过项目源码仓库确认镜像支持的Docker和Ruby版本，避免版本冲突。

相关资源

• 项目源码及详细说明：https://github.com/sirech/dind-ruby
• ServerSpec官方文档：[***]