Message Queue (RabbitMQ) Configuration

Shippable Server uses RabbitMQ for Messaging between various components.

You have a few choices of where you want to run RabbitMQ:

  • Fresh installation on the same machine as Installer (Recommended)
  • Fresh installation on a different machine from the Installer
  • Use an existing RabbitMQ instance, either from a previous Shippable installation, or your own instance

Our recommended approach is to install RabbitMQ on the same machine as where you will install Swarm and Microservices. RabbitMQ can also be easily installed on a separate Ubuntu 14.04 machine with the Admiral installer by configuring the Messaging section.

Configuring RabbitMQ for message queue

Installing RabbitMQ

Fresh instance on the same machine

To install RabbitMQ on the same machine as the one where Admiral is installed, select the This Node radio button.

Installing RabbitMQ on the current node

You will need to click the Initialize button after completing other sections.

Fresh instance on a new machine

You can choose to install RabbitMQ on a separate server from the one where Admiral is installed.

To configure this:

Installing RabbitMQ on the current node

  • Select New Node for Messaging in the Initialize infrastructure panel.
  • Choose a password for RabbitMQ.
  • Enter the IP address where you want to install RabbitMQ. This should be an Ubuntu 14.04 machine with ports 443, 5671, 5672, 15671, and 15672 accessible to the other Shippable components and services.
  • Run the command displayed to allow Admiral SSH access to the machine on the machine chosen and check the box to confirm that this step was completed. SSH access is required to run the installation scripts.

You will need to click the Initialize button after completing other sections. Installation progress will be shown on the right side of the Initialize panel.

Connecting to an existing instance

If you have an existing instance of RabbitMQ, either left over from a previous Shippable installation or your own instance, you can reuse that with Shippable Server.

To configure this:

Connecting to an existing RabbitMQ

  • Select Existing for Messaging in the Initialize infrastructure panel.
  • Enter a username and password for RabbitMQ.
  • Enter the IP address of your RabbitMQ instance. This should be an Ubuntu 14.04 machine with ports 443, 5671, 5672, 15671, and 15672 accessible to the other Shippable components and services.
  • Choose the protocol that should be used to connect to RabbitMQ.

You will need to click the Initialize button after completing other sections. Installation progress will be shown on the right side of the Initialize panel.

Viewing configuration

After RabbitMQ is initialized, you'll be able to view the configuration and logs. The Config button for Messaging will show some information about the RabbitMQ location and configuration:

RabbitMQ config

Viewing logs

The Logs button for Messaging will show the logs from installation and initialization.

RabbitMQ logs