PaaS만

Amazon 메시지 큐 설정

마지막 업데이트: 2025년 5월 5일

작성 대상:

  • 경험
  • 관리자
  • 개발자

Commerce 2.4.3부터 Amazon 메시지 큐(MQ)를 온-프레미스 메시지 큐 인스턴스에 대한 클라우드 기반 대체 인스턴스로 사용할 수 있습니다.

AWS에서 메시지 큐를 만들려면 AWS 설명서 ​에서 Amazon MQ 설정을 참조하세요.

AWS MQ용 Commerce 구성

AWS MQ 서비스에 연결하려면 env.php 파일에서 queue.amqp 개체를 구성하십시오.
AWS 메시지 큐에는 SSL/TLS 연결이 필요합니다.

'queue' => [
    'amqp' => [
        'host' => '[host]', //example: c-bf4kk1c5-5gcc-4b43-9b9e-8f5b54d234.mq.us-west-3.amazonaws.com
        'port' => 5671,
        'user' => 'yourusername',
        'password' => 'yourpassword',
        'virtualhost' => '/',

        // AWS fields to add
        'ssl' => 'true'
    ]
],

위치:

  • host - AMQP 끝점의 URL입니다. AWS에서 브로커 이름을 클릭하면 사용할 수 있습니다("https://" 및 후행 포트 번호 제거).
  • user—AWS MQ 브로커를 만들 때 입력한 사용자 이름 값
  • password—AWS MQ 브로커를 만들 때 입력한 암호 값
정보
Amazon MQ는 TLS 연결만 지원합니다. 피어 확인은 지원되지 않습니다.

env.php 파일을 편집한 후 다음 명령을 실행하여 설치를 완료합니다.

bin/magento setup:upgrade

Commerce에서 AWS MQ 서비스를 사용하는 방법

async.operations.all 메시지 대기열 소비자가 AMQP 연결을 사용합니다.

이 소비자는 AWS MQ 연결을 통해 async 접두사가 붙은 모든 항목 이름을 라우팅합니다.

예를 들어 InventoryCatalog에는 다음과 같은 항목이 있습니다.

async.V1.inventory.bulk-product-source-assign.POST
async.V1.inventory.bulk-product-source-unassign.POST
async.V1.inventory.bulk-product-source-transfer.POST

InventoryCatalog에 대한 기본 구성은 RabbitMQ에 메시지를 게시하지 않습니다. 기본 동작은 동일한 사용자 스레드에서 작업을 수행하는 것입니다. InventoryCatalog에게 메시지를 게시하도록 하려면 cataloginventory/bulk_operations/async을(를) 사용하도록 설정하십시오. 관리자의 경우 스토어 > 구성 > 카탈로그 > 인벤토리 > 관리 대량 작업으로 이동하여 Run asynchronously을(를) 예(으)로 설정합니다.