CLI: Message Queue Management
Manage message queues with the agentmetal queue subcommand.
CLI: Message Queue Management
Overview
The agentmetal queue subcommand manages message queue clusters for asynchronous communication between services. Two engines are supported: RabbitMQ (AMQP) and NATS (high-performance messaging).
Operations
Create a Queue Cluster
agentmetal queue create \
--name events \
--engine rabbitmq \
--nodes 3 \
--ha
| Flag | Required | Description |
|---|---|---|
--name | Yes | Queue cluster name |
--engine | Yes | Engine: rabbitmq or nats |
--nodes | No | Number of nodes (default: 1) |
--ha | No | Enable high availability / clustering (default: false) |
--version | No | Engine version |
--tls | No | Enable TLS for connections (default: false) |
--management | No | Enable management UI (RabbitMQ only, default: true) |
agentmetal queue list
ID NAME ENGINE NODES HA STATE
queue-a1b2 events rabbitmq 3 yes running
queue-c3d4 stream nats 3 yes running
Get / Delete
agentmetal queue get queue-a1b2
agentmetal queue delete queue-a1b2
Examples
Create an HA RabbitMQ cluster:
agentmetal queue create \
--name production-mq \
--engine rabbitmq \
--nodes 3 \
--ha \
--tls \
--management
Create a NATS cluster:
agentmetal queue create \
--name event-stream \
--engine nats \
--nodes 3 \
--ha \
--tls
MessageQueueSpec Fields
| Field | Type | Description |
|---|---|---|
engine | string | rabbitmq or nats |
version | string | Engine version |
node_count | int | Number of nodes in the cluster |
ha_enabled | bool | High availability mode |
management_ui | bool | Enable management web UI |
tls_enabled | bool | Enable TLS encryption |