跳到主要内容

适用于Mac的Docker桌面版

本节将指导您如何在macOS上使用Docker Compose和Docker设置单个PubSub+软件事件代理容器。如果您有兴趣在macOS平台上为HA冗余组设置事件代理，请查看macOS的HA组配置。

  • 开始之前
  • 第1步：下载Docker Compose模板
  • 第2步：创建PubSub+软件事件代理
  • 第3步：管理PubSub+软件事件代理
  • 下一步

开始之前​

所示示例使用的是Solace PubSub+标准版，适用于多达100个客户端连接，并已适当配置用于测试和PoC活动。

对于生产用途，我们建议您将storage-group挂载到外部存储设备。这个Docker Compose示例没有这样做。有关如何外部化storage-group的详细信息，请参见管理容器镜像存储。

假设您已具备以下条件：

  • 安装了Docker Desktop for Mac（或等效的桌面容器环境，如Rancher Desktop），并为Docker Desktop for Mac分配了至少2 GiB的内存。有关分配内存和交换空间的更多信息，请参见Docker设置页面。
  • 安装了Git。本示例中使用的Docker Compose模板托管在GitHub上，您可以克隆或下载，地址为：https://github.com/SolaceLabs/solace-single-docker-compose。

第1步：下载Docker Compose模板​

克隆包含Docker Compose模板的GitHub仓库。

git clone https://github.com/SolaceLabs/solace-single-docker-compose.git
cd solace-single-docker-compose/template

第2步：创建PubSub+软件事件代理​

运行以下命令以使用Compose模板创建PubSub+软件事件代理：

docker-compose -f PubSubStandard_singleNode.yml up -d

使用Docker Hub上的latest PubSub+标准镜像（事件代理以支持x86_64和ARM64的多架构镜像发布，适用于配备M系列处理器的Mac设备），Compose模板运行名为pubSubStandardSingleNode的事件代理容器，创建具有全局访问权限的admin用户，并发布以下事件代理容器端口到macOS主机的相同端口：

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

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

在macOS Big Sur及更高版本上，端口55555（软件事件代理的默认SMF端口）被阻塞。如果此端口映射到Docker容器的端口上，容器将无法启动，要么默默失败，要么出现“端口正在使用”错误。为了避免这个问题，Compose模板将主机上的端口55554映射到容器中的端口55555。

要使用其他服务，您可以编辑Compose模板以发布每个相应的端口。例如，要启用TLS上的AMQP，请在Compose模板中取消注释适当的行（- '5671:5671'）。有关每个服务使用的默认端口的更多信息，请参见软件事件代理的默认配置。

容器创建后，事件代理完成激活大约需要60秒。

第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初始化机器映像