4.9. 为 AMQP 消息配置大型消息处理
客户端可能会发送超过代理内部缓冲大小的大型 AMQP 信息,从而导致意外错误。要防止这种情况,您可以将代理配置为在消息大于指定最小值时存储信息。以这种方式处理大型消息意味着代理不会在内存中保存消息。相反,代理将信息存储在用于存储大型消息文件的专用目录中。
对于 OpenShift Container Platform 上的代理部署,大型消息目录为 /opt/ <custom_resource_name> /data/large-messages
on the Persistent Volume(PV)用于消息存储。当代理将消息存储为大消息时,队列会保留对大型消息目录中的文件的引用。
对于 AMQ Broker 7.10 中的基于 Operator 的代理部署,大型消息处理仅适用于 AMQP 协议。
4.9.1. 为大型消息处理配置 AMQP 接受器 复制链接链接已复制到粘贴板!
以下流程演示了如何配置接受器来处理大于指定大小作为较大消息的 AMQP 消息。
先决条件
- 您应该熟悉如何为基于 Operator 的代理部署配置接收器。请参阅 第 4.8.1 节 “配置接收器”。
要将大型 AMQP 消息存储在专用的大型消息目录中,代理部署必须使用持久性存储(即,在用于创建部署的自定义资源(CR)实例中将
persistenceEnabled
设为true
)。有关配置持久性存储的更多信息,请参阅:
流程
打开您之前定义 AMQP acceptor 的自定义资源(CR)实例。
使用 OpenShift 命令行界面:
oc edit -f <path/to/custom_resource_instance>.yaml
$ oc edit -f <path/to/custom_resource_instance>.yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用 OpenShift Container Platform Web 控制台:
-
在左侧导航菜单中点
-
单击
ActiveMQArtemis
CRD。 -
点
Instances
选项卡。 - 查找与项目命名空间对应的 CR 实例。
-
在左侧导航菜单中点
之前配置的 AMQP 接受程序可能类似如下:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 指定代理作为较大消息的 AMQP 消息的最小大小,以字节为单位。例如:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在前面的示例中,代理配置为接受端口 5672 上的 AMQP 信息。根据
amqpMinLargeMessageSize
的值,如果 acceptor 收到一个大于 204800 字节的 AMQP 消息(即 200 KB),代理会将消息存储为大消息。代理将消息存储在大型消息目录中(
/opt/ <custom_resource_name> /data/large-messages
,默认为代理用于消息存储的持久性卷(PV))。如果您没有显式指定
amqpMinLargeMessageSize
属性的值,则代理使用默认值 102400(即 100 KB)。如果将
amqpMinLargeMessageSize
设置为-1
,则会禁用 AMQP 消息的大型消息处理。