Liferay DXP Docker镜像文档

镜像概述和主要用途

Liferay DXP的***Docker镜像，基于Alpine的OpenJDK构建，用于快速部署和运行Liferay DXP企业门户系统。镜像包含30天试用许可，支持通过环境变量、文件系统映射及脚本实现灵活配置，适用于开发、测试及生产环境的Liferay DXP部署需求。

标签（Tags）

镜像标签遵循以下两种格式：

• {version}-{date}：version表示Liferay DXP版本号，date表示镜像创建日期。
• ${version}：始终指向同版本下最新的{version}-{date}标签。

注：DXP镜像包含30天试用许可，旧镜像会定期删除，新镜像将提供更新的30天试用许可。

运行（Running）

启动Liferay DXP需替换{tag}并执行以下命令：

bash
docker run -it -p 8080:8080 liferay/dxp:{tag}

示例（使用具体标签）：

bash
docker run -it -p 8080:8080 liferay/dxp:7.1.10-201809071129

参数说明：

• -it：允许通过CTRL-C停止容器；若未使用此参数，需通过docker kill {containerId}终止容器。
• -p 8080:8080：将容器的8080端口映射到主机8080端口，以便通过浏览器访问Liferay DXP。

环境变量（Environment Variables）

JVM参数调整

通过环境变量LIFERAY_JVM_OPTS可自定义JVM参数。

Liferay配置自定义

通过环境变量可映射portal.properties配置项，格式为LIFERAY_{配置项大写且点替换为PERIOD}。例如：

• 若需仅启用英语和葡萄牙语，可创建portal-ext.properties文件并添加locales.enabled=en_US,pt_BR
• 或直接设置环境变量：LIFERAY_LOCALES_PERIOD_ENABLED=en_US,pt_BR

所有可映射的环境变量可在portal.properties中搜索Env:查看。环境变量优先级高于portal.properties配置。

文件系统（File System）

Docker容器为临时性，重启后文件系统更改会丢失。可通过主机目录映射持久化配置：

启动容器时添加-v $(pwd)/xyz123:/mnt/liferay，将主机$(pwd)/xyz123目录映射到容器/mnt/liferay目录。主机$(pwd)/xyz123/files下的文件会在Liferay DXP启动前复制到/opt/liferay对应路径，实现配置覆盖。

示例（修改Tomcat的setenv.sh）：

1. 在主机创建路径$(pwd)/xyz123/files/tomcat/bin/setenv.sh并编辑内容
2. 启动容器后，该文件会自动覆盖/opt/liferay/tomcat/bin/setenv.sh

脚本（Scripts）

容器内/mnt/liferay/scripts目录下的所有脚本会在Liferay DXP启动前执行。在主机$(pwd)/xyz123/scripts目录放置脚本即可实现启动前自定义操作。

部署（Deploy）

在主机$(pwd)/xyz123/deploy目录下放置文件，可在运行时将模块部署到Liferay DXP。

关于（About）

镜像基于Alpine的OpenJDK构建。更多信息可查看Dockerfile：[***]

许可证（License）

• 查看镜像包含软件的许可信息：许可信息
• 本镜像可能包含其他软件（如基础发行版中的Bash等），这些软件可能有独立许可证。
• 镜像用户需自行确保对本镜像的使用符合其中所有软件的相关许可证要求。