Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
userdata
README.md
compute.tf
env-vars
network.tf
outputs.tf
provider.tf
variables.tf

README.md

Bitnami RabbitMQ Cluster

This solution uses multiple instances on OCI to provision a cluster that functions as a single logical broker.

Using this solution

The Get Started Guide with Bitnami Terraform Templates on OCI walks you though the process of using the Terraform Provider plugin and the Terraform CLI to deploy the Bitnami MySQL with replication on an Oracle Cloud Infrastructure server. You will find there how to configure the Terraform CLI, the OCI plugin and how to configure it with your OCI account.

TL;DR;

terraform init
terraform apply

Initialize the working directory

terraform init

Replace the OCI account parameters in the env-vars file. Source it before you plan, apply, or destroy the configuration:

. env-vars

Deploy the cluster

terraform apply

You can modify some default values of the deployment such as:

  • Name of the deployment.
  • Number of nodes to deploy.
  • Size of the instances.
  • Size of the data volume in GBs.

For instance, to use a custom name for the deployment add the following line to the env-vars file:

export TF_VAR_deployment_short_name="a_name"

Wait until the deployment is ready. It can take up to 15 minutes to finish. Then, you will see the Output section of the deployment which contains:

  • Application password (hidden).
  • Instance names.
  • Oracle Linux base image.
  • Private IPs.
  • Public IPs.

How to scale the cluster

To change the number of nodes in your cluster, execute the "apply" command changing the number of nodes of the deployment:

terraform apply -var nodes_count=<number_of_nodes>

How to upgrade the instances

You can execute the "apply" command. If a new Oracle Linux 7.5 base image is detected, the instances are destroyed and relaunched. All the data of the application is persisted in a different volume that is reattached so there is no data loss.

terraform apply

How to delete the cluster

You can delete the cluster by executing the "destroy" command.

terraform destroy

How to get the application password

The output ApplicationPassword is the password for RabbitMQ user 'user'. If the password is not provided, it is auto-generated. The password is marked as sensitive information. If you want to show it, execute the following command:

terraform output ApplicationPassword

How to check cluster status?

To check the status of your RabbitMQ cluster, log in to the master server host through SSH, execute the RabbitMQ command line client with the cluster_status parameter, like this:

sudo rabbitmqctl cluster_status

The output of this command will be a list of cluster nodes and their current status.

Maintenance & support

Bitnami provides technical support for installation and setup issues through our support center.