Skip to main content
On this page

​
Coverage by target cloud

​
How the backends compare

Each row compares a capability of Amazon MQ RabbitMQ Single with its adaptation on each backend. A dash means this row is not stated for that backend.

​
Infrastructure-only adaptation

​
On Google Cloud, Azure, OCI, and Private Kubernetes

​
How it works

Tensor9 deploys the Bitnami RabbitMQ Helm chart on your Kubernetes cluster and puts the broker’s host and port in the generated Amazon MQ outputs. Your application connects straight to that broker over AMQP 0-9-1 and keeps its RabbitMQ client library; Tensor9 is not in the message path. Clients that pin the AWS certificate chain must trust the new broker’s certificate issuer instead. The deployment has 1 broker pod, persistent storage and a Kubernetes Service. Your platform team operates the broker, storage, upgrades and recovery. A disconnected deployment also needs the container images, chart, certificates and other dependencies available locally.

​
Queues and broker configuration

Exchanges, bindings, routing keys, publisher confirms, transactions, consumer acknowledgments, prefetch, dead-letter exchanges and TTL work as they do on Amazon MQ, because the broker is RabbitMQ. When you import definitions, check queue types and enabled plugins against the broker version. Declare quorum queues explicitly, or set the broker’s default queue type. RabbitMQ defaults to classic queues unless you change that default; running RabbitMQ 4.x alone does not select quorum queues. The management HTTP API and console show broker definitions and state. Set broker settings, credentials, TLS and plugins through the Helm chart’s values. This mapping does not need a RabbitmqCluster custom resource or the RabbitMQ Cluster Operator.

​
Single-node deployment and recovery

This deployment runs one broker pod. Its persistent volume keeps messages when the pod is replaced, but no second broker takes client connections while it is down. A quorum queue with one member is unavailable when its only node fails. Use the clustered mapping if your application needs broker failover. Size each persistent volume for the backlog you keep and your recovery needs. Storage availability and backups are separate from broker replication: a replicated queue does not protect against deletion or a wrong retention policy.
The Bitnami RabbitMQ Helm chart deploys 1 broker pod with a persistent volume. There is no second broker or replicated queue member to take over.The Bitnami RabbitMQ Helm chart deploys 1 broker pod with a persistent volume. There is no second broker or replicated queue member to take over.

​
Limitations

Where RabbitMQ on Kubernetes and Amazon MQ differ
  • TLS trust behaves differently. The broker uses a self-signed or cert-manager-issued certificate, not an AWS-managed one. Set up client trust and certificate renewal before you switch endpoints.
  • AWS broker settings are not supported. CloudWatch logs, KMS encryption, the maintenance window, VPC placement and minor-version upgrades are omitted. Use the target environment’s monitoring, storage encryption and upgrade tools instead. Broker credentials and TLS settings are part of the Kubernetes deployment.
  • Streams are not supported. Amazon MQ for RabbitMQ does not offer them, and this mapping does not set them up. The self-operated broker can run Streams if you add them yourself: core stream queues can use AMQP; the RabbitMQ Stream protocol also needs its plugin, listener and a compatible client.
  • ActiveMQ is not supported. This mapping covers the RabbitMQ engine only. Amazon MQ’s ActiveMQ engine uses a different broker and protocols.

​
Other considerations

Moving from AWS. Export exchanges, queues, bindings, users, virtual hosts and policies from the source management API as definitions.json, then import the supported definitions into the new broker. Applications that declare their own topology recreate it when they connect. Messages do not move. Definitions do not include the backlog, and the new broker starts empty. Drain the old broker, or use Shovel or Federation if you need continuity. Deliveries in flight at cutover are not transferred, so test consumer retries. Capacity and monitoring. The broker and its volumes run all the time. Plan capacity from backlog, message sizes, publish and consume rates, and recovery tests on the actual cluster. After cutover, watch disk capacity, queue growth and consumer progress. Provider references: quorum queues, default queue type, and core Streams and the Stream plugin.

​
Debug this service

For requests through a service adapter, use Explain and request diagnostics to investigate the selected mapping. Follow the BYOC service-adapter debugging runbook to capture and interpret the diagnostic evidence. Service Catalog.