amd64/silverpeas Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

** 注意 **：这是silverpeas官方镜像的amd64架构构建的“每架构”仓库——更多信息，请参见官方镜像文档中的“除amd64之外的架构？”和官方镜像FAQ中的“Git中的镜像源已更改，现在该怎么办？”。

快速参考

-** 维护者 **：
Silverpeas

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

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

• 6.4.4, latest

• 6.3.6

快速参考（续）

-** 问题反馈 ：
[*]

-** 支持的架构 **：(更多信息)
amd64

-** 已发布镜像制品详情 **：
repo-info仓库的repos/silverpeas/目录（历史记录）
（镜像元数据、传输大小等）

-** 镜像更新 **：
official-images仓库的library/silverpeas标签
official-images仓库的library/silverpeas文件（历史记录）

-** 本描述的来源 **：
docs仓库的silverpeas/目录（历史记录）

什么是Silverpeas

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

通过简单的Web浏览器或智能手机即可访问Silverpeas，它已被广泛日常使用。凭借约30个即用型应用程序及其对话和关系功能，用户可以协作工作、分享知识和良好实践，总体上提高相互同理心，从而增强协作意愿。

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

!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镜像，可以启动一个PostgreSQL实例，初始化为超级用户postgres，密码为mysecretpassword：

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

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

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

默认情况下，容器内会创建一些卷，以便在主机上访问它们（参考Docker文档查找卷位置）。其中包括/opt/silverpeas/log和/opt/silverpeas/data：第一个卷包含Silverpeas生成的日志，第二个卷包含用户在Silverpeas中创建和管理的所有数据。由于后者在镜像创建时已具有目录结构，因此在容器中挂载主机目录到opt/silverpeas/data会覆盖卷的现有内容。在示例中，为了便于定位这两个卷，分别显式标记为silverpeas-log和silverpeas-data（使用数据卷容器映射/opt/silverpeas/log和/opt/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 \
    amd64/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 \
    amd64/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生成的数据需要持久化，可用于Silverpeas的后续版本，并且必须可被其他容器（如运行LibreOffice的容器）访问。为此，Docker团队建议使用数据卷容器。

在Silverpeas中，应用程序生成的数据有四种类型：

• 存储在/opt/silverpeas/log中的日志，
• 存储在/opt/silverpeas/data中的用户数据以及Silverpeas从用户数据生成的数据，
• 由工作流编辑器创建的工作流，存储在/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必须保持一致，它们构成一个连贯的整体。因此，定义数据卷容器来集中所有这些卷比定义多个共享存储卷更好。使用此类数据卷容器，可以更轻松地备份、恢复或迁移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 \
    amd64/silverpeas \
    /bin/true

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

console
$ docker run --name silverpeas -p 8080:8000 -d \
    --link postgresql:database \
    --volumes-from silverpeas-store \
    amd64/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 \
    amd64/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等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的额外许可证信息可能位于[repo-info仓库的silverpeas/目录](https