[Solo PaaS]{class="badge informative" title="Applicabile solo ai progetti Adobe Commerce on Cloud (infrastruttura PaaS gestita da Adobe) e ai progetti on-premise."}

Gestore messaggi (ActiveMQ Artemis)

Adobe Commerce supporta anche il broker di messaggi open source ActiveMQ Artemis tramite il protocollo STOMP (Simple Text Oriented Messaging Protocol). Fornisce un sistema di messaggistica affidabile e scalabile, offrendo flessibilità per le integrazioni basate su STOMP.

Le code di messaggi forniscono un meccanismo di comunicazione asincrona in cui il mittente e il destinatario di un messaggio non si contattano a vicenda. Non è necessario che comunichino con la coda di messaggi contemporaneamente. Quando un mittente inserisce un messaggio in una coda, questo viene memorizzato fino a quando il destinatario non lo riceve.

Prima di installare Adobe Commerce, è necessario stabilire il sistema della coda di messaggi. La sequenza di base è:

Installare Apache ActiveMQ Artemis

È possibile installare ActiveMQ Artemis utilizzando Docker (consigliato per lo sviluppo) o l'installazione manuale (consigliato per la produzione).

Opzione 1: installazione Docker (consigliata per lo sviluppo)

Prerequisiti

Verificare che Docker sia installato e in esecuzione nel sistema.

Passaggi per l’installazione

Comandi di gestione 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

Accesso ai servizi

Una volta che il contenitore Docker è in esecuzione, puoi accedere a:

Opzione 2: installazione manuale su Ubuntu/CentOS

Prerequisiti

Verificare che sia installato Java 17 o versione successiva (richiesto per ActiveMQ Artemis 2.42.0+).

Passaggi per l’installazione

Configura ActiveMQ Artemis

Consulta la documentazione ufficiale di ActiveMQ Artemis per configurare e gestire il broker. Presta attenzione ai seguenti elementi:

File di configurazione chiave

Abilita protocollo STOMP

Controllare /var/lib/artemis-instance/etc/broker.xml per verificare che l'accettore STOMP sia configurato:

<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>

Per abilitare SSL su STOMP è necessario aggiungere esplicitamente l'accettore stomp-ssl.

Installazione con ActiveMQ Artemis e connessione

Se si installa Adobe Commerce dopo l'installazione di ActiveMQ Artemis, aggiungere i seguenti parametri della riga di comando durante l'installazione:

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

Dove:

Connetti ActiveMQ Artemis

Se nel file <install_directory>/app/etc/env.php è già presente un'istanza di Adobe Commerce con configurazione RabbitMQ (AMQP) e si desidera connetterla ad ActiveMQ, sostituire la sezione queue con STOMP in modo che sia simile alla seguente:

'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
     ),
  ),

È inoltre possibile impostare i valori di configurazione ActiveMQ utilizzando il comando bin/magento setup:config:set (rimuovere la configurazione AMQP se esiste nel file app/etc/env.php):

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

Dopo aver eseguito il comando o aggiornato il file <install_directory>/app/etc/env.php con i valori di configurazione STOMP, eseguire bin/magento setup:upgrade per applicare le modifiche e creare le code richieste in ActiveMQ.

Configurare SSL

Per configurare il supporto per SSL, modificare i parametri ssl e ssl_options nel file <install_directory>/app/etc/env.php in modo che siano simili ai seguenti:

'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
     ),
  ),

Opzioni di configurazione SSL

Configurazione SSL di sviluppo

Per gli ambienti di sviluppo, puoi utilizzare impostazioni SSL flessibili:

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

Ottimizzazione delle prestazioni

ActiveMQ Artemis offre diverse opzioni di ottimizzazione delle prestazioni:

'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
     ),
  ),

Monitoraggio e gestione

Console web

ActiveMQ Artemis fornisce una console di gestione basata su Web accessibile da:

Risoluzione dei problemi

Problemi comuni

Verifica connessione STOMP

Verifica connessione STOMP tramite telnet:

telnet localhost 61613

Dovresti vedere una connessione stabilita. Per eseguire il test con un comando STOMP:

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

L’output previsto deve mostrare la connessione stabilita e la risposta del protocollo STOMP.

Avvia i consumer della coda di messaggi

Dopo aver connesso Adobe Commerce e ActiveMQ Artemis, è necessario avviare i consumer della coda messaggi. Per ulteriori informazioni, vedere Configurare le code dei messaggi.