ibaiborodine/liferay-portal-ce

该项目已停止维护

支持的标签及对应的Dockerfile链接

• https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/be1b780d9b121d6040102576a03744909549ad58/7.4.3.23-ga23/jdk11-bullseye/Dockerfile
• https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/8431ff48eb92f75e1de1f8a05892ee6efc831cb1/7.4.3.23-ga23/jdk8-bullseye/Dockerfile
• https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/5e5e6958b34048d96c641354b9c3c6f9371f6704/7.4.3.23-ga23/jdk8-alpine/Dockerfile

历史支持标签的Dockerfile链接可查看https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/master/readme/previously-supported-tags.md%E3%80%82

快速参考

• 获取帮助: Liferay社区论坛、https://forums.docker.com/%E3%80%81https://blog.docker.com/2016/11/introducing-docker-community-directory-docker-community-slack/%E6%88%96https://stackoverflow.com/search?tab=newest&q=docker
• 提交问题: https://github.com/igor-baiborodine/docker-liferay-portal-ce/issues
• 维护者: https://github.com/igor-baiborodine
• 支持架构: amd64（https://github.com/docker-library/official-images#architectures-other-than-amd64%EF%BC%89
• 描述来源: https://github.com/igor-baiborodine/docker-liferay-portal-ce/tree/master/readme
• 支持的Docker版本: https://github.com/docker/docker-ce/releases/latest%EF%BC%88%E5%90%91%E4%B8%8B%E5%85%BC%E5%AE%B9%E8%87%B31.6%E7%89%88%E6%9C%AC%EF%BC%8C%E5%B0%BD%E5%8A%9B%E6%94%AF%E6%8C%81%EF%BC%89

什么是Liferay Portal？

Liferay Portal是一个开源门户框架，用于构建Web应用、网站和门户，同时提供集成CMS功能，可作为企业集成平台使用。
[***]

!https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/master/readme/logo.png?raw=true
Logo © Liferay, Inc.

如何使用该镜像

启动liferay-portal实例

console
$ docker run --name <容器名称> -d ibaiborodine/liferay-portal-ce:<标签>

其中<容器名称>是你为容器分配的名称，<标签>指定所需的Liferay Portal CE版本。请参考上述标签列表选择合适的标签。

默认配置包含嵌入式Hypersonic数据库和Elasticsearch实例，请注意此设置不适用于生产环境。

你可以通过浏览器访问http://容器IP:8080测试。获取容器IP地址的命令：

console
$ docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' <容器名称>

或通过主机端口80访问：

console
$ docker run --name <容器名称> -p 80:8080 -d ibaiborodine/liferay-portal-ce:<标签>

然后在浏览器中访问http://localhost:80或http://主机IP:80。

若需以调试模式启动实例：

console
$ docker run --name <容器名称> -d ibaiborodine/liferay-portal-ce:<标签> catalina.sh jpda run

通过docker-compose启动

liferay-portal的docker-compose.yml示例：

yaml
version: '3.7'

services:
  liferay:
    image: docker.xuanyuan.run/ibaiborodine/liferay-portal-ce
    environment:
      LIFERAY_SETUP_PERIOD_WIZARD_PERIOD_ENABLED: "false"
      LIFERAY_TERMS_PERIOD_OF_PERIOD_USE_PERIOD_REQUIRED: "false"
      LIFERAY_USERS_PERIOD_REMINDER_PERIOD_QUERIES_PERIOD_ENABLED: "false"
      LIFERAY_USERS_PERIOD_REMINDER_PERIOD_QUERIES_PERIOD_CUSTOM_PERIOD_QUESTION_PERIOD_ENABLED: "false"
    ports:
      - "80:8080"

执行docker-compose -f docker-compose.yml up，等待初始化完成后，访问http://localhost:80或http://主机IP:80。

更多docker-compose示例：https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/master/compose/liferay-mysql/docker-compose.yml%E3%80%81https://github.com/igor-baiborodine/docker-liferay-portal-ce/blob/master/compose/liferay-mysql-elasticsearch/docker-compose.yml

查看Tomcat版本信息

console
$ docker run --rm -it ibaiborodine/liferay-portal-ce:<标签> version.sh | grep 'Server version' 

容器Shell访问与日志查看

使用docker exec命令可在容器内执行命令。以下命令将进入liferay-portal容器的bash shell：

console
$ docker exec -it <容器名称> bash

通过docker logs命令查看Liferay Portal日志：

console
$ docker logs -f <容器名称>

通过环境变量配置Liferay Portal

你可以通过环境变量覆盖https://github.com/liferay/liferay-portal/blob/master/portal-impl/src/portal.properties%E4%B8%AD%E7%9A%84%E9%85%8D%E7%BD%AE%EF%BC%8C%E4%BE%8B%E5%A6%82%EF%BC%9A

properties
#
# 首次启动门户时是否显示设置向导
#
# 环境变量：LIFERAY_SETUP_PERIOD_WIZARD_PERIOD_ENABLED
#
setup.wizard.enabled=true

