rancher/docker-dind-base 镜像文档

1. 镜像概述和主要用途

rancher/docker-dind-base 是一个基于 jpetazzo/dind 构建的 Docker-in-Docker (DinD) 镜像模板，旨在提供容器内嵌套运行 Docker 引擎的能力。通过该镜像，用户可在容器内部署并运行独立的 Docker 环境，实现"容器中运行 Docker"的场景需求。

2. 核心功能和特性

• Docker 嵌套运行支持：允许在容器内部启动和管理 Docker 引擎，实现容器内嵌套 Docker 环境。
• 基于成熟基础镜像：构建于 jpetazzo/dind 镜像之上，继承其 DinD 核心功能与稳定性。
• 环境初始化工具：提供 wrapdocker 脚本（路径：/usr/local/bin/wrapdocker），用于容器内 Docker 环境的自动配置与初始化。
• 特权模式依赖：需以特权模式（--privileged）运行，确保容器内 Docker 引擎能正常访问宿主机内核资源。

3. 使用场景和适用范围

• CI/CD 流水线：在持续集成/持续部署流程中，需在容器内构建、测试或运行其他 Docker 容器的场景（如容器镜像构建、多阶段部署验证）。
• 隔离开发环境：为开发或测试提供独立的 Docker 环境，避免干扰宿主机 Docker 配置。
• Docker 功能测试：用于验证 Docker 引擎在不同环境下的行为，或测试 Docker 相关工具/脚本。

4. 使用方法和配置说明

4.1 基本运行要求

• 必须使用特权模式：容器必须以特权模式（--privileged）启动，否则容器内 Docker 引擎无法正常访问宿主机设备和内核功能（如 cgroups、命名空间等）。
• Docker 环境依赖：宿主机需已安装 Docker 引擎，且版本兼容（推荐使用与基础镜像 jpetazzo/dind 兼容的 Docker 版本）。

4.2 部署示例

4.2.1 基本运行命令

直接启动容器并运行内置 Docker 引擎：

bash
docker run --privileged rancher/docker-dind-base

4.2.2 自定义启动命令

若需在启动时执行自定义命令（如运行脚本、启动服务等），必须先执行 wrapdocker 工具初始化 Docker 环境，再执行自定义命令。示例：

bash
# 启动容器并执行自定义命令（先初始化 Docker 环境，再运行 bash）
docker run --privileged rancher/docker-dind-base sh -c "/usr/local/bin/wrapdocker && bash"

说明：wrapdocker 脚本用于配置容器内 Docker 引擎所需的环境变量、挂载点及权限，是容器内 Docker 正常工作的前置条件。

4.3 关键配置参数

5. 问题反馈与支持

如遇使用问题（如 bug、功能建议、配置疑问等），请通过 GitHub Issues 反馈，标题需以 [docker-dind-base] 开头。具体操作：

• 直接创建 Issue：点击此处
• 或访问仓库：rancherio/rancher

6. 许可证信息

版权所有 © 2014-2015 Rancher Labs, Inc.

本镜像基于 Apache License 2.0 许可证开源。您可在 [***] 获取许可证完整文本。

除非***要求或书面同意，软件按"原样"分发，不提供任何明示或暗示的担保（包括但不限于适销性、特定用途适用性的担保）。详情参见许可证文本。