library/plone

⚠️ 弃用通知 ⚠️

• Plone 4.x 不再受支持。
• Plone 5.x 不再受支持。
• 强烈建议迁移到最新可用的 Plone 版本。详情参见 [***]

从 Plone 6.x 开始，前端和后端在单独的 Docker 镜像中运行。还有一个 ZEO 服务器 Docker 镜像。所有 Plone 6.0 及更高版本的镜像均由 Plone 基金会支持，并由社区志愿者维护。

• https://github.com/plone/plone-backend
• https://github.com/plone/plone-frontend
• https://github.com/plone/plone-zeo/

有关 Docker 镜像用法，请参见 Plone 6 文档。

快速参考

• 维护者：
  https://github.com/plone/plone.docker

• 获取帮助：
  Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及相应 Dockerfile 链接

无支持的标签

快速参考（续）

• 提交问题地址：
  https://github.com/plone/plone.docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  无支持的架构

• 已发布镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/plone (https://github.com/docker-library/repo-info/commits/master/repos/plone)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fplone
  https://github.com/docker-library/official-images/blob/master/library/plone (https://github.com/docker-library/official-images/commits/master/library/plone)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/plone (https://github.com/docker-library/docs/commits/master/plone)

Plone 是什么？

Plone 是一个基于 Zope 应用服务器构建的免费开源内容管理系统。

!https://raw.githubusercontent.com/docker-library/docs/57d4b2b366f7243810393fa6018bd8b62926b78d/plone/logo.svg?sanitize=true

特性

• 通过环境变量启用附加组件。
• 可选择基于 Debian 或 Alpine 的镜像。
• 内置 RelStorage 支持，可通过环境变量配置（需要 Plone 5.2.4+）。
• 通过 pas.plugins.ldap 内置 LDAP/AD 支持（需要 Plone 5.2.4+）。

用法

启动单个 Plone 实例

这将下载并启动基于 Debian 的最新 Plone 5 容器。

shell
docker run -p 8080:8080 plone

该镜像包含 EXPOSE 8080（Plone 端口），因此标准容器链接会自动使其对链接的容器可用。现在您可以通过 http://localhost:8080 添加 Plone 站点。默认 Zope 用户和密码为 admin/admin。

在 ZEO 集群中启动 Plone

ZEO 集群最适合生产环境设置。您需要一个负载均衡器。

在后台启动 ZEO 服务器：

shell
docker run --name=zeo plone zeo

在后台启动两个 Plone 客户端：

shell
docker run --link=zeo -e ZEO_ADDRESS=zeo:8080 -p 8081:8080 plone
docker run --link=zeo -e ZEO_ADDRESS=zeo:8080 -p 8082:8080 plone

以调试模式启动 Plone

您也可以通过运行以下命令以调试模式（fg）启动 Plone：

shell
docker run -p 8080:8080 plone fg

附加组件

您可以通过 ADDONS 环境变量启用 Plone 附加组件：

shell
docker run -p 8080:8080 -e PLONE_ADDONS="eea.facetednavigation Products.PloneFormGen" plone

有关如何使用自定义设置扩展此镜像、添加更多附加组件、构建镜像或挂载卷的更多信息，请参阅 Plone 5 文档。

支持的环境变量

Plone 镜像使用多个环境变量。

基本用法

• ADDONS：通过此环境变量使用 Plone 附加组件自定义 Plone。
• SITE：首次运行时，将具有此 ID 的 Plone 实例添加到 Data.fs。如果未提供，您需要通过 Web UI 手动添加 Plone 站点。
• ZEO_ADDRESS：此环境变量允许您将 Plone 镜像作为 ZEO 客户端运行。
• VERSIONS：使用特定版本的 Plone 附加组件或 Python 库。

运行 Plone 并安装两个附加组件（eea.facetednavigation 和 collective.easyform）：

shell
docker run -p 8080:8080 -e SITE="mysite" -e ADDONS="eea.facetednavigation collective.easyform" plone

要使用特定的附加组件版本，请按如下方式更改环境变量参数：

shell
-e ADDONS="eea.facetednavigation collective.easyform" \
-e VERSIONS="eea.facetednavigation=13.3 collective.easyform=2.1.0"

要使用 Plone REST API，请启动 Plone Docker 镜像，然后执行 curl 命令：

shell
docker run -p 8080:8080 -e SITE=plone plone
curl -H 'Accept: application/json' http://localhost:8080/plone

高级用法

对于高级用法，镜像支持以下环境变量：

Plone

• PLONE_ADDONS、ADDONS：通过这些环境变量使用 Plone 附加组件自定义 Plone。
• PLONE_SITE、SITE：首次运行时，将具有此 ID 的 Plone 实例添加到 Data.fs。如果未提供，您需要通过 Web UI 手动添加 Plone 站点。
• PLONE_VERSIONS、VERSIONS：使用特定版本的 Plone 附加组件或 Python 库。
• PLONE_PROFILES、PROFILES：提供 SITE 环境变量时要包含的 GenericSetup 配置文件。
• PLONE_ZCML、ZCML：包含自定义 Plone 附加组件 ZCML 文件（以前为 BUILDOUT_ZCML）。
• PLONE_DEVELOP、DEVELOP：开发新的或现有 Plone 附加组件（以前为 BUILDOUT_DEVELOP）。

ZEO

• ZEO_ADDRESS：此环境变量允许您将 Plone 镜像作为 ZEO 客户端运行。
• ZEO_READ_ONLY：将 Plone 作为只读 ZEO 客户端运行。默认为 off。
• ZEO_CLIENT_READ_ONLY_FALLBACK：指示当没有可写存储可用时是否接受只读远程存储作为回退。默认为 false。
• ZEO_SHARED_BLOB_DIR：如果 ZEO 服务器和实例可以访问同一目录，设置为 on。默认为 off。
• ZEO_STORAGE：设置 ZEO 存储的存储编号。默认为 1。
• ZEO_CLIENT_CACHE_SIZE：设置 ZEO 客户端缓存大小。默认为 128MB。
• ZEO_PACK_KEEP_OLD：可设置为 false 以禁用在执行 pack 前创建 *.fs.old 文件。默认为 true。
• HEALTH_CHECK_TIMEOUT：健康检查开始前的等待时间（秒）。默认为 1 秒。
• HEALTH_CHECK_INTERVAL：检查 Zope 应用是否仍健康的时间间隔（秒）。默认为 1 秒。

CORS

• CORS_ALLOW_ORIGIN：允许访问资源的源。可以是逗号分隔的源列表（例如 https://example.net,https://mydomain.com）或 *。默认为 http://localhost:3000,http://127.0.0.1:3000。
• CORS_ALLOW_METHODS：此 CORS 策略允许的 HTTP 方法名称的逗号分隔列表（例如 DELETE,GET,OPTIONS,PATCH,POST,PUT）。默认为 DELETE,GET,OPTIONS,PATCH,POST,PUT。
• CORS_ALLOW_CREDENTIALS：指示资源是否支持请求中的用户凭据。默认为 true。
• CORS_EXPOSE_HEADERS：客户端可访问的响应头的逗号分隔列表（例如 Content-Length,X-My-Header）。默认为 Content-Length,X-My-Header。
• CORS_ALLOW_HEADERS：允许客户端发送的请求头的逗号分隔列表（例如 X-My-Header）。默认为 Accept,Authorization,Content-Type,X-Custom-Header。
• CORS_MAX_AGE：指示预检请求结果的缓存时间。默认为 3600。

RelStorage

• RELSTORAGE_ADAPTER_OPTIONS：使用 plone.recipe.zope2instance 为 Plone 实例设置的 RelStorage 适配器选项的逗号分隔列表。使用 RelStorage 时需要此选项。

所有其他可用环境变量均与 RelStorage 设置完全匹配，具体请参见 文档中的设置规范。

• RELSTORAGE_NAME：name - 存储的名称。

• RELSTORAGE_READ_ONLY：read-only - 如果为 true，则只能对存储执行读取操作。

• RELSTORAGE_KEEP_HISTORY：如果此选项设置为 true（默认值），则适配器将创建并使用保留历史记录的数据库架构，如 FileStorage。

• RELSTORAGE_BLOB_DIR：blob-dir - 如果提供，存储将提供 ZODB BLOB 支持。此选项指定保存 BLOB 数据的目录。如果目录不存在，将创建它。如果未提供值或提供空值，则不提供 BLOB 支持。默认为 /plone/instance/var/blobstorage。

  查看更多 RelStorage 选项。

文档

最终用户的完整文档可在 5.docs.plone.org 找到。

许可证

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

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

一些能够自动检测到的其他许可证信息可能位于 https://github.com/docker-library/repo-info/tree/master/repos/plone 中。

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