library/lightstreamer

快速参考

• 维护者： https://github.com/Lightstreamer/Docker

• 获取帮助： https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

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

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/6.0/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/6.1/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.0/jdk8/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.0/jdk11/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.1/jdk8/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.1/jdk11/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.2/jdk8/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.2/jdk11/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.3/jdk8/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.3/jdk11/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/b6c4a87af3e78b53887f311bdf2404f4f9956796/7.3/jdk17/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/abea70d53fb366cb5d5402493c37ca4f0b2ab0c1/7.4/jdk8/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/abea70d53fb366cb5d5402493c37ca4f0b2ab0c1/7.4/jdk11/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/abea70d53fb366cb5d5402493c37ca4f0b2ab0c1/7.4/jdk17/Dockerfile

• https://github.com/Lightstreamer/Docker/blob/abea70d53fb366cb5d5402493c37ca4f0b2ab0c1/7.4/jdk21/Dockerfile

快速参考(续)

• 问题提交位置： https://github.com/Lightstreamer/Docker/issues?q=

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

• 已发布镜像的详细信息： https://github.com/docker-library/repo-info/blob/master/repos/lightstreamer (https://github.com/docker-library/repo-info/commits/master/repos/lightstreamer) (镜像元数据、传输大小等)

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

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

什么是Lightstreamer Server?

Lightstreamer是一个针对互联网优化的实时消息服务器。它融合了WebSocket、HTTP和推送通知技术，可向移动设备、平板电脑、基于浏览器的应用、桌面应用和物联网应用流式传输数据（或从这些应用接收数据）。

有关Lightstreamer Server和其他Lightstreamer产品的更多信息及相关下载，请访问[***]。

如何使用此镜像

启动和运行

使用默认配置启动容器：

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

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

自定义设置

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

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

同样，可以提供自定义的日志配置，在这种情况下，可能还需要指定专用卷以确保日志文件的持久性和容器的更好性能：

console
$ 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：

console
$ 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派生新镜像来执行上述任务：

dockerfile
FROM docker.xuanyuan.run/lightstreamer

# 仅为所需的自定义配置文件指定COPY命令
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位于同一目录中。只需运行以下命令：

console
$ docker build -t my-lightstreamer .

将构建包含所提供文件的新镜像。之后，启动容器：

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

有关如何配置Lightstreamer服务器的更多详细信息，请参见安装目录的conf文件夹中的lightstreamer_conf.xml和lightstreamer_log_conf.xml文件中的内联文档。

适配器集的部署

您可能希望将此镜像与自己开发的或第三方提供的任何适配器集一起使用。

要实现此目标，可以使用与上述类似的策略：

单个适配器集的部署

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

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

完全替换"adapters"文件夹

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

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

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

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

构建新镜像

同样，一种线性且清晰的方法是创建包含所有所需文件的新镜像。

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

dockerfile
FROM docker.xuanyuan.run/lightstreamer

# 将N个适配器集的内容复制到工厂适配器文件夹中
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

然后，按照已说明的方法构建并启动容器。

Web服务器页面的部署

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

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

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

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

许可证

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

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

一些能够自动检测到的其他许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/lightstreamer中。

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