要覆盖setup.wizard.enabled属性，启动容器时设置环境变量LIFERAY_SETUP_PERIOD_WIZARD_PERIOD_ENABLED为false：

console
$ docker run --name <容器名称> -p 80:8080 -it \ 
    --env LIFERAY_SETUP_PERIOD_WIZARD_PERIOD_ENABLED=false ibaiborodine/liferay-portal-ce:<标签>

环境变量也可通过docker-compose.yml（见上述示例）或扩展镜像（见下文示例）设置。

健康检查

该镜像未包含显式健康检查。你可以使用--health-*选项添加健康检查：

console
$ docker run --name <容器名称> -d \ 
    --health-cmd='curl -fsS "http://localhost:8080/c/portal/layout" || exit 1' \
    --health-start-period=1m \
    --health-interval=1m \
    --health-retries=3 \
    ibaiborodine/liferay-portal-ce:<标签> 

关于为何未默认定义HEALTHCHECK及如何实现自定义健康检查的详细说明，请查看https://github.com/docker-library/faq#healthcheck%E3%80%82

向运行中的实例部署模块

该镜像暴露可选VOLUME以支持向运行中的容器部署模块。步骤如下：

1. 在主机系统上创建部署目录（如/my/own/deploydir）。
2. 启动实例：

console
$ docker run --name <容器名称> -v /my/own/deploydir:/opt/liferay/deploy -d ibaiborodine/liferay-portal-ce:<标签>

-v /my/own/deploydir:/opt/liferay/deploy将主机目录/my/own/deploydir挂载到容器内/opt/liferay/deploy，容器会自动扫描该目录以部署布局模板、Portlet和主题。

文档与媒体文件存储

默认情况下，Liferay Portal使用Simple File Store存储文档和媒体文件，默认根目录为LIFERAY_HOME/data/document_library。
你可以将主机目录挂载到容器内以持久化存储：

1. 在主机系统创建数据目录（如/my/own/liferaydatadir）。
2. 启动实例：

console
$ docker run --name <容器名称> -v /my/own/liferaydatadir:/opt/liferay/data/document_library -d ibaiborodine/liferay-portal-ce:<标签>

注意：存储文件时请勿使用默认内存数据库（H2），应配置外部数据源（如MySQL）。

如何扩展该镜像

环境变量

若需覆盖默认配置，可在派生镜像中指定环境变量：

dockerfile
FROM docker.xuanyuan.run/ibaiborodine/liferay-portal-ce:<标签>

ENV LIFERAY_SETUP_PERIOD_WIZARD_PERIOD_ENABLED false
ENV LIFERAY_TERMS_PERIOD_OF_PERIOD_USE_PERIOD_REQUIRED false
ENV LIFERAY_USERS_PERIOD_REMINDER_PERIOD_QUERIES_PERIOD_ENABLED false
ENV LIFERAY_USERS_PERIOD_REMINDER_PERIOD_QUERIES_PERIOD_CUSTOM_PERIOD_QUESTION_PERIOD_ENABLED false

添加或覆盖文件

通过LIFERAY_BASE环境变量（默认/etc/opt/liferay）定义的可选VOLUME可自定义实例：

1. 在主机创建目录（如/my/own/liferaybasedir）。
2. 启动实例：

console
$ docker run --name <容器名称> -v /my/own/liferaybasedir:/etc/opt/liferay -d ibaiborodine/liferay-portal-ce:<标签>

主机目录中的所有文件和子目录会在容器启动时复制到LIFERAY_HOME。例如：

• 放置portal-ext.properties到/my/own/liferaybasedir以添加自定义配置。
• 放置setenv.sh到/my/own/liferaybasedir/tomcat/bin以覆盖Tomcat配置。

执行自定义Shell脚本

通过挂载/docker-entrypoint-initliferay.d目录可在Liferay启动前执行脚本：

1. 在主机创建目录（如/my/own/liferayinitdir）。
2. 启动实例：

console
$ docker run --name <容器名称> -v /my/own/liferayinitdir:/docker-entrypoint-initliferay.d -d ibaiborodine/liferay-portal-ce:<标签>

主机目录中的所有Shell脚本会在Liferay启动前执行。

镜像变体

ibaiborodine/liferay-portal-ce:<version>-<jdk>-buster

基于Debian Linux（当前为Buster版本）的默认镜像，适用于大多数场景。

ibaiborodine/liferay-portal-ce:<version>-<jdk>-alpine

基于Alpine Linux的镜像，体积更小（约5MB基础镜像），适合对镜像大小有严格要求的场景。需注意Alpine使用musl libc而非glibc，部分软件可能存在兼容性问题。

许可证

本库（Liferay Portal Community Edition）是自由软件，你可根据GNU Lesser General Public License（LGPL）2.1版或后续版本的条款重新分发或修改它。
本库不提供任何担保，包括但不限于适销性、特定用途适用性或非侵权担保。详情请查看LGPL许可证。
你应已收到LGPL许可证副本，若未收到，请致函：

text
Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor Boston, MA 02110-1301 USA

与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版的Bash等），这些软件可能受其他许可证约束。
使用预构建镜像时，用户需确保符合所有包含软件的相关许可证要求。