[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

メッセージ ブローカ （ActiveMQ Artemis）

Adobe Commerceは、Simple Text Oriented Messaging Protocol （STOMP）を介した ActiveMQ Artemis オープンソースメッセージブローカーもサポートしています。 信頼性と拡張性に優れたメッセージングシステムを提供し、STOMP ベースの統合に柔軟性を提供します。

メッセージキューは、メッセージの送信者と受信者が互いに接触しない非同期通信メカニズムを提供します。 また、メッセージキューと同時に通信する必要もありません。 送信者がメッセージをキューに入れると、受信者が受信するまで保存されます。

Adobe Commerceをインストールする前に、メッセージキューシステムを確立する必要があります。 基本的なシーケンスは次のとおりです。

Apache ActiveMQ Artemis のインストール

ActiveMQ Artemis は、Docker （開発用に推奨）または手動インストール（実稼動用に推奨）を使用してインストールできます。

オプション 1:Docker のインストール（開発用に推奨）

前提条件

Docker がシステムにインストールされ、実行されていることを確認します。

インストール手順

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

サービスへのアクセス

Docker コンテナが実行されると、次の場所にアクセスできます。

オプション 2:Ubuntu/CentOS での手動インストール

前提条件

Java 17 以降がインストールされていることを確認します（ActiveMQ Artemis 2.42.0 以降で必要）。

インストール手順

ActiveMQ Artemis の設定

公式の ActiveMQ Artemis ドキュメントを参照して、ブローカーを設定および管理します。 次の項目に注意してください。

主要な設定ファイル

STOMP プロトコルを有効にする

/var/lib/artemis-instance/etc/broker.xml をチェックして、STOMP アクセプターが設定されていることを確認します。

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

STOMP で SSL を有効にするには、stomp-ssl アクセプターを明示的に追加する必要があります。

ActiveMQ Artemis を使用してインストールし、接続します。

Adobe Commerce after をインストールして ActiveMQ Artemis をインストールする場合は、インストール時に次のコマンドラインパラメーターを追加します。

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

ここで、

ActiveMQ Artemis の接続

<install_directory>/app/etc/env.php ファイルに RabbitMQ （AMQP）設定のAdobe Commerce インスタンスが既にあり、それを ActiveMQ に接続する場合は、queue のセクションを STOMP に置き換えて、次のようになります。

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

bin/magento setup:config:set コマンドを使用して ActiveMQ 設定値を設定することもできます（app/etc/env.php ファイルに AMQP 設定が存在する場合は、その設定を削除します）。

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

コマンドを実行するか、STOMP 設定値で <install_directory>/app/etc/env.php ファイルを更新した後、bin/magento setup:upgrade を実行して変更を適用し、ActiveMQ で必要なキューを作成します。

SSL を設定

SSL のサポートを設定するには、ssl ファイルの ssl_options パラメーターと <install_directory>/app/etc/env.php パラメーターを次のように編集します。

'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 設定オプション

開発 SSL 設定

開発環境の場合、リラックスした SSL 設定を使用できます。

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

パフォーマンスチューニング

ActiveMQ Artemis には、パフォーマンス調整オプションがいくつか用意されています。

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

監視と管理

Web コンソール

ActiveMQ Artemis は、次の場所からアクセス可能な web ベースの管理コンソールを提供します。

トラブルシューティング

よくある問題

STOMP 接続の検証

telnet を使用して STOMP 接続をテストします。

telnet localhost 61613

接続が確立されているのが確認できます。 STOMP コマンドを使用してテストするには、次の手順に従います。

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

期待される出力では、接続が確立され、STOMP プロトコル応答が示されます。

メッセージキューコンシューマーの開始

Adobe Commerceと ActiveMQ Artemis を接続したら、メッセージキューコンシューマーを起動する必要があります。 詳しくは、​ メッセージキューの設定 ​ を参照してください。