跳到主要内容

适用于Linux的Docker桌面版

本节将指导您在非云Linux环境中使用Docker设置单个PubSub+软件事件代理容器。

  • 开始之前
  • 第1步：获取PubSub+软件事件代理
  • 第2步：创建容器
  • 第3步：管理PubSub+软件事件代理
  • 下一步

开始之前​

假设您的Linux主机上已安装了稳定版本的Docker守护进程。

系统要求​

事件代理所需的CPU数量和系统内存分配取决于您需要支持的客户端连接数。默认情况下，事件代理的新安装允许多达100个客户端连接。

为了实现所需的稳定性和性能，托管PubSub+软件事件代理的基础设施必须提供一组最低系统资源。系统资源广泛包括与处理器、内存和存储相关的要求。有关所需系统资源类型及其特征的详细信息，请参见系统资源需求。

您可以使用系统缩放参数增加某些系统限制。增加这些系统限制也会增加所需的系统资源。有关更多信息，请参见使用系统缩放参数。

有关配置存储的信息，请参见管理容器镜像存储。

本页上的示例适用于多达1,000个连接的使用，并已适当配置用于测试和PoC活动。如果您计划在生产环境中使用您的事件代理，或将系统扩展到1,000个连接以上，请确保参考上述部分并适当配置您的系统。

第1步：获取PubSub+软件事件代理​

通过以下两个步骤从Docker仓库拉取事件代理镜像：

  1. 启动Docker。

  2. 拉取镜像：

>sudo docker pull solace/solace-pubsub-standard

此示例假设您使用的是Solace PubSub+标准版。如果您想使用其他版本，您需要获得相应的事件代理包：

  1. 转到Solace PubSub+事件代理下载页面。
  2. 滚动到Docker部分，然后选择软件事件代理的版本。
  3. 填写您的详细信息，然后点击获取下载。

将下载名为solace-pubsub-<edition>-<version>-docker.tar.gz的压缩存档文件。

一旦您获得了包，启动Docker并加载镜像。

例如：

>sudo docker load -i /tmp/solace-pubsub-enterprise-<version>-docker.tar.gz

第2步：创建容器​

使用docker create或docker run命令构建事件代理容器时，您可以设置许多选项。以下示例设置了适合测试部署的简单配置。

此示例：

  • 使用Docker Hub上的latest PubSub+标准镜像运行事件代理solace

  • 创建具有全局访问权限的admin用户

  • 将以下事件代理容器端口发布到Ubuntu主机的相同端口：

    • 端口8080 - 启用对容器的SEMP管理流量。当从Broker Manager连接到容器时，请使用此端口（有关更多信息，请参见PubSub+ Broker Manager）。

    • 端口55555 - 启用SMF数据通过容器。

要使用其他服务，您必须发布每个相应的端口。例如，要传递AMQP加密流量，您需要发布端口5671。有关每个服务使用的默认端口的更多信息，请参见软件事件代理的默认配置。

在示例中，storage-group（在容器中映射到/var/lib/solace）被绑定挂载到主机的/mnt/solace。

storage-group至少需要5.1 GB的存储空间。有关更多信息，请参见系统资源需求和管理容器镜像存储。

在创建容器之前，您必须在主机上创建/mnt/solace目录。

要运行容器，请输入以下命令：

>sudo docker run -d -p 8080:8080 -p 55555:55555 --shm-size=1g --env username_admin_globalaccesslevel=admin --env username_admin_password=admin --name=solace --mount type=bind,source=/mnt/solace,destination=/var/lib/solace,ro=false solace/solace-pubsub-standard
  • 如果您从压缩tar存档加载了镜像，请将示例中的solace/solace-pubsub-standard替换为您的镜像对应的仓库和标签。例如，如果您加载了PubSub+企业版版本10.1.0.19，使用solace-pubsub-enterprise:10.1.0.19。

如果您使用的是SELinux并且需要更改挂载到容器中的主机文件或目录的标签，您必须使用--volume参数。--mount参数不支持修改SELinux标签的z或Z选项。有关更多信息，请参见Docker文档中的配置SELinux标签。

第3步：管理PubSub+软件事件代理​

要开始对事件代理发出配置或监控命令，您可以访问Broker Manager或Solace CLI。

要访问PubSub+ Broker Manager：

  1. 打开浏览器并输入http://localhost:8080。
  2. 使用用户名admin和密码admin登录。

要访问Solace CLI：

  1. 输入以下docker exec命令：
>sudo docker exec -it <container_name> /usr/sw/loads/currentload/bin/cli -A
  1. 输入以下命令以进入配置模式：
solace> enable
solace# config
solace(configure)#

有关目前在事件代理上支持的Solace CLI命令列表，请参阅软件事件代理CLI命令。

下一步​

您现在拥有一个具有基本配置的软件事件代理容器，已准备好进行消息任务。

您可以在以下主题中使用额外的配置任务：

  • 软件事件代理的默认配置 - 查看事件代理上运行的服务的默认端口号。
  • 系统资源需求 - 了解软件事件代理的资源需求。
  • 安全概述 - 应用安全特性以保护您的事件代理、系统和数据。

当您熟悉您的事件代理后，您可以使用Solace SDKPerf应用程序测试消息传递。您可以在下载页面的其他软件部分下载SDKPerf。

有关使用您的事件代理的更多信息，请参阅以下内容：

  • PubSub+ Broker Manager
  • 为软件事件代理容器配置Solace CLI
  • SDKPerf
  • 配置容器日志记录
  • 从软件事件代理容器收集诊断信息
  • 使用cloud-init初始化机器映像