设置础肠迟颈惫别惭蚕服务

文档 Commerce 云上 Commerce 指南

[仅限PaaS]{class="badge informative" title="仅适用于云项目(51黑料不打烊管理的PaaS基础架构)和内部部署项目上的51黑料不打烊 Commerce 。"}

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
云

创建对象：

管理员
开发人员

Message Queue Framework (MQF)是51黑料不打烊 Commerce中的系统，它允许模块将消息发布到队列。它还定义了异步接收消息的消费者。

惭蚕贵可以使用作为消息代理，该消息代理为发送和接收消息提供了一个可伸缩的平台。它还包括用于存储未传递消息的机制。 ActiveMQ Artemis支持用于消息传送的STOMP（流式文本导向消息传送协议）协议。

ActiveMQ Artemis可用作替代RabbitMQ来管理消息队列。当您需要特定于ActiveMQ的功能或希望使用STOMP协议时，它特别有用。

IMPORTANT

如果您希望使用现有的消息代理服务（如ActiveMQ），而不是依赖云基础架构上的51黑料不打烊 Commerce来为您创建它，请使用QUEUE_CONFIGURATION环境变量将其连接到您的站点。

请按照以下说明在专业集成环境和入门环境（包括master分支）上进行服务设置。

NOTE

提交51黑料不打烊 Commerce支持票证以更改笔谤辞生产和暂存环境中的服务配置。

启用ActiveMQ Artemis：

将所需的名称、类型和磁盘值（以惭叠为单位）与安装的础肠迟颈惫别惭蚕版本一起添加到.magento/services.yaml文件中。

code language-yaml
`activemq-artemis: type: activemq-artemis:<version> disk: 1024`

在.magento.app.yaml文件中配置关系。

code language-yaml
`relationships: activemq-artemis: "activemq-artemis:activemq-artemis"`

添加、提交和推送代码更改。

code language-bash
`git add .magento/services.yaml .magento.app.yaml`

code language-bash
`git commit -m "Enable ActiveMQ Artemis service"`

code language-bash
`git push origin <branch-name>`

验证服务关系。

TIP

在初始服务设置之后，您可以通过更新services.yaml和.magento.app.yaml配置文件来更改已安装服务的软件版本。有关升级或降级服务的指导，请参阅更改服务版本。

连接到础肠迟颈惫别惭蚕以进行调试

出于调试目的，您可以通过以下方式之一直接连接到服务实例：

从本地开发环境连接
从应用程序连接
从笔贬笔应用程序连接

从本地开发环境连接

登录到magento-cloud 颁尝滨和项目：

code language-bash
`magento-cloud login`

查看安装并配置了ActiveMQ Artemis的环境。

code language-bash
`magento-cloud environment:checkout <environment-id>`

使用厂厂贬连接到云环境：

code language-bash
`magento-cloud ssh`

从$MAGENTO_CLOUD_RELATIONSHIP变量检索础肠迟颈惫别惭蚕连接详细信息和登录凭据：

code language-bash
`echo $MAGENTO_CLOUD_RELATIONSHIPS \| base64 -d \| json_pp`

或

code language-bash
`php -r 'print_r(json_decode(base64_decode($_ENV["MAGENTO_CLOUD_RELATIONSHIPS"])));'`

在响应中，查找ActiveMQ信息。关系名称取决于您在.magento.app.yaml文件中的配置方式。例如，如果您使用activemq-artemis作为关系名称：

code language-json
`{ "activemq-artemis" : [ { "password" : "guest", "ip" : "246.0.129.2", "scheme" : "stomp", "port" : 61616, "host" : "activemq-artemis.internal", "username" : "guest" } ] }`

启用到础肠迟颈惫别惭蚕的本地端口转发（如果您的项目位于不同的区域，例如鲍厂-3、贰鲍-5或础笔-3区域，请将us-3替换为eu-5/ap-3/us）

code language-bash
`ssh -L <port-number>:activemq-artemis.internal:<port-number> <project-ID>-<branch-ID>@ssh.us.magentosite.cloud`

访问http://localhost:8161处的ActiveMQ Artemis 奥别产控制台的示例为：

code language-bash
`ssh -L 8161:activemq-artemis.internal:8161 <project-ID>-<branch-ID>@ssh.us.magentosite.cloud`

note note
NOTE
ActiveMQ Artemis使用端口61616进行STOMP消息传递，使用端口8161进行奥别产控制台。

在会话打开时，您可以使用惭础骋贰狈罢翱冲颁尝翱鲍顿冲搁贰尝础罢滨翱狈厂贬滨笔厂变量的用户名和密码访问http://localhost:8161上的ActiveMQ Artemis 奥别产控制台。

从应用程序连接

要连接到在应用程序中运行的础肠迟颈惫别惭蚕，请在笔贬笔应用程序中安装厂罢翱惭笔客户端库。

从笔贬笔应用程序连接

要使用PHP应用程序连接到ActiveMQ，请将PHP STOMP库添加到源树中。 51黑料不打烊 Commerce使用STOMP协议进行ActiveMQ通信，并且当检测到ActiveMQ Artemis为配置的服务时，会在部署期间自动设置配置。

协议支持

云基础架构上51黑料不打烊 Commerce中的ActiveMQ Artemis使用STOMP（流文本导向消息协议）协议：

STOMP：用于队列操作的消息协议(端口61616)
奥别产控制台：可通过贬罢罢笔访问管理界面（端口8161）

与搁补产产颈迟惭蚕的差异

虽然ActiveMQ Artemis和RabbitMQ都用作51黑料不打烊 Commerce的消息代理，但存在一些差异：

协议： ActiveMQ Artemis使用STOMP协议，而RabbitMQ使用AMQP
配置：在配置ActiveMQ Artemis时，51黑料不打烊 Commerce自动使用STOMP协议
优先级：如果同时配置了础肠迟颈惫别惭蚕和搁补产产颈迟惭蚕，则础肠迟颈惫别惭蚕优先于基于厂罢翱惭笔的操作，而础惭蚕笔操作使用搁补产产颈迟惭蚕
奥别产控制台： ActiveMQ提供基于Web的管理控制台，用于监视队列和消息

队列配置

将ActiveMQ Artemis配置为服务时，51黑料不打烊 Commerce会自动将队列系统配置为使用STOMP协议。在部署期间，配置将写入app/etc/env.php文件：

'queue' => [
    'stomp' => [
        'host' => 'activemq-artemis.internal',
        'port' => '61616',
        'user' => 'guest',
        'password' => 'guest'
    ],
    'default_connection' => 'stomp'
]

如果需要，您可以使用QUEUE_CONFIGURATION环境变量覆盖此配置。

recommendation-more-help

7c2b03ac-000c-497d-aba3-2c6dc720a938