Docker-in-Docker (DinD) for Bitbucket Pipelines 镜像文档

一、镜像概述

本镜像是专为 Bitbucket Pipelines 环境设计的 Docker-in-Docker (DinD) 解决方案，通过集成 Tini init 进程管理 Docker 守护进程（dockerd），确保在 CI/CD 流程中稳定运行 Docker 服务。其核心目标是为 Bitbucket Pipelines 提供轻量、可靠的 Docker 运行环境，支持镜像构建、容器测试等依赖 Docker 的自动化流程。

二、核心功能与特性

2.1 核心功能

• Bitbucket Pipelines 原生支持：无缝集成 Bitbucket Pipelines 环境，可直接在 Pipeline 步骤中执行 docker 命令。
• Docker 守护进程管理：内置 Docker 守护进程，支持镜像拉取、构建、容器运行等完整 Docker 功能。
• Tini 进程管理：采用 Tini 作为 init 进程，负责：
  • 处理僵尸进程（避免资源泄漏）；
  • 信号转发（确保 Docker 守护进程正确响应 SIGTERM 等终止信号）；
  • 进程生命周期管理（保障 Docker 服务稳定启动/停止）。

2.2 特性

• 轻量级设计：基于*** DinD 镜像优化，减少冗余依赖，适合 CI/CD 资源受限环境。
• CI/CD 场景优化：默认配置适配流水线短生命周期特性，缩短启动时间。
• 兼容性保障：与 Bitbucket Pipelines 环境（包括代理、网络配置）深度兼容。

三、使用场景与适用范围

3.1 典型场景

• Bitbucket Pipelines 镜像构建：在 Pipeline 中直接构建 Docker 镜像（如应用镜像、工具镜像）。
• 容器化应用测试：启动 Docker 容器运行应用，执行集成测试、功能测试。
• 多阶段构建流程：通过 Docker 实现编译、打包、部署等多阶段任务串联。
• Docker 依赖工具链：支持需要 Docker 环境的工具（如 docker-compose、ctop 等）运行。

3.2 适用范围

• Bitbucket Cloud/Server 环境的 Pipelines 流水线；
• 依赖 Docker 引擎的 CI/CD 自动化流程；
• 需要隔离 Docker 环境的多步骤 Pipeline 任务。

四、使用方法与配置说明

4.1 前置条件

• Bitbucket 仓库已启用 Pipelines 功能；
• 流水线配置需开启特权模式（Privileged Mode）（运行 Docker 守护进程必需）。

4.2 Bitbucket Pipelines 配置示例

在 bitbucket-pipelines.yml 中引用本镜像，并配置 Docker 相关操作：

yaml
image: <镜像名称>:<标签>  # 替换为实际镜像名称（如 your-org/bitbucket-dind-tini:latest）

pipelines:
  default:
    - step:
        name: 构建并测试 Docker 镜像
        services:
          - docker  # 若需额外依赖，可添加（本镜像已内置 Docker 守护进程，通常无需此配置）
        script:
          - echo "启动 Docker 守护进程（镜像内置自动启动）"
          - docker --version  # 验证 Docker 环境
          - docker build -t my-app:${BITBUCKET_COMMIT} .  # 构建应用镜像
          - docker run --rm my-app:${BITBUCKET_COMMIT} npm test  # 运行容器内测试
        # 启用特权模式（必需）
        privileged: true

4.3 独立运行示例（非 Pipelines 环境）

若需在本地或其他环境测试，可通过 docker run 命令启动：

bash
docker run -d \
  --privileged \  # 必需：Docker 守护进程需要特权模式
  --name bitbucket-dind \
  -e DOCKER_TLS_CERTDIR="" \  # 禁用 TLS（CI 环境通常无需加密）
  -e DOCKER_OPTS="--log-level=info" \  # 传递额外参数给 dockerd
  <镜像名称>:<标签>

五、环境变量配置

六、注意事项

1. 特权模式要求：运行本镜像必须启用特权模式（privileged: true in Pipelines，--privileged in docker run），否则 Docker 守护进程无法启动。
2. 资源限制：CI 环境中建议为流水线步骤分配至少 2GB 内存（Docker 构建/运行可能消耗较多资源）。
3. 安全风险：特权模式可能带来安全风险，仅在可信代码仓库中使用。
4. Tini 信号处理：若需自定义进程终止逻辑，可通过 TINI_KILL_PROCESS_GROUP 调整信号传播行为。
5. 镜像清理：CI 流程结束后，Docker 守护进程会随流水线步骤终止，无需手动清理容器/镜像（但可通过 docker system prune 优化中间层镜像占用）。

七、版本信息与维护

• 基础镜像：基于*** docker:dind 镜像构建，同步*** Docker 版本更新。
• Tini 版本：集成最新稳定版 Tini（≥ v0.19.0）。
• 更新策略：跟随 Docker *** DinD 镜像及 Tini 版本定期更新，确保兼容性与安全性。