library/silverpeas

快速参考

• 维护者：
  https://github.com/Silverpeas/docker-silverpeas-prod

• 获取帮助：
  Silverpeas用户邮件列表

支持的标签及对应Dockerfile链接

• https://github.com/Silverpeas/docker-silverpeas-prod/blob/2094ddb26caec9820d1852a9fa2bc3c2c84a1ada/Dockerfile

• https://github.com/Silverpeas/docker-silverpeas-prod/blob/fb25885d1cd43172693b3acf79e9fac056a9db34/Dockerfile

快速参考（续）

• 提交issues：
  https://github.com/Silverpeas/docker-silverpeas-prod/issues?q=

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

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

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

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

什么是 Silverpeas

Silverpeas 是一个协作和社交网络门户，旨在促进个人、团队和组织的协作、知识共享与反馈。

通过简单的 Web 浏览器或智能手机即可访问，Silverpeas 提供约 30 个现成应用以及会话和关系功能，使用户能够协同工作、共享知识和良好实践，提升相互理解和协作意愿。它通常用作专注于协作和信息共享的内联网和外联网平台。

!https://raw.githubusercontent.com/docker-library/docs/f0d096186294d86320e52224d7c8dabf450c17eb/silverpeas/logo.png

如何使用本镜像

Silverpeas 的 Docker 镜像需要以下数据库系统之一才能使用：

• 开源且推荐的 PostgreSQL 数据库系统
• Microsoft SQLServer 数据库系统
• Oracle 数据库系统

Silverpeas 镜像目前仅支持前两种数据库系统；由于 Oracle JDBC 驱动的非免费许可问题，Silverpeas 无法默认包含这些驱动，因此无法将 Oracle 数据库系统作为持久化后端透明使用。

出于同样原因，Silverpeas 的 Docker 镜像未随附 Oracle JVM，而是使用 OpenJDK。Silverpeas 使用 Wildfly 应用服务器作为运行时环境。

Silverpeas 镜像使用以下环境变量设置数据库访问参数：

• DB_SERVERTYPE：指定 Silverpeas 使用的数据库系统，可选值为 POSTGRESQL（PostgreSQL）、MSSQL（Microsoft SQLServer）、ORACLE（Oracle），默认值为 POSTGRESQL。
• DB_SERVER：指定数据库系统运行的主机 IP 地址或名称，默认值为 database，因此任何运行数据库的容器都可以通过此名称链接到 Silverpeas 容器。
• DB_NAME：指定 Silverpeas 使用的数据库名称，默认值为 Silverpeas。
• DB_USER：指定 Silverpeas 访问数据库的用户标识符，默认值为 silverpeas（建议为每个应用在数据库中创建专用用户账户）。
• DB_PASSWORD：指定上述用户标识符关联的密码。

这些环境变量也可以在 Silverpeas 全局配置文件 config.properties 中定义为属性（见下文）。

使用 Docker 容器中的数据库启动 Silverpeas 实例

https://hub.docker.com/ 上目前没有 Microsoft SQLServer 的官方 Docker 镜像，但有许多 PostgreSQL 镜像。例如，使用 https://hub.docker.com/_/postgres/%EF%BC%8C%E5%8F%AF%E4%BB%A5%E5%90%AF%E5%8A%A8%E4%B8%80%E4%B8%AA%E5%88%9D%E5%A7%8B%E5%8C%96%E4%BA%86%E8%B6%85%E7%BA%A7%E7%94%A8%E6%88%B7 postgres（密码为 mysecretpassword）的 PostgreSQL 实例：

console
$ docker run --name postgresql -d \
    -e POSTGRES_PASSWORD="mysecretpassword" \
    -v postgresql-data:/var/lib/postgresql/data \
    postgres:12.3

强烈建议将数据库文件目录挂载到主机，以便在升级 PostgreSQL 到新版本时不会丢失数据（也可使用数据卷容器替代）。有关如何启动 PostgreSQL 容器的更多信息，请参考其 https://hub.docker.com/_/postgres/%E3%80%82

数据库系统运行后，需要为 Silverpeas 创建数据库，并添加对该数据库具有管理权限（且仅限该数据库）的用户；出于安全原因，建议为每个应用（包括 Silverpeas）在数据库中创建专用用户账户。本文档中，默认创建数据库 Silverpeas 和用户 silverpeas。例如：

