57 lines
2.0 KiB
Markdown
57 lines
2.0 KiB
Markdown
# RabbitMQ Peer Discovery AWS
|
|
|
|
This is an AWS-based implementation of RabbitMQ [peer discovery interface](https://www.rabbitmq.com/blog/2018/02/12/peer-discovery-subsystem-in-rabbitmq-3-7/)
|
|
(new in 3.7.0, previously available in the [rabbitmq-autocluster plugin](https://github.com/rabbitmq/rabbitmq-autocluster)
|
|
by Gavin Roy).
|
|
|
|
This plugin only performs peer discovery and most basic node health monitoring
|
|
using AWS (EC2) APIs as data source.
|
|
Please get familiar with [RabbitMQ clustering fundamentals](https://rabbitmq.com/clustering.html) before attempting
|
|
to use it.
|
|
|
|
While it may seem at times that this is a RabbitMQ cluster management solution,
|
|
it is not. Cluster provisioning and most of Day 2 operations such as [proper monitoring](https://rabbitmq.com/monitoring.html)
|
|
are not in scope for this plugin.
|
|
|
|
|
|
## Supported RabbitMQ Versions
|
|
|
|
This plugin requires RabbitMQ 3.7.0 or later.
|
|
|
|
For a AWS-based peer discovery and cluster formation
|
|
mechanism that supports 3.6.x, see [rabbitmq-autocluster](https://github.com/rabbitmq/rabbitmq-autocluster).
|
|
|
|
|
|
## Installation
|
|
|
|
This plugin ships with [supported RabbitMQ versions](https://www.rabbitmq.com/versions.html).
|
|
There is no need to install it separately.
|
|
|
|
As with any [plugin](https://rabbitmq.com/plugins.html), it must be enabled before it
|
|
can be used. For peer discovery plugins it means they must be [enabled](https://rabbitmq.com//plugins.html#basics) or [preconfigured](https://rabbitmq.com//plugins.html#enabled-plugins-file)
|
|
before first node boot:
|
|
|
|
```
|
|
rabbitmq-plugins --offline enable rabbitmq_peer_discovery_aws
|
|
```
|
|
|
|
|
|
## Documentation
|
|
|
|
See [RabbitMQ Cluster Formation guide](https://www.rabbitmq.com/cluster-formation.html).
|
|
|
|
|
|
## Contributing
|
|
|
|
See [CONTRIBUTING.md](./CONTRIBUTING.md) and our [development process overview](https://www.rabbitmq.com/github.html).
|
|
|
|
|
|
## License
|
|
|
|
[Licensed under the MPL](LICENSE-MPL-RabbitMQ), same as RabbitMQ server.
|
|
|
|
|
|
## Copyright
|
|
|
|
(c) 2007-2025 Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
|