[Solo PaaS]{class="badge informative" title="Se aplica solo a proyectos de Adobe Commerce en la nube (infraestructura PaaS administrada por Adobe) y a proyectos locales."}

Agente de mensajes (ActiveMQ Artemis)

Adobe Commerce también es compatible con el agente de mensajes de código abierto ActiveMQ Artemis a través del Protocolo simple de mensajería orientada a texto (STOMP). Ofrece un sistema de mensajería fiable y escalable, que ofrece flexibilidad para integraciones basadas en STOMP.

Las colas de mensajes proporcionan un mecanismo de comunicaciones asincrónico en el que el remitente y el receptor de un mensaje no se ponen en contacto entre sí. Tampoco necesitan comunicarse con la cola de mensajes al mismo tiempo. Cuando un remitente coloca un mensaje en cola, se almacena hasta que el destinatario lo recibe.

Debe establecerse el sistema de cola de mensajes antes de instalar Adobe Commerce. La secuencia básica es:

Instalar Apache ActiveMQ Artemis

Puede instalar ActiveMQ Artemis mediante Docker (recomendado para desarrollo) o instalación manual (recomendado para producción).

Opción 1: instalación de Docker (recomendada para desarrollo)

Requisitos previos

Asegúrese de que Docker esté instalado y en ejecución en el sistema.

Pasos de instalación

Comandos de administración de Docker

# Check container status
docker ps | grep artemis

# View logs
docker logs artemis

# Stop the container
docker stop artemis

# Start the container
docker start artemis

# Remove the container
docker rm artemis

Acceso a servicios

Una vez que se esté ejecutando el contenedor Docker, puede acceder a:

Opción 2: Instalación manual en Ubuntu/CentOS

Requisitos previos

Asegúrese de que Java 17 o superior esté instalado (requerido para ActiveMQ Artemis 2.42.0 o posterior).

Pasos de instalación

Configurar elementos de ActiveMQ

Revise la documentación oficial de ActiveMQ Artemis para configurar y administrar el agente. Preste atención a los siguientes elementos:

Archivos de configuración clave

Habilitar el protocolo STOMP

Compruebe /var/lib/artemis-instance/etc/broker.xml para asegurarse de que el aceptador STOMP está configurado:

<acceptors>
   <acceptor name="artemis">tcp://0.0.0.0:61616?tcpSendBufferSize=1048576;tcpReceiveBufferSize=1048576;amqpMinLargeMessageSize=102400;protocols=CORE,AMQP,STOMP,HORNETQ,MQTT,OPENWIRE;useEpoll=true;amqpCredits=1000;amqpLowCredits=300;amqpDuplicateDetection=true</acceptor>
   <acceptor name="stomp">tcp://0.0.0.0:61613?protocols=STOMP</acceptor>
   <acceptor name="stomp-ssl">tcp://0.0.0.0:61617?protocols=STOMP;sslEnabled=true;keyStorePath=/path/to/keystore.jks;keyStorePassword=password</acceptor>
</acceptors>

Para habilitar SSL en STOMP, debe agregar el aceptador stomp-ssl explícitamente.

Instale con ActiveMQ Artemis y conecte

Si instala Adobe Commerce después de de instalar ActiveMQ Artemis, agregue los siguientes parámetros de línea de comandos durante la instalación:

--stomp-host="<hostname>" --stomp-port="61613" --stomp-user="<user_name>" --stomp-password="<password>"

Donde:

Conectar ActiveMQ Artemis

Si ya tiene una instancia de Adobe Commerce con la configuración de RabbitMQ (AMQP) en el archivo <install_directory>/app/etc/env.php y desea conectarla a ActiveMQ, reemplace la sección queue por la sección STOMP para que sea similar a la siguiente:

'queue' =>
  array (
    'stomp' =>
    array (
      'host' => 'activemq.example.com',
      'port' => '61613',  // SSL STOMP port (default 61617, non-SSL is 61613)
      'user' => 'magento',
      'password' => 'magento',
      // Performance tuning options
      'heartbeat_send' => 10000,     // 10 seconds // Optional
      'heartbeat_receive' => 10000,  // 10 seconds // Optional
      'read_timeout' => 250000       // 250ms // Optional
     ),
  ),

También puede establecer los valores de configuración de ActiveMQ mediante el comando bin/magento setup:config:set (quite la configuración de AMQP si existe en el archivo app/etc/env.php):

bin/magento setup:config:set --stomp-host="activemq.example.com" --stomp-port="61613" --stomp-user="magento" --stomp-password="magento"

Después de ejecutar el comando o actualizar el archivo <install_directory>/app/etc/env.php con valores de configuración STOMP, ejecute bin/magento setup:upgrade para aplicar los cambios y crear las colas necesarias en ActiveMQ.

Configurar SSL

Para configurar la compatibilidad con SSL, edite los parámetros ssl y ssl_options en el archivo <install_directory>/app/etc/env.php de modo que sean similares a los siguientes:

'queue' =>
  array (
    'stomp' =>
    array (
      'host' => 'activemq.example.com',
      'port' => '61617',  // SSL STOMP port (default 61617, non-SSL is 61613)
      'user' => 'magento',
      'password' => 'magento',
      'ssl' => 'true',
      'ssl_options' => [
            'cafile' => '/etc/pki/tls/certs/DigiCertCA.crt',
            'local_cert' => '/path/to/magento/app/etc/ssl/test-activemq.crt', // Optional: Client certificate for mutual SSL
            'local_pk' => '/path/to/magento/app/etc/ssl/test-activemq.key', // Optional: Client private key for mutual SSL
            'passphrase' => 'client_key_password', // Optional: Passphrase for client private key
            'verify_peer' => true,
            'verify_peer_name' => true,
            'allow_self_signed' => false
       ],
      // Performance tuning options
      'heartbeat_send' => 10000,     // 10 seconds // Optional
      'heartbeat_receive' => 10000,  // 10 seconds // Optional
      'read_timeout' => 250000       // 250ms // Optional
     ),
  ),

Opciones de configuración SSL

Configuración SSL de desarrollo

Para entornos de desarrollo, puede utilizar una configuración SSL relajada:

'ssl_options' => [
    'verify_peer' => false,
    'verify_peer_name' => false,
    'allow_self_signed' => true
]

Ajuste del rendimiento

ActiveMQ Artemis ofrece varias opciones de ajuste de rendimiento:

'queue' =>
  array (
    'stomp' =>
    array (
      'host' => 'activemq.example.com',
      'port' => '61613',
      'user' => 'artemis',
      'password' => 'artemis',
      // Performance options
      'heartbeat_send' => 10000,      // Send heartbeat every 10 seconds
      'heartbeat_receive' => 10000,   // Expect heartbeat every 10 seconds
      'read_timeout' => 250000,       // 250ms read timeout
     ),
  ),

Monitorización y administración

consola web

ActiveMQ Artemis proporciona una consola de administración basada en web accesible en:

Resolución de problemas

Problemas comunes

Verificar conexión STOMP

Probar la conexión STOMP con telnet:

telnet localhost 61613

Debería ver una conexión establecida. Para probar con un comando STOMP:

# Test basic STOMP connection
echo -e "CONNECT\nhost:localhost\n\n\x00" | telnet localhost 61613

La salida esperada debe mostrar la conexión establecida y la respuesta del protocolo STOMP.

Iniciar los consumidores de cola de mensajes

Después de conectar Adobe Commerce y ActiveMQ Artemis, debe iniciar los consumidores de cola de mensajes. Consulte Configurar colas de mensajes para obtener más información.