[Nur PaaS]{class="badge informative" title="Gilt nur für Adobe Commerce in Cloud-Projekten (von Adobe verwaltete PaaS-Infrastruktur) und lokale Projekte."}

Message Broker (ActiveMQ Artemis)

Adobe Commerce unterstützt außerdem den Open-Source-Nachrichtenbroker ActiveMQ Artemis über das Simple Text Oriented Messaging Protocol (STOMP). Es bietet ein zuverlässiges und skalierbares Messaging-System, das Flexibilität für STOMP-basierte Integrationen bietet.

Nachrichtenwarteschlangen bieten einen asynchronen Kommunikationsmechanismus, bei dem sich Absender und Empfänger einer Nachricht nicht berühren. Sie müssen auch nicht gleichzeitig mit der Nachrichtenwarteschlange kommunizieren. Wenn ein Absender eine Nachricht in eine Warteschlange stellt, wird sie gespeichert, bis der Empfänger sie erhält.

Das Meldungswarteschlangensystem muss vor der Installation von Adobe Commerce eingerichtet werden. Die Grundsequenz ist:

Installieren von Apache ActiveMQ Artemis

Sie können ActiveMQ Artemis entweder mit Docker (für die Entwicklung empfohlen) oder mit der manuellen Installation (für die Produktion empfohlen) installieren.

Option 1: Docker-Installation (für die Entwicklung empfohlen)

Voraussetzungen

Stellen Sie sicher, dass Docker auf Ihrem System installiert ist und ausgeführt wird.

Installationsschritte

Docker-Verwaltungsbefehle

# 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

Zugriff auf Dienste

Sobald der Docker-Container ausgeführt wird, können Sie auf Folgendes zugreifen:

Option 2: Manuelle Installation auf Ubuntu/CentOS

Voraussetzungen

Stellen Sie sicher, dass Java 17 oder höher installiert ist (erforderlich für ActiveMQ Artemis 2.42.0+).

Installationsschritte

Konfigurieren von ActiveMQ Artemis

Lesen Sie die offizielle ActiveMQ Artemis-Dokumentation, um den Broker zu konfigurieren und zu verwalten. Achten Sie auf die folgenden Elemente:

Wichtige Konfigurationsdateien

STOMP-Protokoll aktivieren

Überprüfen Sie /var/lib/artemis-instance/etc/broker.xml , um sicherzustellen, dass der STOMP-Akzeptor konfiguriert ist:

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

Um SSL auf STOMP zu aktivieren, müssen Sie den stomp-ssl explizit hinzufügen.

Mit ActiveMQ Artemis installieren und verbinden

Wenn Sie Adobe Commerce nachdem installieren, fügen Sie während der Installation die folgenden Befehlszeilenparameter hinzu:

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

Dabei gilt:

ActiveMQ Artemis verbinden

Wenn Sie bereits eine Adobe Commerce-Instanz mit einer RabbitMQ (AMQP)-Konfiguration in der <install_directory>/app/etc/env.php haben und Sie sie mit ActiveMQ verbinden möchten, ersetzen Sie den queue-Abschnitt durch STOMP, sodass er in etwa wie folgt aussieht:

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

Sie können die ActiveMQ-Konfigurationswerte auch mithilfe des bin/magento setup:config:set-Befehls festlegen (entfernen Sie die AMQP-Konfiguration, sofern sie in der app/etc/env.php vorhanden ist):

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

Nachdem Sie den Befehl ausgeführt oder die <install_directory>/app/etc/env.php mit STOMP-Konfigurationswerten aktualisiert haben, führen Sie bin/magento setup:upgrade aus, um die Änderungen anzuwenden und die erforderlichen Warteschlangen in ActiveMQ zu erstellen.

Konfigurieren von SSL

Um die Unterstützung für SSL zu konfigurieren, bearbeiten Sie die ssl- und ssl_options in der <install_directory>/app/etc/env.php-Datei so, dass sie den folgenden ähneln:

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

SSL-Entwicklungskonfiguration

Für Entwicklungsumgebungen können Sie entspannte SSL-Einstellungen verwenden:

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

Leistungsoptimierung

ActiveMQ Artemis bietet mehrere Optionen zur Leistungsoptimierung:

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

Überwachung und Verwaltung

Web-Konsole

ActiveMQ Artemis bietet eine Web-basierte Verwaltungskonsole, auf die unter folgender Adresse zugegriffen werden kann:

Fehlerbehebung

Häufige Probleme

STOMP-Verbindung überprüfen

Testen der STOMP-Verbindung mit Telnet:

telnet localhost 61613

Es sollte eine Verbindung hergestellt sein. Testen mit einem STOMP-Befehl:

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

Die erwartete Ausgabe sollte die hergestellte Verbindung und die STOMP-Protokollantwort anzeigen.

Starten der Nachrichtenwarteschlangen-Verbraucher

Nachdem Sie Adobe Commerce und ActiveMQ Artemis verbunden haben, müssen Sie die Nachrichtenwarteschlange für Verbraucher starten. Weitere ​ finden Sie unter " konfigurieren“.