spaceplanwizard/dev Docker 镜像 - 轩辕镜像

开发与CI专用Docker镜像文档

镜像概述

本Docker镜像专为开发环境搭建和持续集成(CI)流程设计，旨在提供统一、高效的工具链支持。通过预配置开发所需的核心工具和CI流程依赖，帮助开发者快速搭建一致的本地开发环境，并无缝集成到各类CI/CD流水线中，有效解决环境差异导致的问题，提升开发与交付效率。

核心功能与特性

1. 全面的开发工具集

• 预安装主流编程语言编译器/解释器（如Python、Java、Node.js、Go等）
• 集成常用构建工具（Maven、Gradle、npm、yarn、make等）
• 包含版本控制工具（Git、SVN）及代码质量检测工具（ESLint、Pylint、Checkstyle等）

2. CI流程深度支持

• 与主流CI/CD平台兼容（GitHub Actions、GitLab CI、Jenkins、CircleCI等）
• 内置CI流程优化工具（缓存管理、并行任务支持、测试报告生成器）
• 支持多阶段构建，可直接用于CI流水线中的代码编译、测试、打包环节

3. 环境一致性保障

• 标准化基础镜像，确保开发、测试、CI环境配置统一
• 隔离式环境设计，避免本地工具版本冲突
• 支持自定义配置扩展，满足特定项目需求

4. 轻量级与高效性

• 基于Alpine或Debian Slim等轻量级基础镜像构建，优化镜像体积
• 分层缓存设计，加速CI流程中的镜像拉取与构建
• 精简非必要依赖，提升容器启动与运行效率

使用场景与适用范围

1. 本地开发环境

• 快速搭建项目开发环境，无需手动安装配置依赖
• 多项目并行开发时，隔离不同项目的工具链版本
• 新手开发者快速上手，降低环境配置门槛

2. CI/CD流水线集成

• 作为CI流程中的构建/测试环境容器，执行代码编译、单元测试、集成测试
• 与自动化部署流程衔接，完成应用打包与镜像构建
• 支持跨平台CI流程（Linux、macOS、Windows容器环境）

3. 多团队协作支持

• 统一团队开发规范，确保所有成员使用一致的工具版本
• 简化跨团队项目的环境同步流程
• 支持远程开发环境（如通过Docker+VS Code Remote开发）

使用方法与配置说明

基本使用

拉取镜像

bash
docker pull [镜像仓库地址]/dev-ci-image:latest

本地开发环境启动

bash
# 挂载当前项目目录到容器内/app，启动交互式终端
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像仓库地址]/dev-ci-image:latest \
  /bin/bash

CI流程集成示例（GitHub Actions）

在.github/workflows/ci.yml中添加：

yaml
jobs:
  build-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run build and test in dev-ci container
        uses: docker://[镜像仓库地址]/dev-ci-image:latest
        with:
          args: /bin/sh -c "npm install && npm run test && npm run build"

配置参数说明

环境变量

数据卷挂载

• 推荐挂载项目代码目录：-v $(pwd):/app（映射本地代码到容器工作目录）
• 工具缓存目录挂载（CI优化）：-v ci-tool-cache:/tmp/tool-cache（复用工具缓存，加速后续构建）

自定义配置扩展

如需添加项目特定工具或配置，可基于本镜像构建自定义镜像：

dockerfile
FROM [镜像仓库地址]/dev-ci-image:latest

# 安装项目特定依赖
RUN apt-get update && apt-get install -y [额外工具]

# 配置自定义环境变量
ENV CUSTOM_VAR=value

# 设置工作目录
WORKDIR /custom-app

注意事项

• 本地开发时，确保当前用户对挂载目录有读写权限
• CI流程中建议配合缓存机制（如GitHub Actions Cache、GitLab CI Cache）使用工具缓存目录，提升构建效率
• 如需使用GPU加速或特定系统资源，需在docker run时添加相应参数（如--gpus all）
• 定期更新镜像版本，以获取最新工具和安全补丁

版本信息

• 最新稳定版：latest
• 长期支持版：lts
• 工具版本特定标签：如python-3.11-node-18（指定Python 3.11和Node.js 18环境）