eeacms/kgs-devel

EEA Plone KGS 含EEA附加组件可直接运行Docker镜像

![构建状态]([] ![流水线状态]([]

Plone的Docker镜像，包含EEA常用附加组件（前身为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%E7%A4%BA%E4%BE%8B%E3%80%82

还可按以下方式运行此镜像：

• 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，要么（根据您的选择）任何更高版本。

资助

欧洲环境署（欧盟）