Skip to content

快速参考

  • 由……维护： （注：原文中“Maintained by:”后面应该还有具体的维护者信息，但题目中未给出，所以翻译只能到此为止。）
    光流服务器开发团队

  • 哪里可以获得帮助：
    Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及各自的 Dockerfile 链接

快速参考（续）

什么是 Lightstreamer 服务器？

Lightstreamer 是一款针对互联网优化的实时消息服务器。它融合了 WebSockets、HTTP 和推送通知，可向/从移动设备、平板电脑、基于浏览器的、桌面和物联网应用程序传输数据。

如需了解更多有关 Lightstreamer Server 及其他 Lightstreamer 产品的信息并进行相关下载，请访问 www.lightstreamer.com。

logo

如何使用此图像

启动并运行

使用默认配置启动容器：

$ docker run --name ls-server -d -p 80:8080 lightstreamer

这会将容器内的 8080 端口映射到本地主机的 80 端口。然后将您的浏览器指向 http://localhost ，并观看显示从本地部署的演示应用程序实时流入数据的欢迎页面，这是对 Lightstreamer 技术所提供独特功能的首次概述。更多示例可在演示站点在线获取。

自定义设置

可以自定义在容器中运行的 Lightstreamer 实例的各个方面。例如，可以按如下方式提供特定的配置文件：

$ docker run --name ls-server -v /path/to/my-lightstreamer_conf.xml:/lightstreamer/conf/lightstreamer_conf.xml -d -p 80:8080 lightstreamer

同样，您可以提供自定义的日志记录配置，也许在这种情况下还可以指定一个专用卷，以确保日志文件的持久性以及容器的更好性能：

$ docker run --name ls-server -v /path/to/my-lightstreamer_log_conf.xml:/lightstreamer/conf/lightstreamer_log_conf.xml -v /path/to/logs:/lightstreamer/logs -d -p 80:8080 lightstreamer

如果您还在您的 my-lightstreamer_log_conf.xml 文件中将默认日志记录路径从 ../logs 更改为 /path/to/dest/logs ：

$ docker run --name ls-server -v /path/to/my-lightstreamer_log_conf.xml:/lightstreamer/conf/lightstreamer_log_conf.xml -v /path/to/hosted/logs:/path/to/dest/logs -d -p 80:8080 lightstreamer

或者，上述任务可以通过以如下方式通过 Dockerfile 导出新图像来执行：

FROM lightstreamer

# Please specify a COPY command only for the required custom configuration file
COPY my-lightstreamer_conf.xml /lightstreamer/conf/lightstreamer_conf.xml
COPY my-lightstreamer_log_conf.xml /lightstreamer/conf/lightstreamer_log_conf.xml

其中 my-lightstreamer_conf.xml 和 my-lightstreamer_log_conf.xml 是您的自定义配置文件，放置在与 Dockerfile 相同的目录中。只需运行以下命令：

$ docker build -t my-lightstreamer .

新图像将与提供的文件一起构建。之后，启动容器：

$ docker run --name ls-server -d -p 80:8080 my-lightstreamer

若要获取有关如何配置 Lightstreamer 服务器的更详细信息，请参阅安装目录的 conf 文件夹下您可以找到的 lightstreamer_conf.xml 和 lightstreamer_log_conf.xml 文件中的内联文档。

适配器集的部署

您可能想要使用此图像，即使搭配任何适配器套件，无论是您自己开发的还是第三方提供的。

为实现此目标，您可以使用与上述示例相似的策略：

单个适配器集的部署

要部署单个自定义适配器集，最简单的方法是将其文件附加到工厂适配器文件夹中，如下所示：

$ docker run --name ls-server -v /path/to/my-adapter-set:/lightstreamer/adapters/my-adapter-set -d -p 80:8080 lightstreamer

完全替换“adapters”文件夹

如果您有许多自定义适配器集要部署，更合适的策略是将主机中的适配器文件夹替换工厂适配器文件夹：

$ docker run --name ls-server -v /path/to/my-adapters:/lightstreamer/adapters -d -p 80:8080 lightstreamer

在这种情况下， /path/to/my-adapters 文件夹必须按照适配器文件夹所需的布局进行构建：

/path/to/my-adapters+
                    +my_adapter_set_1
                    +my_adapter_set_2
                    ...
                    +my_adapter_set_N

塑造新形象

再次，一种线性且简洁的方法是制作一个包含所有所需文件的新图像。

在这种情况下，您可以编写一个简单的 Dockerfile，其中提供了您所有适配器集配置文件的列表：

FROM lightstreamer

# Will copy the contents of N Adapter Sets into the factory adapters folder
COPY my-adapter-set-1 /lightstreamer/adapters/my-adapter-set-1
COPY my-adapter-set-2 /lightstreamer/adapters/my-adapter-set-2
COPY my-adapter-set-3 /lightstreamer/adapters/my-adapter-set-3

然后，正如已经解释过的那样，构建并启动容器。

网页服务器页面的部署

在某些情况下，您可能希望为 Lightstreamer Server 的内部 Web 服务器提供自定义页面。即使在这种情况下，也可以使用与上述相同的技术来自定义容器。

例如，使用以下命令，您将能够完全替换工厂 pages 文件夹：

$ docker run --name ls-server -v /path/to/custom/pages:/lightstreamer/pages -d -p 80:8080 lightstreamer

其中 /path/to/custom/pages 是您主机中包含替换 Web 内容文件的路径。

许可证

查看此映像中所包含软件的许可证信息。

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

一些能够自动检测到的额外许可信息可能会在 repo-info 存储库的 lightstreamer/ 目录中找到。

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