silverpeas Docker Image Overview

library/silverpeas

Docker 官方镜像

Silverpeas是一个开箱即用的开源协作和社交网络门户，旨在促进个人、团队和组织的协作、知识共享与反馈，支持Web浏览器和智能手机访问，提供约30个现成应用及社交功能。

47 次收藏下载次数: 0状态：Docker 官方镜像维护者：Docker 官方镜像仓库类型：镜像最近更新：10 天前

轩辕镜像，快一点，稳很多。点击查看

中文简介版本下载

轩辕镜像，快一点，稳很多。点击查看

快速参考

维护者：
Silverpeas
获取帮助：
Silverpeas用户邮件列表

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

6.4.4, latest
6.3.6

快速参考（续）

提交issues：
[***]
支持的架构：(更多信息)
amd64
已发布镜像 artifact 详情：
repo-info 仓库的 repos/silverpeas/ 目录 (历史记录)
（镜像元数据、传输大小等）
镜像更新：
official-images 仓库的 library/silverpeas 标签
official-images 仓库的 library/silverpeas 文件 (历史记录)
本描述来源：
docs 仓库的 silverpeas/ 目录 (历史记录)

什么是 Silverpeas

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

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

!logo

如何使用本镜像

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 实例

Docker Hub 上目前没有 Microsoft SQLServer 的官方 Docker 镜像，但有许多 PostgreSQL 镜像。例如，使用官方 PostgreSQL Docker 镜像，可以启动一个初始化了超级用户 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 容器的更多信息，请参考其文档。

数据库系统运行后，需要为 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 文件中，示例可在此处或容器目录 /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