arm64v8/silverpeas

注意： 这是 https://hub.docker.com/_/silverpeas 的 arm64v8 架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“https://github.com/docker-library/official-images#architectures-other-than-amd64%E2%80%9D%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9Chttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E2%80%9D%E3%80%82

快速参考

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

• 获取帮助：
  https://groups.google.com/forum/#!forum/silverpeas-users

支持的标签及对应的 Dockerfile 链接

警告： 此镜像在 arm64v8 架构上不受支持

快速参考（续）

• 提交问题地址：
  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 是什么

https://www.silverpeas.org 是一个协作与社交网络门户，旨在促进个人、团队和组织之间的协作、知识共享和反馈。

通过简单的网页浏览器或智能手机即可访问，Silverpeas 提供约30个现成应用及社交互动功能，使用户能够协同工作、分享知识和最佳实践，提升相互理解与协作意愿。

Silverpeas 通常用作专注于协作和信息共享的内联网和外联网平台。

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

如何使用此镜像

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

• 开源、功能强大且推荐的 PostgreSQL 数据库系统，
• Microsoft SQL Server 数据库系统，
• Oracle 数据库系统。

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

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

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

• DB_SERVERTYPE：指定 Silverpeas 使用的数据库系统，可选值为 POSTGRESQL（PostgreSQL）、MSSQL（Microsoft SQL Server）、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 SQL Server 的官方 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，示例如下：

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 \
    arm64v8/silverpeas

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

Silverpeas 可通过 http://localhost:8080/silverpeas 访问。管理员账户为 SilverAdmin，密码为 SilverAdmin，登录后请务必修改管理员密码。

容器内默认创建了一些卷，以便在主机上访问（参考 https://docs.docker.com/engine/tutorials/dockervolumes/#locating-a-volume 查找卷位置），其中包括 /opt/silverpeas/log（Silverpeas 日志）和 /opt/silverpeas/data（用户在 Silverpeas 中创建和管理的所有数据）。由于 /opt/silverpeas/data 在镜像创建时已包含目录结构，直接挂载主机目录会覆盖卷内容，因此示例中显式标记这两个卷为 silverpeas-log 和 silverpeas-data（使用 https://docs.docker.com/engine/userguide/containers/dockervolumes/ 映射这两个目录是更好的方案）。

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 \
    arm64v8/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 \
    arm64v8/silverpeas

其中 database 是 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，
• 工作流编辑器创建的工作流：/opt/silverpeas/xmlcomponents/workflows。

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

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

这些数据构成 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 \
    arm64v8/silverpeas \
    /bin/true

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

console
$ docker run --name silverpeas -p 8080:8000 -d \
    --link postgresql:database \
    --volumes-from silverpeas-store \
    arm64v8/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 \
    arm64v8/silverpeas \
    /bin/true

日志

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

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

console
$ docker logs -f silverpeas

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

许可证

查看此镜像包含软件的 https://www.silverpeas.org/legal/licensing_gnu_affero.html%E3%80%82

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%E3%80%82

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