[Endast PaaS]{class="badge informative" title="Gäller endast Adobe Commerce i molnprojekt (Adobe-hanterad PaaS-infrastruktur) och lokala projekt."}

Message Broker (ActiveMQ Artemis)

Adobe Commerce stöder även ActiveMQ Artemis-meddelandehanterare med öppen källkod via STOMP (Simple Text Oriented Messaging Protocol). Det är ett tillförlitligt och skalbart meddelandesystem som ger flexibilitet för STOMP-baserade integreringar.

Meddelandeköer är en asynkron kommunikationsmekanism där avsändaren och mottagaren av ett meddelande inte kontaktar varandra. De behöver inte heller kommunicera med meddelandekön samtidigt. När en avsändare placerar ett meddelande i en kö lagras det tills mottagaren tar emot det.

Meddelandekösystemet måste upprättas innan du kan installera Adobe Commerce. Grundordningen är:

Installera ActiveMQ-objekt för Apache

Du kan installera ActiveMQ Artemis med Docker (rekommenderas för utveckling) eller manuell installation (rekommenderas för produktion).

Alternativ 1: Dockerinstallation (rekommenderas för utveckling)

Förutsättningar

Kontrollera att Docker är installerat och körs på datorn.

Installationssteg

Dockningshanteringskommandon

# 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

Åtkomst till tjänster

När Docker-behållaren är igång kan du komma åt:

Alternativ 2: Manuell installation på Ubuntu/CentOS

Förutsättningar

Kontrollera att Java 17 eller senare är installerat (krävs för ActiveMQ Artemis 2.42.0+).

Installationssteg

Konfigurera ActiveMQ-objekt

Läs den officiella ActiveMQ Artemis-dokumentationen för att konfigurera och hantera mäklaren. Observera följande:

Nyckelkonfigurationsfiler

Aktivera STOMP-protokoll

Kontrollera /var/lib/artemis-instance/etc/broker.xml för att kontrollera att STOMP-godkännare har konfigurerats:

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

Om du vill aktivera SSL på STOMP måste du lägga till stomp-ssl-godkännaren explicit.

Installera med ActiveMQ Artemis och anslut

Om du installerar Adobe Commerce efter att du har installerat ActiveMQ Artemis lägger du till följande kommandoradsparametrar under installationen:

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

Var:

Connect ActiveMQ Artemis

Om du redan har en Adobe Commerce-instans med konfigurationen RabbitMQ (AMQP) i filen <install_directory>/app/etc/env.php och du vill ansluta den till ActiveMQ ersätter du avsnittet queue med STOMP så att det liknar följande:

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

Du kan också ange ActiveMQ-konfigurationsvärden med kommandot bin/magento setup:config:set (ta bort AMQP-konfigurationen om den finns i filen app/etc/env.php):

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

När du har kört kommandot eller uppdaterat filen <install_directory>/app/etc/env.php med STOMP-konfigurationsvärden kör du bin/magento setup:upgrade för att tillämpa ändringarna och skapa de nödvändiga köerna i ActiveMQ.

Konfigurera SSL

Om du vill konfigurera stöd för SSL redigerar du parametrarna ssl och ssl_options i filen <install_directory>/app/etc/env.php så att de liknar följande:

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

SSL-konfiguration för utveckling

I utvecklingsmiljöer kan du använda avspända SSL-inställningar:

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

Prestandajustering

ActiveMQ Artemis har flera alternativ för prestandajustering:

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

Övervakning och hantering

Webbkonsol

ActiveMQ Artemis har en webbaserad hanteringskonsol som är tillgänglig på:

Felsökning

Vanliga problem

Verifiera STOMP-anslutning

Testa STOMP-anslutning med telnet:

telnet localhost 61613

En anslutning bör upprättas. Så här testar du med ett STOMP-kommando:

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

Förväntade utdata ska visa upprättad anslutning och STOMP-protokollsvar.

Starta meddelandekökonsumenterna

När du har anslutit Adobe Commerce och ActiveMQ Artemis måste du starta meddelandets kunder. Mer information finns i Konfigurera meddelandeköer.