nuxeo Docker 镜像 - 轩辕镜像

弃用通知

此镜像已弃用，因为Nuxeo维护的镜像现在是私有的（docker-library/official-images#6127 (comment)）。如需进一步支持，请联系Nuxeo。

快速参考

• 维护者：
  Nuxeo

• 获取帮助的途径：
  Docker社区论坛、Docker社区Slack 或 Stack Overflow

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

• 7.10, 7, LTS-2015
• 8.10, 8, LTS-2016
• 9.10, 9, LTS-2017
• 10.10, 10, LTS-2019, LTS, FT, latest

快速参考（续）

• 提交问题的途径：
  [***]

• 支持的架构：(更多信息)
  amd64

• 已发布镜像工件详情：
  repo-info 仓库的 repos/nuxeo/ 目录（历史记录）
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images 仓库的 library/nuxeo 标签
  official-images 仓库的 library/nuxeo 文件（历史记录）

• 本描述的来源：
  docs 仓库的 nuxeo/ 目录（历史记录）

什么是 Nuxeo？

Nuxeo 平台是一个高度可定制和扩展的内容管理平台，用于构建业务应用。

!logo

如何使用此镜像

启动基础 Nuxeo 实例

console
$ docker run --name mynuxeo -p 8080:8080 -d nuxeo

此镜像包含 EXPOSE 8080（Nuxeo 端口）。应用默认的 Nuxeo 配置，其中包括嵌入式数据库（H2）和嵌入式 Elasticsearch 实例。此设置不适用于生产环境。下文将说明如何通过指定环境变量来设置生产就绪的容器。

Nuxeo 平台可通过 [***]{DOCKER_HOST}:8080/ 访问，默认用户名和密码为 Administrator/Administrator。

启动带额外包的 Nuxeo 实例

console
$ docker run --name mynuxeo --rm -ti -p 8080:8080 -e NUXEO_PACKAGES="nuxeo-web-ui nuxeo-dam nuxeo-drive nuxeo-showcase-content nuxeo-template-rendering nuxeo-template-rendering-samples nuxeo-spreadsheet" nuxeo

这将安装与上述相同的镜像，但附带一些演示 Nuxeo 包，以展示其各种用途（如数字资产管理、文档管理、搜索等）。

有关如何使用此镜像的更多信息，请参阅 Nuxeo 文档。

环境变量

Nuxeo 镜像使用多个环境变量来支持特定配置。

NUXEO_DB_TYPE

定义要使用的数据库类型。默认情况下，它设置为仅适用于测试目的的 H2 嵌入式数据库。指定数据库类型时，可能需要其他变量：

• NUXEO_DB_HOST：如果定义了 NUXEO_DB_TYPE，此变量为必填项，需指向数据库服务器主机。
• NUXEO_DB_NAME：要使用的数据库名称（默认值为 nuxeo）。
• NUXEO_DB_USER：连接数据库的用户（默认值为 nuxeo）。
• NUXEO_DB_PASSWORD：连接数据库的密码（默认值为 nuxeo）。

NUXEO_TEMPLATES

此变量允许在 nuxeo.templates 配置变量中添加额外的 Nuxeo 配置模板。

NUXEO_ES_HOSTS

此变量允许设置外部 Elasticsearch 集群。使用逗号分隔的 Elasticsearch 主机列表（带 9300 端口）。还可设置其他环境变量：

• NUXEO_ES_CLUSTER_NAME：要加入的 Elasticsearch 集群名称。
• NUXEO_ES_INDEX_NAME：索引名称（默认值为 nuxeo）。
• NUXEO_ES_REPLICAS：副本数量（默认值为 1）。如果不为 0，则 ES 集群必须有足够的节点来满足副本设置。
• NUXEO_ES_SHARDS：分片数量（默认值为 5）。

例如：

NUXEO_ES_HOSTS=es1:9300,es2:9300
NUXEO_ES_CLUSTER_NAME=dockerCluster
NUXEO_ES_INDEX_NAME=nuxeo1
NUXEO_ES_REPLICAS=0
NUXEO_ES_SHARDS=5

NUXEO_REDIS_HOST

要使用 Redis，只需将此变量设置为 Redis 主机地址。

NUXEO_REDIS_PORT

如果设置了 Redis，可以覆盖默认端口配置（默认值为 6379）。

NUXEO_CLID

允许为 Nuxeo Connect 注册设置 CLID。此参数格式为 part1\npart2，因此根据环境，可能需要转义 \ 字符。

有关注册过程的更多信息，请参阅 Nuxeo 文档。

NUXEO_INSTALL_HOTFIX

