dotcms/dotcms-seed

镜像概述

dotCMS builder seed镜像为dotCMS项目提供构建基础环境，包含项目所需的源代码结构和预配置的Gradle依赖。该镜像旨在简化dotCMS项目的初始化构建流程，作为项目开发、编译和打包的起点，减少环境配置复杂度。

核心功能和特性### 1. 预配置构建环境

• 内置Gradle运行环境及相关依赖库，无需手动安装配置
• 包含dotCMS项目构建所需的基础插件和工具链

2. 标准源代码结构

• 预设dotCMS项目的标准目录结构（如src/main、src/test等）
• 包含基础配置文件，确保项目符合dotCMS开发规范

3. 简化构建流程

• 作为构建种子，可直接基于镜像启动构建任务，减少初始化步骤
• 支持与常见构建工具链集成，提升开发效率

使用场景和适用范围### 1. dotCMS项目初始化

• 新项目启动时，作为基础模板快速搭建构建环境
• 确保团队开发环境一致性，避免"环境不一致"问题

2. 开发环境搭建

• 开发者可直接基于镜像启动本地开发环境，专注业务逻辑开发
• 支持热重载（需配合项目配置），加速开发迭代

3. CI/CD流程集成

• 作为自动化构建流程的基础镜像，用于持续集成、测试和部署
• 适配主流CI工具（如Jenkins、GitLab CI等）

使用方法和配置说明### 基本使用（docker run命令）

通过挂载本地项目目录并指定Gradle任务执行构建：

bash
docker run -v $(pwd):/app dotcms-builder-seed gradle <task-name>

参数说明：

• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录（覆盖默认源代码）
• <task-name>：指定Gradle任务（如build、clean、test等）

常用配置选项#### 1. 环境变量

2. 自定义构建示例

指定Gradle任务并调整内存配置：

bash
docker run -e GRADLE_OPTS="-Xmx1024m" -v $(pwd):/app dotcms-builder-seed gradle clean build

docker-compose配置示例

如需与其他服务（如数据库）联动构建，可使用docker-compose.yml：

yaml
version: '3.8'
services:
  builder:
    image: dotcms-builder-seed
    volumes:
      - ./my-dotcms-project:/app
    environment:
      - GRADLE_OPTS="-Xmx1024m"
      - GRADLE_TASK="clean build test"
    depends_on:
      - db  # 假设有依赖的数据库服务
  db:
    image: postgres:13
    environment:
      - POSTGRES_DB=dotcms_test

注意事项

• 本地项目目录挂载会覆盖容器内默认源代码，建议首次使用时先基于默认结构初始化项目
• 构建产物默认输出至容器内/app/build目录，需通过挂载目录获取到本地
• 如需自定义Gradle配置，可在项目目录中添加build.gradle或settings.gradle文件覆盖默认配置