eeacms/kgs

EEA Plone KGS 含EEA附加组件即开即用Docker镜像

Docker镜像，用于运行带有EEA常用附加组件的Plone（前身为https://github.com/eea/eea.plonebuildout.core%EF%BC%89%E3%80%82

此镜像具有通用性，因此您可以在非EEA相关项目中复用它。

支持的标签及对应Dockerfile链接

• https://hub.docker.com/r/eeacms/kgs/tags/

基础Docker镜像

• https://hub.docker.com/r/eeacms/kgs/

源代码

• http://github.com/eea/eea.docker.kgs

安装

1. 安装Docker
2. 安装Docker Compose（可选）

版本信息

• Python 2.7.12
• Plone 4.3.10
• Zope 2.13.24

简单使用

bash
$ docker run -p 8080:8080 eeacms/kgs

现在，在工作站浏览器中访问 http://localhost:8080/，添加Plone站点（默认凭据 admin:admin）。

更多信息参见 https://hub.docker.com/_/plone

高级使用（ZEO、RelStorage等）

启动ZEO服务器：

bash
$ docker run -d --name=zeo \
             -e ZOPE_MODE=zeoserver \
         eeacms/kgs

启动2个Plone客户端：

bash
$ docker run -d --name=zclient1 \
             -e ZOPE_MODE=zeo_client \
             --link=zeo:zeoserver \
         eeacms/kgs

$ docker run -d --name=zclient2 \
             -e ZOPE_MODE=zeo_client \
             --link=zeo:zeoserver \
         eeacms/kgs

启动负载均衡器：

bash
$ docker run -d --name=lb \
             -p 8080:5000 \
             -p 1936:1936 \
             --link=zclient1 \
             --link=zclient2 \
             -e BACKENDS="zclient1 zclient2" \
             -e BACKENDS_PORT=8080 \
             -e DNS_ENABLED=true \
         eeacms/haproxy

在 http://localhost:1936/ 检查负载均衡器后端健康状态（默认凭据 admin:admin）。若一切正常，访问 http://localhost:8080/ 添加Plone站点。

详见 https://github.com/eea/eea.docker.kgs/tree/master/examples/zeoclient/README.md 示例。

您还可以将此镜像作为以下模式运行：

• https://github.com/eea/eea.docker.kgs/tree/master/examples/relstorage/README.md
• https://github.com/eea/eea.docker.kgs/tree/master/examples/develop/README.md

扩展此镜像

为此，您需要提供以下自定义文件：

• buildout.cfg
• Dockerfile

以下是基于EEA KGS镜像构建自定义Plone版本（包含自定义包版本）的buildout.cfg和Dockerfile示例：

buildout.cfg：

ini
[buildout]
extends = eea.cfg

auto-checkout =
  land.copernicus.theme
  land.copernicus.content

[configuration]
eggs +=
  land.copernicus.theme
  land.copernicus.content

[sources]
land.copernicus.theme = git https://github.com/eea/land.copernicus.theme.git
land.copernicus.content = git https://github.com/eea/land.copernicus.content.git

Dockerfile：

dockerfile
FROM eeacms/kgs:8.4

COPY buildout.cfg /plone/instance/
RUN buildout

然后运行：

bash
$ docker build -t plone-land-copernicus .

数据持久化/迁移

• https://github.com/plone/plone.docker/blob/master/docs/usage.rst#8-where-to-store-data
• https://github.com/eea/eea.docker.postgres#persistent-data-as-you-wish

升级

bash
$ docker pull eeacms/kgs

支持的环境变量

ZOPE：

• ZOPE_MODE - 运行模式，可选值：zeoserver、standalone、zeo_client、zeo_async、rel_client、rel_async，默认 standalone
• ZOPE_THREADS - 配置zserver线程数，默认 2（例如：ZOPE_THREADS=4）
• ZOPE_FAST_LISTEN - 设置为off可延迟到Zope启动阶段结束后再打开HTTP socket，默认 off（例如：ZOPE_FAST_LISTEN=on）
• ZOPE_FORCE_CONNECTION_CLOSE - 设置为on可强制Zope设置Connection: close头，默认 on（例如：ZOPE_FORCE_CONNECTION_CLOSE=off）

RELSTORAGE：

• RELSTORAGE_HOST - 自定义PostgreSQL地址，默认 postgres（例如：RELSTORAGE_HOST=1.2.3.4）
• RELSTORAGE_USER - 自定义PostgreSQL用户，默认 zope（例如：RELSTORAGE_USER=plone）
• RELSTORAGE_PASS - 自定义PostgreSQL密码，默认 zope（例如：RELSTORAGE_PASS=secret）
• RELSTORAGE_KEEP_HISTORY - 保留历史记录的数据库模式，默认 true（例如：RELSTORAGE_KEEP_HISTORY=false）

GRAYLOG：

• GRAYLOG - 配置容器内Zope发送日志到GrayLog，默认 logcentral.eea.europa.eu:12201（例如：GRAYLOG=logs.example.com:12201）
• GRAYLOG_FACILITY - 自定义GrayLog设施，默认 eea.docker.kgs（例如：GRAYLOG_FACILITY=staging.example.com）

SENTRY：

• SENTRY_DSN - 发送Python跟踪信息到sentry.eea.europa.eu（例如：SENTRY_DSN=https://<public_key>:<secret_key>@sentry.eea.europa.eu）
• SENTRY_SITE、SERVER_NAME - 通常为无协议的应用URL（例如：SERVER_NAME=staging.eea.europa.eu）
• SENTRY_RELEASE - 自定义KGS应用版本（例如：SENTRY_RELEASE=18.5.9-2.26）
• SENTRY_ENVIRONMENT、ENVIRONMENT - 覆盖环境，留空将自动从rancher-metadata获取

CORS：

• CORS_ALLOW_ORIGIN - 允许访问资源的源，可为逗号分隔的源列表（例如 http://example.net,http://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，默认 Content-Length,X-My-Header
• CORS_ALLOW_HEADERS - 允许客户端发送的请求头列表（逗号分隔），例如 X-My-Header，默认 Accept,Authorization,Content-Type
• CORS_MAX_AGE - 指示预检请求结果的缓存时间，默认 3600

发布此镜像的新版本

获取源代码：

bash
$ git clone git@github.com:eea/eea.docker.kgs.git

更新Dockerfile中的EEA_KGS_VERSION环境变量：

bash
$ cd eea.docker.kgs
$ vim Dockerfile

提交更改：

bash
$ git commit -am "Release 19.5"

创建标签：

bash
$ git tag 19.5

推送更改：

bash
$ git push --tags
$ git push

更新发行说明：

bash
$ docker run -it --rm -e GIT_NAME="eea.docker.kgs" eeacms/gitflow bash
$ /unifyChangelogs.py 19.4 19.5 2> /dev/null

将输出添加到 https://github.com/eea/eea.docker.kgs/releases/new

版权和许可

原始代码的初始所有者为欧洲环境署（EEA）。保留所有权利。

原始代码是自由软件；您可以根据GNU通用公共许可证的条款（由自由软件基金会发布）重新分发和/或修改它；许可证版本为2或（根据您的选择）任何更高版本。

资金

欧洲环境署（欧盟）