WebDevOps Toolbox Docker镜像文档

镜像概述

WebDevOps Toolbox是一个集成多种Web开发和运维常用工具的Docker镜像，旨在简化开发、构建和部署流程。该镜像汇集了各类实用工具，可直接用于多阶段构建、CI/CD流水线、开发环境调试等场景，避免重复安装工具带来的复杂性。

核心功能和特性

• 全面的工具集成：包含构建工具（npm、yarn、composer、maven）、网络工具（curl、wget、dig、tcpdump）、系统工具（git、make、tar、gzip）、容器工具（docker-client、docker-compose）等
• 轻量级设计：基于精简基础镜像，在提供丰富工具的同时保持较小体积
• 即开即用：无需额外配置，直接运行即可使用所有工具
• 多场景适配：兼容多阶段构建、CI/CD环境、本地开发调试等多种使用场景

使用场景和适用范围

• 多阶段Docker构建：作为临时构建阶段，使用工具完成代码拉取、依赖安装、编译打包等操作，避免在最终镜像中包含冗余工具
• CI/CD流程集成：在Jenkins、GitLab CI等CI/CD平台中作为执行环境，提供统一的工具链支持
• 开发环境工具集：本地开发时快速获取完整工具环境，无需在主机系统安装多种依赖
• 运维调试：临时启动容器进行网络诊断、日志分析、文件处理等运维操作

使用方法和配置说明

基本使用

通过以下命令启动交互式终端，直接使用镜像中的工具：

bash
docker run --rm -it webdevops/toolbox:latest

多阶段构建示例

在Dockerfile中作为构建阶段使用，完成构建后仅将产物复制到最终镜像：

dockerfile
# 构建阶段：使用toolbox镜像安装依赖并编译
FROM webdevops/toolbox:latest AS builder
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install  # 使用镜像内置的npm工具
COPY . .
RUN npm run build  # 执行编译命令

# 最终阶段：仅包含运行时依赖
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

常用工具列表

镜像包含以下主要工具类别（非完整列表）：

• 构建工具：npm, yarn, pnpm, composer, maven, gradle, go
• 网络工具：curl, wget, httpie, jq, dig, nslookup, tcpdump, netcat
• 系统工具：git, ssh, rsync, make, gcc, g++, tar, gzip, bzip2, zip
• 容器工具：docker-client, docker-compose, kubectl (部分标签)
• 版本控制：git, svn, mercurial

数据持久化与挂载

如需使用主机文件或持久化数据，可通过挂载目录实现：

bash
# 挂载当前目录到容器内/app，使用工具处理本地文件
docker run --rm -it -v $(pwd):/app webdevops/toolbox:latest sh -c "cd /app && git status"

配置参数

该镜像通常无需额外配置参数，所有工具均通过环境变量或默认配置运行。如需自定义工具行为，可通过命令行参数或挂载配置文件实现（如.npmrc、.gitconfig等）。