silverpeas/silverpeas-test

docker-silverpeas-test

一个生成http://www.silverpeas.org独立Docker镜像的`Dockerfile`，用于测试目的。此镜像中嵌入了H2数据库，并将其用作Silverpeas的默认数据库。运行时无需依赖其他容器。

用于测试目的的Silverpeas现成Docker镜像可在我们的https://hub.docker.com/r/silverpeas/silverpeas-test/获取。

镜像创建

要创建Silverpeas 6最新版本的镜像：

bash
$ ./build.sh

这将构建一个包含Silverpeas最新版本和Silverpeas支持的Wildfly最新版本的镜像，标签为silverpeas/silverpeas-test:latest。

若要创建特定版本的Silverpeas 6镜像，需将Silverpeas的精确版本和该版本使用的Wildfly精确版本作为参数指定：

bash
$ ./build.sh 6.1 18.0.1

这将构建Silverpeas 6.1和Wildfly 18.0.1的Docker镜像，标签为silverpeas/silverpeas-test:6.1。传递的版本参数必须与Silverpeas和Wildfly的可用版本匹配；Silverpeas和Wildfly将从各自的项目网站下载。

容器运行

要从镜像运行名为silverpeas-test的容器，只需执行：

bash
$ docker run --name silverpeas-test -p 8080:8000 -d silverpeas/silverpeas-test

该镜像暴露Silverpeas监听的8000端口，容器的此端口映射到主机的8080端口。Silverpeas启动完成需要一定时间（约1分钟）；可通过Docker查看日志确认其是否正确启动。

从镜像启动容器时，在启动Silverpeas之前会执行配置步骤，可借此自定义Silverpeas配置。例如，Silverpeas默认语言环境为法语，可通过locale环境变量指定其他语言环境（如英语）：

bash
$ docker run --name silverpeas-test -p 8080:8000 -d -e locale=en silverpeas/silverpeas-test

如需自定义更多Silverpeas配置参数，请参阅下文自定义配置部分。

数据持久化

默认情况下，数据存储在容器内，容器移除后数据可能丢失。要与其他容器共享数据或使数据脱离容器，可将/opt/silverpeas/data和/opt/silverpeas/h2卷挂载到主机。也可挂载/opt/silverpeas/log卷以查看日志。例如：

bash
$ docker run --name silverpeas-test -p 8080:8000 -d \
  -v silverpeas-log:/opt/silverpeas/log \
  -v silverpeas-data:/opt/silverpeas/data \
  -v silverpeas-h2:/opt/silverpeas/h2 \
  silverpeas/silverpeas-test

日志、Silverpeas数据和H2数据库数据将分别挂载到主机上的silverpeas-log、silverpeas-data和silverpeas-h2标签下。有关Docker安装中挂载卷标签的位置，请参考https://docs.docker.com/engine/tutorials/dockervolumes/#locating-a-volume。注意，卷包含镜像创建时生成的内容，若挂载到主机文件系统，可能会覆盖卷的现有内容。

自定义配置

如需在Silverpeas全局配置文件config.properties中设置特定配置参数，可在主机上创建custom_config.properties配置文件，然后将其映射到容器内的/opt/silverpeas/configuration/custom_config.properties文件。例如，要设置SMTP属性以接收邮件通知，在custom_config.properties文件（如/home/me目录下）中添加：

properties
SMTP_SERVER=smtp.googlemail.com
SMTP_AUTHENTICATION=true
SMTP_DEBUG=false
SMTP_PORT=465
SMTP_USER=myidentifier@gmail.com
SMTP_PASSWORD=mypassword
SMTP_SECURE=true

然后映射到容器：

bash
$ docker run --name silverpeas-test -p 8080:8000 -d \
  -v /home/me/custom_config.properties:/opt/silverpeas/configuration/custom_config.properties \
  silverpeas/silverpeas-test

自定义配置文件将被解析，并将各参数添加到Silverpeas全局配置文件中。

自定义Silverpeas设置

Silverpeas核心引擎及应用程序的设置可通过/opt/silverpeas/properties目录进行自定义。出于历史原因，此类设置的自定义通过XML脚本CustomerSettings.xml完成，其语法遵循/opt/silverpeas/configuration/silverpeas目录中主脚本00-SilverpeasSettings.xml的语法。如需自定义Silverpeas设置，可创建CustomSettings.xml或CustomerSettings.xml文件，然后将其映射到容器内/opt/silverpeas/configuration/silverpeas/目录下的同名文件。例如，要设置较弱的密码规则，可在XML文件（如/home/me目录下）中添加：

xml
<?xml version="1.0" encoding="UTF-8"?>
<silverpeas-settings product="custom">
  <fileset root="${SILVERPEAS_HOME}/properties/org/silverpeas">
    <configfile name="password/settings/password.properties">
      <parameter key="password.rule.minLength">4</parameter>
      <parameter key="password.rule.blankForbidden">false</parameter>
      <parameter key="password.rule.sequentialForbidden">false</parameter>
      <parameter key="password.rule.atLeastXUppercase">false</parameter>
      <parameter key="password.rule.atLeastXLowercase">false</parameter>
      <parameter key="password.rule.atLeastXDigit">false</parameter>
      <parameter key="password.rule.atLeastXSpecialChar">false</parameter>
    </configfile>
  </fileset>
</silverpeas-settings>

然后映射到容器：

bash
$ docker run --name silverpeas-test -p 8080:8000 -d \
  -v /home/me/CustomSettings.xml:/opt/silverpeas/configuration/silverpeas/CustomSettings.xml \
  silverpeas/silverpeas-test

日志

可通过查看挂载的/opt/silverpeas/log目录中的日志文件跟踪Silverpeas活动。

Wildfly的输出重定向到容器标准输出，可通过以下命令查看：

bash
$ docker logs -f silverpeas

开发用途

可使用此项目构建包含自定义Silverpeas代码更改的Docker镜像。为此，需将Silverpeas代码（至少包括Silverpeas-Core和Silverpeas-Component）构建到src/repository目录作为Maven仓库。构建Silverpeas测试镜像时，将自动使用此目录。