console
$ docker exec -it postgresql psql -U postgres
psql (12.3 (Debian 12.3-1.pgdg100+1))
Type "help" for help.

postgres=# create database "Silverpeas";
CREATE DATABASE
postgres=# create user silverpeas with password 'thesilverpeaspassword';
CREATE ROLE
postgres=# grant all privileges on database "Silverpeas" to silverpeas;
GRANT
postgres=# \q
$

使用默认配置启动 Silverpeas 实例

最后，可通过环境变量指定所需的数据库访问参数来启动 Silverpeas 实例。在示例中，数据库名称为 Silverpeas，特权用户为 silverpeas（密码为 thesilverpeaspassword）：

console
$ docker run --name silverpeas -p 8080:8000 -d \
    -e DB_NAME="Silverpeas" \
    -e DB_USER="silverpeas" \
    -e DB_PASSWORD="thesilverpeaspassword" \
    -v silverpeas-log:/opt/silverpeas/log \
    -v silverpeas-data:/opt/silverpeas/data \
    --link postgresql:database \
    silverpeas

默认情况下，database 是 Silverpeas 用于持久化后端的默认主机名。因此，当 PostgreSQL 数据库通过别名 database 链接时，无需通过 DB_SERVER 环境变量显式指定其主机名。Silverpeas 镜像暴露 8000 端口，此处将其映射到主机的 8080 端口。

随后可通过 http://localhost:8080/silverpeas 访问 Silverpeas。使用管理员账户 SilverAdmin（密码 SilverAdmin）登录，登录后请务必更改管理员账户密码。

容器内默认创建了一些卷，以便在主机中访问。其中包括 /opt/silverpeas/log（Silverpeas 生成的日志）和 /opt/silverpeas/data（用户在 Silverpeas 中创建和管理的数据）。由于后者在镜像创建时已包含目录结构，直接将主机目录挂载到容器的 opt/silverpeas/data 会覆盖卷内容，因此示例中通过标签 silverpeas-log 和 silverpeas-data 显式标记这两个卷（使用 数据卷容器 映射这些目录是更好的解决方案）。

Silverpeas 启动需要一定时间，建议查看日志确认启动完成（见日志部分）。

使用更精细的配置启动 Silverpeas 实例

Silverpeas 全局配置定义在 /opt/silverpeas/configuration/config.properties 文件中，示例可在 https://raw.githubusercontent.com/Silverpeas/Silverpeas-Distribution/master/src/main/dist/configuration/sample_config.properties 或容器目录 /opt/silverpeas/configuration/ 中找到。可显式创建 config.properties 文件，除数据库访问参数外（此时需指定 DB_SERVER 属性值为 database），添加特定配置参数，然后使用此配置文件启动 Silverpeas 实例：

console
$ docker run --name silverpeas -p 8080:8000 -d \
    -v /etc/silverpeas/config.properties:/opt/silverpeas/configuration/config.properties \
    -v silverpeas-log:/opt/silverpeas/log \
    -v silverpeas-data:/opt/silverpeas/data \
    --link postgresql:database \
    silverpeas

其中 /etc/silverpeas/config.properties 是主机上的自定义配置文件。出于安全原因，强烈建议在 config.properties 文件中通过属性 SILVERPEAS_ADMIN_LOGIN 和 SILVERPEAS_ADMIN_PASSWORD 显式设置管理员凭据（同时通过 SILVERPEAS_ADMIN_EMAIL 设置管理员***地址）。

以下是此类配置文件的示例：

SILVERPEAS_ADMIN_LOGIN=SilverAdmin
SILVERPEAS_ADMIN_PASSWORD=theadministratorpassword
SILVERPEAS_ADMIN_EMAIL=***

DB_SERVERTYPE=POSTGRESQL
DB_SERVER=database
DB_NAME=Silverpeas
DB_USER=silverpeas
DB_PASSWORD=thesilverpeaspassword

CONVERTER_HOST=libreoffice
CONVERTER_PORT=8997

SMTP_SERVER=smtp.foo.com
SMTP_AUTHENTICATION=true
SMTP_DEBUG=false
SMTP_PORT=465
SMTP_USER=silverpeas
SMTP_PASSWORD=thesmtpsilverpeaspassword
SMTP_SECURE=true

使用主机上的数据库启动 Silverpeas 实例

若数据库系统运行在主机（或远程主机）上，IP 地址为 192.168.1.14，启动容器时需同时指定该主机，并在 Silverpeas 全局配置文件中定义：

