livingdocs/editor-base

Livingdocs Editor 测试与构建镜像

镜像概述

该Docker镜像专为Livingdocs Editor的测试和构建流程设计，提供一致、隔离的环境，简化开发者在测试和构建Livingdocs Editor时的环境配置工作。镜像内置构建和测试所需的依赖工具与运行时环境，确保在不同平台和环境中获得一致的构建结果。

核心功能与特性

• 一致的构建环境：预配置Livingdocs Editor构建所需的依赖（如Node.js、npm/yarn、构建工具等），避免环境差异导致的构建问题
• 集成测试支持：包含测试框架和依赖，可直接运行单元测试、集成测试等验证流程
• 简化开发流程：无需手动安装配置依赖，拉取镜像即可快速启动测试和构建流程
• 跨平台兼容：支持Linux、macOS、Windows等Docker兼容平台，确保开发、测试和CI/CD环境一致性

使用场景与适用范围

• 本地开发测试：开发者本地开发时快速搭建测试环境，验证代码变更
• CI/CD自动化构建：集成到CI/CD流水线（如Jenkins、GitHub Actions），实现自动化构建与测试
• 团队协作：统一团队开发环境，减少"环境不一致"导致的协作问题
• 版本发布构建：标准化发布流程，确保发布包在不同环境中构建结果一致

使用方法与配置说明

基础使用（docker run）

bash
# 拉取镜像（假设镜像名为livingdocs/editor-builder）
docker pull livingdocs/editor-builder

# 运行镜像并挂载项目目录执行构建
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  livingdocs/editor-builder \
  npm run build

# 运行测试命令
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  livingdocs/editor-builder \
  npm run test

环境变量配置

高级使用（docker-compose配置）

yaml
version: '3'
services:
  editor-builder:
    image: livingdocs/editor-builder
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - NODE_ENV=production
      - BUILD_OUTPUT_DIR=/app/build
    command: npm run build

注意事项

• 使用前需安装Docker Engine（推荐版本20.10+）
• 挂载本地项目目录时确保目录有正确读写权限
• 大型项目建议使用Docker卷（Volume）提升文件操作性能
• 自定义构建/测试命令可通过覆盖command字段实现