[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Berichtenmakelaar (ActiveMQ Artemis)

Adobe Commerce ondersteunt ook de open-source berichtbroker van ActiveMQ Artemis via het Simple Text Oriented Messaging Protocol (STOMP). Het levert een betrouwbaar en scalable overseinensysteem, dat flexibiliteit voor op STOMP-Gebaseerde integratie biedt.

De rijen van het bericht verstrekken een asynchroon communicatie mechanisme waarin de afzender en de ontvanger van een bericht niet elkaar contacteren. Noch moeten zij met de berichtrij tezelfdertijd communiceren. Wanneer een afzender een bericht in een rij plaatst, wordt het opgeslagen tot de ontvanger hen ontvangt.

Het systeem van de berichtrij moet worden gevestigd alvorens u Adobe Commerce installeert. De basisvolgorde is:

Apache ActiveMQ Artemis installeren

U kunt ActiveMQ-artemis installeren met Docker (aanbevolen voor ontwikkeling) of met de hand (aanbevolen voor productie).

Optie 1: Docker-installatie (aanbevolen voor ontwikkeling)

Vereisten

Controleer of Docker op uw systeem is geïnstalleerd en wordt uitgevoerd.

Installatiestappen

Opdrachten voor Docker-beheer

# 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

Toegang tot diensten

Zodra de container van de Dokker loopt, kunt u tot:

Optie 2: Handmatige installatie op Ubuntu/CentOS

Vereisten

Controleer of Java 17 of hoger is geïnstalleerd (vereist voor ActiveMQ Artemis 2.42.0+).

Installatiestappen

ActiveMQ-artemis configureren

Controleer de officiële documentatie van de Artemis ActiveMQ om de makelaar te vormen en te beheren. Let op het volgende:

Belangrijkste configuratiebestanden

STOMP-protocol inschakelen

Controleer /var/lib/artemis-instance/etc/broker.xml om te controleren of de STOMP-acceptor is geconfigureerd:

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

Als u SSL wilt inschakelen bij STOMP, moet u de stomp-ssl -acceptor expliciet toevoegen.

Installeren met ActiveMQ-arrays en verbinding maken

Als u Adobe Commerce na installeert u Artemis ActiveMQ, voeg de volgende bevel-lijn parameters tijdens installatie toe:

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

Waarbij:

Connect ActiveMQ-artemis

Als het <install_directory>/app/etc/env.php -bestand al een Adobe Commerce-instantie bevat met de configuratie RabbitMQ (AMQP) en u wilt deze verbinding maken met ActiveMQ, vervangt u de sectie queue door STOMP, zodat deze op het volgende lijkt:

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

U kunt ActiveMQ-configuratiewaarden ook instellen met de opdracht bin/magento setup:config:set (verwijder de AMQP-configuratie als deze bestaat in het app/etc/env.php -bestand):

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

Nadat u de opdracht hebt uitgevoerd of het <install_directory>/app/etc/env.php -bestand met STOMP-configuratiewaarden hebt bijgewerkt, voert u bin/magento setup:upgrade uit om de wijzigingen toe te passen en de vereiste wachtrijen in ActiveMQ te maken.

SSL configureren

Als u ondersteuning voor SSL wilt configureren, bewerkt u de parameters ssl en ssl_options in het <install_directory>/app/etc/env.php -bestand, zodat deze op het volgende lijken:

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

SSL-configuratieopties

SSL-configuratie voor ontwikkeling

Voor ontwikkelomgevingen kunt u ontspannen SSL-instellingen gebruiken:

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

Prestaties afstemmen

ActiveMQ Artemis biedt verschillende opties voor het afstemmen van prestaties:

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

Toezicht en beheer

Webconsole

ActiveMQ Artemis biedt een webgebaseerde beheerconsole die toegankelijk is op:

Problemen oplossen

Algemene kwesties

STOMP-verbinding controleren

STOMP-verbinding testen met Telnet:

telnet localhost 61613

Er moet een verbinding tot stand worden gebracht. Testen met een STOMP-opdracht:

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

De verwachte output zou verbinding gevestigd en STOMP protocolreactie moeten tonen.

Gebruikers in de wachtrij met berichten starten

Nadat u Adobe Commerce en ActiveMQ Artemis hebt aangesloten, moet u de gebruikers van de berichtrij beginnen. Zie ​ berichtrijen ​ voor details vormen.