console
$ docker run --name silverpeas -p 8080:8000 -d \
    --add-host=database:192.168.1.14 \
    -v /etc/silverpeas/config.properties:/opt/silverpeas/configuration/config.properties \
    -v silverpeas-log:/opt/silverpeas/log \
    -v silverpeas-data:/opt/silverpeas/data \
    silverpeas

其中 database 是配置文件 /etc/silverpeas/config.properties 中 DB_SERVER 参数引用的数据库主机名，此处映射到该主机的实际 IP 地址，并添加到容器的 /etc/hosts 文件中。

对于 PostgreSQL 数据库系统，需进行以下配置以允许 Silverpeas 容器访问：

• 在文件 postgresql.conf 中，编辑 listen_addresses 参数，添加 PostgreSQL 主机地址（示例中为 192.168.1.14）：

  listen_addresses = 'localhost,192.168.1.14'

• 在文件 pg_hba.conf 中，为 Docker 子网添加条目：

  host all all 172.17.0.0/16 md5

• 重启 PostgreSQL 使更改生效。

使用数据卷容器

Silverpeas 生成的数据需要持久化、可用于后续版本，并能被其他容器（如 LibreOffice 容器）访问。为此，Docker 团队建议使用数据卷容器。

Silverpeas 生成的应用数据分为四类：

• 存储在 /opt/silverpeas/log 中的日志
• 存储在 /opt/silverpeas/data 中的用户数据及 Silverpeas 生成的数据
• 存储在 /opt/silverpeas/xmlcomponents/workflows 中的工作流（由工作流编辑器创建）

此外，根据具体需求，自定义配置脚本可添加到 /opt/silverpeas/configuration/jboss 和 /opt/silverpeas/configuration/silverpeas 目录。

Docker 镜像中已将 /opt/silverpeas/log、/opt/silverpeas/data 和 /opt/silverpeas/xmlcomponents/workflows 定义为卷。

这些不同类型的数据构成 Silverpeas 特定状态的完整集合，需保持一致性。因此，定义数据卷容器集中管理这些卷比使用多个共享存储卷更优，便于备份、恢复或迁移 Silverpeas 的完整数据集。

例如，为 Silverpeas 定义数据卷容器：

console
$ docker create --name silverpeas-store \
    -v silverpeas-data:/opt/silverpeas/data \
    -v silverpeas-log:/opt/silverpeas/log \
    -v silverpeas-workflows:/opt/silverpeas/xmlcomponents/workflows \
    -v /etc/silverpeas/config.properties:/opt/silverpeas/configuration/config.properties \
    silverpeas \
    /bin/true

然后在 Silverpeas 容器中挂载这些卷：

console
$ docker run --name silverpeas -p 8080:8000 -d \
    --link postgresql:database \
    --volumes-from silverpeas-store \
    silverpeas

如需自定义 Silverpeas 设置（如添加新数据库定义），可在数据卷容器中指定这些设置，以便后续版本的 Silverpeas 能正确配置：

console
$ docker create --name silverpeas-store \
    -v silverpeas-data:/opt/silverpeas/data \
    -v silverpeas-log:/opt/silverpeas/log \
    -v silverpeas-properties:/opt/silverpeas/properties \
    -v /etc/silverpeas/config.properties:/opt/silverpeas/configuration/config.properties \
    -v /etc/silverpeas/CustomerSettings.xml:/opt/silverpeas/configuration/silverpeas/CustomerSettings.xml \
    -v /etc/silverpeas/my-datasource.cli:/opt/silverpeas/configuration/jboss/my-datasource.cli \
    silverpeas \
    /bin/true

日志

可通过查看挂载的 /opt/silverpeas/log 目录中的日志了解 Silverpeas 活动。

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

console
$ docker logs -f silverpeas

Silverpeas 启动需要一定时间，建议查看日志确认启动完成。

许可

查看本镜像包含软件的 许可信息。

Silverpeas 使用自由开源软件（FLOSS），包括（非详尽列表）：

• MIT 许可的库（如 JQuery 和 Angular JS）
• Apache 2.0 许可的库和应用（如 Apache Commons 库和 Image Magick 工具）
• GPL/LGPL 许可的库和应用（如 SWFTools、FlexPaper Flash GPL、LibreOffice、OpenJDK）

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

可在 https://github.com/docker-library/repo-info/tree/master/repos/silverpeas 中找到一些自动检测到的附加许可信息。

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