4.14. 为 AMQP 消息配置大型消息处理


客户端可能会发送可能会超过代理内部缓冲区大小的大型 AMQP 消息,从而导致意外错误。要防止这种情况,您可以将代理配置为当消息大于指定最小值时将消息存储为文件。以这种方式处理大型消息意味着代理不会在内存中保存消息。相反,代理会将消息存储在用于存储大型消息文件的专用目录中。

对于 OpenShift Container Platform 上的代理部署,大型消息目录为 /opt/ <custom_resource_name> /data/large-messages,代理用于消息存储的持久性卷(PV)。当代理将消息存储为大消息时,队列会在大型消息目录中保留对文件的引用。

注意

您只能在 AMQP 协议的代理配置中配置大型消息大小限制。对于 AMQ Core 和 Openwire 协议,您可以在客户端连接配置中配置大量消息大小限制。如需更多信息,请参阅 Red Hat AMQ 客户端文档

4.14.1. 为大型消息处理配置 AMQP 接受器

以下流程演示了如何配置接受者来处理大于指定大小的 AMQP 消息作为大消息。

先决条件

流程

  1. 打开您之前在其中定义 AMQP 接受器的自定义资源(CR)实例。

    1. 使用 OpenShift 命令行界面:

      $ oc edit -f <path/to/custom_resource_instance>.yaml
    2. 使用 OpenShift Container Platform Web 控制台:

      1. 在左侧导航菜单中点 Administration Custom Resource Definitions
      2. 单击 ActiveMQArtemis CRD。
      3. Instances 选项卡。
      4. 找到与项目命名空间对应的 CR 实例。

    之前配置的 AMQP 接受者可能类似如下:

    spec:
    ...
      acceptors:
      - name: my-acceptor
        protocols: amqp
        port: 5672
        connectionsAllowed: 5
        expose: true
        sslEnabled: true
    ...
  2. 指定代理作为大消息处理的 AMQP 消息的最小大小(以字节为单位)。例如:

    spec:
    ...
      acceptors:
      - name: my-acceptor
        protocols: amqp
        port: 5672
        connectionsAllowed: 5
        expose: true
        sslEnabled: true
        amqpMinLargeMessageSize: 204800
        ...
    ...

    在上例中,代理配置为接受端口 5672 上的 AMQP 消息。根据 amqpMinLargeMessageSize 的值,如果接受者收到一个大于或等于 204800 字节的正文的 AMQP 消息(即 200 KB),代理将消息存储为大消息。

    代理将消息存储在大型消息目录中(/opt/ &lt;custom_resource_name> /data/large-messages,默认为代理用于消息存储的持久性卷(PV))。

    如果您没有为 amqpMinLargeMessageSize 属性显式指定值,代理会使用默认值 102400 (即 100 KB)。

    如果将 amqpMinLargeMessageSize 设置为 -1,则 AMQP 消息的大量消息处理被禁用。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.