Consul Configuration

The following settings impact the configuration of the consul backend for the autocluster plugin:

Consul Scheme

The URI scheme to use when connecting to Consul

Consul Host

The hostname to use when connecting to Consul's API

Consul Port

The port to use when connecting to Consul's API

Consul ACL Token

The Consul access token to use when registering the node with Consul (optional)

Consul Service Address

An IP address or host name to use when registering the service. This is useful when you are testing with a single Consul server instead of having an agent for every RabbitMQ node. If this is specified, the value will automatically be appended to the service ID. (optional)

Consul Service Auto Address

Use the hostname of the current machine for the service address when registering the service with Consul. This is useful when you are testing with a single Consul server instead of having an agent for every RabbitMQ node. If this is enabled, the hostname will automatically be appended to the service ID. (optional)

Consul Service Name

The name of the service to register with Consul for automatic clustering

Consul Service Port

Used to set a port for the service in Consul, allowing for the automatic clustering service registration to double as a general RabbitMQ service registration. Note: Set the CONSUL_SVC_PORT to an empty value to disable port announcement and health checking. For example: CONSUL_SVC_PORT=""

Consul Service TTL

Used to specify the Consul health check TTL interval that is used to let Consul know that RabbitMQ is alive an healthy.

Configuration Details

Setting	Environment Variable	Setting Key	Type	Default
Consul Scheme	CONSUL_SCHEME	consul_scheme	string	http
Consul Host	CONSUL_HOST	consul_host	string	localhost
Consul Port	CONSUL_PORT	consul_port	integer	8500
Consul ACL	CONSUL_ACL	consul_acl	string
Consul Service	CONSUL_SVC	consul_service	string	rabbitmq
Consul Service Address	CONSUL_SVC_ADDR	consul_service_address	string
Consul Service Auto Address	CONSUL_SVC_ADDR_AUTO	consul_service_port	boolean	false
Consul Service Port	``CONSUL_SVC_PORT` `	consul_service_port	integer	5672
Consul Service TTL	CONSUL_SVC_TTL	consul_service_ttl	integer	30

Example rabbitmq.config

[{autocluster,
  [
    {consul_host, "localhost"},
    {consul_port, 8500},
    {consul_acl, "example-acl-token"},
    {consul_svc, "rabbitmq-test"},
    {cluster_name, "test"}
  ]}
].