dotCMS 开发镜像

镜像概述和主要用途

dotCMS开发镜像是专为dotCMS开发创建的Docker镜像，包含运行dotCMS所需的所有服务，包括Postgres 16和Opensearch 1.x。该镜像提供90天开发者许可证，支持运行dotCMS UVE所需的企业功能。所有dotCMS、数据库和ES索引数据均存储在/data目录，可通过映射实现环境持久化。其核心特性之一是能够克隆现有dotCMS实例。

核心功能和特性

• 一站式服务集成：内置dotCMS、Postgres 16和Opensearch 1.x，无需额外配置即可运行
• 持久化存储：数据存储于/data目录，支持卷映射实现数据持久化
• 环境克隆：可通过指定源环境和认证信息，拉取源环境的资产和数据库
• 开发者许可证：包含90天开发者许可证，启用企业功能
• 多版本支持：提供最新 nightly 版本和LTS版本（24.04、23.10）
• 调试支持：可启用调试模式，监听远程调试端口

使用场景和适用范围

• dotCMS应用开发和测试环境搭建
• 快速复现生产环境问题
• 学***和评估dotCMS功能
• 团队协作时共享一致的开发环境
• 从现有实例克隆环境进行二次开发

详细使用方法和配置说明

快速启动（TL;DR）

复制以下命令运行干净的dotCMS开发环境，所有数据和资产将存储在./data目录：

bash
docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
 dotcms/dotcms-dev:nightly

启动后，管理员密码将在日志输出中显示。可通过HTTPS在8443端口登录，本地运行时使用以下地址：
[***]

LTS版本镜像

我们为最新的2个LTS版本构建了开发镜像。注意：使用较新或latest镜像启动后，无法将数据降级到旧LTS版本（数据格式不保证向后兼容），此时应迁移./data目录并重新开始。从旧版本可升级到新版本或latest版本。

24.04

bash
docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
dotcms/dotcms-dev:24.04_lts

23.10

bash
docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
dotcms/dotcms-dev:23.10_lts

克隆现有环境

指定源环境和有效认证方式后，镜像将尝试从源环境拉取资产和数据库。

注意：要克隆的源环境必须运行版本等于或低于开发镜像的dotCMS。

启动镜像时传递DOTCMS_SOURCE_ENVIRONMENT以及DOTCMS_API_TOKEN或DOTCMS_USERNAME_PASSWORD（格式：***:admin）。启动过程中，镜像将连接指定的dotCMS实例，下载数据库和资产，加载并以调试模式启动dotCMS。服务器启动后，若从备份加载，可能需要执行全量重建索引（取决于dotCMS版本）。

使用API Token克隆

拉取资产和SQL备份并导入新实例。需使用目标环境的相同凭据登录：

bash
export TOK=XXXXXXX_YOUR_DOTCMS_TOKEN.eXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
-e DOTCMS_SOURCE_ENVIRONMENT=[***] \
-e DOTCMS_API_TOKEN=$TOK \
 dotcms/dotcms-dev:nightly

使用用户名/密码克隆

拉取资产和SQL备份并导入新实例。需使用目标环境的相同凭据登录：

bash
docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
-e DOTCMS_SOURCE_ENVIRONMENT=[***] \
-e DOTCMS_USERNAME_PASSWORD="***:admin" \
 dotcms/dotcms-dev:nightly

使用starter.zip克隆

请求源服务器生成starter.zip（初始导入可能耗时较长）：

bash
docker run --rm \
-p 8443:8443 \
-v $PWD/data:/data \
-e DOTCMS_SOURCE_ENVIRONMENT=[***] \
-e DOTCMS_USERNAME_PASSWORD="***:admin" \
-e DOTCMS_CLONE_TYPE=starter \
dotcms/dotcms-dev:nightly

开发调试模式（暴露Postgres端口）

dotCMS Java进程将等待调试器连接到8000端口：

bash
docker run --rm  \
--pull always \
-p 8443:8443 \
-p 5432:5432 \
-p 8000:8000 \
-v $PWD/data:/data \
-e DOTCMS_DEBUG=true \
 dotcms/dotcms-dev:nightly

配置环境变量

该镜像支持所有标准dotCMS Docker环境变量，数据库和ES已预配置，无需额外修改。此外支持以下特定环境变量：

• DOTCMS_SOURCE_ENVIRONMENT：要克隆的环境URL，例如[***]
• DOTCMS_CLONE_TYPE：克隆类型，可选dump或starter，默认dump。dump模式拉取数据库备份和资产（推荐用于大型站点）；starter模式强制生成starter.zip（较慢）
• DOTCMS_API_TOKEN：源环境管理员用户的有效dotCMS API令牌
• DOTCMS_USERNAME_PASSWORD：源环境管理员用户的用户名:密码（格式如***:admin）
• DOTCMS_DEBUG：是否以调试模式运行dotCMS并监听8000端口远程调试，默认false
• ALL_ASSETS：是否包含资产旧版本，默认false（仅下载当前活动和工作版本资产）

自定义证书

若需映射自定义证书，创建包含证书、私钥和CA链的.pem文件（密码设为dotcms），并映射到容器内路径/srv/dotserver/tomcat/conf/local.dotcms.site.pem以覆盖默认证书。

下载故障排除

由于Docker限制，下载大型环境可能超时。可手动下载资产和数据库并添加到映射的数据卷中，dotCMS启动时会自动导入/data/assets.zip和/或/data/dotcms_db.sql.gz。

手动下载资产和数据库

dotCMS提供管理员专用端点下载数据和资产：

• /api/v1/maintenance/_downloadAssets：下载资产
• /api/v1/maintenance/_downloadDb：下载数据库

下载资产时可指定?oldAssets=false仅包含活动和工作版本资产，减小文件大小。

示例wget命令下载资产

bash
wget --header="$AUTH_HEADER" \
-t 1 -O assets.zip  \
$DOTCMS_SOURCE_ENVIRONMENT/api/v1/maintenance/_downloadAssets

示例wget命令下载数据库

bash
wget --header="$AUTH_HEADER" \
-t 1 -O dotcms_db.sql.gz \
$DOTCMS_SOURCE_ENVIRONMENT/api/v1/maintenance/_downloadDb 

示例wget命令下载starter.zip

bash
wget --header="$AUTH_HEADER" \
-t 1 -O starter.zip \
$DOTCMS_SOURCE_ENVIRONMENT/api/v1/maintenance/_downloadStarterWithAssets

从零开始

删除映射的./data目录即可删除并重置开发实例。

构建镜像

默认从[***]dotcms/dotcms:latest基础镜像。可通过DOTCMS_DOCKER_TAG构建参数指定其他dotCMS版本，例如：

bash
docker build --pull \
--build-arg DOTCMS_DOCKER_TAG=testing  \
-t dotcms/dotcms-dev .

或构建多平台镜像：

bash
docker buildx build \
--build-arg DOTCMS_DOCKER_TAG=master_latest_SNAPSHOT \
--platform linux/amd64,linux/arm64 \
--pull \
-t dotcms/dotcms-dev:master_latest_SNAPSHOT .

内置数据库和Elasticsearch

镜像内部运行以下服务：

Opensearch 1.3.11

• HTTPS端口：9200
• 基本认证：admin/admin
• 数据存储路径：/data/opensearch

PostgreSQL 16（含pg_vector）

• 端口：5432
• 默认配置：
  • 数据库：dotcms
  • 用户：dotcmsdbuser
  • 密码：password
• 数据存储路径：/data/postgres

若需远程连接这些服务，启动容器时需暴露对应端口（如-p 5432:5432暴露PostgreSQL）。