启动最新热修复的安装。（默认值为 true，但需要设置 NUXEO_CLID）。

NUXEO_PACKAGES

允许在启动时安装 Nuxeo 包。

NUXEO_URL

此变量设置 Nuxeo 实例的可访问 URL。例如，在邮件中引用服务器地址时使用。

NUXEO_DATA

Nuxeo 数据目录的位置。（默认值为 /var/lib/nuxeo/data）。通常需要自定义 NUXEO_DATA 以将其映射到 Docker 卷，使二进制文件等数据保持持久化。

NUXEO_LOG

Nuxeo 日志目录的位置。（默认值为 /var/log/nuxeo）。

NUXEO_AUTOMATION_TRACE

如果设置为 "true"，将启用 自动化跟踪模式。

NUXEO_DEV_MODE

如果设置为 "true"，将启用开发模式，允许在使用 Nuxeo Studio 开发时进行 热重载。

NUXEO_BINARY_STORE

指定二进制存储的位置，用于配置 二进制存储。

NUXEO_TRANSIENT_STORE

指定 临时存储 的位置。

NUXEO_DDL_MODE

允许通过设置 ddlMode 值来配置 数据库创建选项。

NUXEO_CUSTOM_PARAM

允许向 nuxeo.conf 添加自定义参数。多个参数可通过 \n 分隔。例如：

NUXEO_CUSTOM_PARAM="repository.clustering.enabled=false\nrepository.clustering.delay=1000"

如何扩展此镜像

添加额外配置

如果要在基于此镜像的派生镜像中进行额外设置，可以添加 /docker-entrypoint-initnuxeo.d/nuxeo.conf 文件，该文件将追加到常规 nuxeo.conf 文件的末尾。

dockerfile
FROM nuxeo:7.10
COPY nuxeo.conf /docker-entrypoint-initnuxeo.d/nuxeo.conf

如果在 Dockerfile 中需要 root 账户执行某些安装步骤，由于镜像使用用户 1000（nuxeo）运行，因此需要在两个 USER 命令之间放置这些步骤。例如：

dockerfile
FROM nuxeo:LTS
USER root
RUN apt-get update && apt-get install -y --no-install-recommends vim
USER 1000

启动自定义 shell 脚本

可以在特殊的 /docker-entrypoint-initnuxeo.d 目录中添加自己的 shell 脚本。以 .sh 结尾的脚本将在默认入口点启动时运行。

ffmpeg

由于包含一些非免费编解码器，此镜像未附带 ffmpeg 二进制文件。但可以通过在派生镜像的 Dockerfile 中添加以下行来编译安装：

dockerfile
FROM nuxeo:7.10

USER root

RUN echo "deb [***] jessie non-free" >> /etc/apt/sources.list
RUN apt-get update && apt-get install -y --no-install-recommends libfaac-dev git

WORKDIR /tmp
# 构建 ffmpeg
ENV BUILD_YASM true
ENV LIBFAAC true
RUN git clone [***]
WORKDIR ffmpeg-nuxeo
RUN ./prepare-packages.sh \
 && ./build-yasm.sh \
 && ./build-x264.sh \
 && ./build-libvpx.sh \
 && ./build-ffmpeg.sh \
 && cd /tmp \
 && rm -Rf ffmpeg-nuxeo \
 && rm -rf /var/lib/apt/lists/*

USER 1000

使用 Oracle JVM

与 ffmpeg 原因相同，此镜像未附带 Oracle JVM，默认使用 OpenJDK。如果要使用 Hotspot JVM，可在派生 Dockerfile 中添加以下行：

dockerfile
RUN apt-get remove -y --purge openjdk-8-jdk \
  && add-apt-repository -y ppa:webupd8team/java && apt-get update \
  && echo "debconf shared/accepted-oracle-license-v1-1 select true" | debconf-set-selections \
  && echo "debconf shared/accepted-oracle-license-v1-1 seen true" | debconf-set-selections \
  && apt-get install -y oracle-java8-installer \
  && rm -rf /var/lib/apt/lists/*

为什么此镜像如此大？

此镜像较大是因为它包含许多功能。Nuxeo 发行版本身约为 250M，为了使缩略图生成、文档转 PDF 等功能正常工作，需要捆绑一些额外工具。希望未来能够将这些转换功能委托给作为额外 Docker 镜像捆绑的外部服务。

许可证

查看此镜像中包含的软件的 许可证信息。

与所有 Docker 镜像一样，这些镜像可能还包含其他软件，这些软件可能采用其他许可证（例如基础发行版中的 Bash 等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于 repo-info 仓库的 nuxeo/ 目录 中。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可证。