Skip to navigationSkip to main contentSkip to footerScaleway DocsSparklesIconAsk our AI
SparklesIconAsk our AI

Cloud Essentials for RabbitMQ - Quickstart

RabbitMQ is an open‑source message broker that implements the Advanced Message Queuing Protocol (AMQP) to reliably route, queue, and deliver messages between distributed applications, enabling asynchronous communication and service decoupling.

Cloud Essentials for RabbitMQ is a managed solution to quickly deploy a message broker that allows you to:

  • Distribute time-consuming tasks (e.g., image resizing, PDF generation) across multiple workers to avoid overloading a single server
  • Send real-time alerts (e.g., order confirmations, password reset emails) to users or systems
  • Decouple services so that microservices can communicate asynchronously (one service can process data without waiting for another)
  • Aggregate logs from multiple sources (e.g., web servers, APIs) and forward them to a central system for analysis
  • Enable real-time messaging between users by routing messages through queues

This guide covers the basic steps to set up, log in to, manage, and delete a Cloud Essentials for RabbitMQ deployment.

Before you start

To complete the actions presented below, you must have:

  • A Scaleway account logged into the console
  • Owner status or IAM permissions allowing you to perform actions in the intended Organization

How to create a Cloud Essentials for RabbitMQ deployment

  1. Click RabbitMQ in the Integration Services section of the console. The Cloud Essentials for RabbitMQ dashboard displays.

  2. Click + Create deployment. A creation form displays.

  3. Select the Standalone deployment configuration. Standalone deployments are General Purpose single-node deployments for testing environments and non-critical, small-scale applications, without redundancy.

  4. Select the MESSAGEQ-DEDICATED-2C-8G node type.

  5. Define a storage capacity.

  6. Keep the default network connectivity.

  7. Create credentials to log in to your RabbitMQ deployment. These credentials will grant admin access to the user.

  8. Enter a name for your deployment, or keep the automatically generated one.

  9. Review the estimated cost for your deployment, then click Create deployment to finish.

You are directed to the Overview tab of your deployment.

InformationOutlineIcon
Note

The creation of a Cloud Essentials for RabbitMQ deployment can take several minutes to complete.

How to connect to a Cloud Essentials for RabbitMQ deployment

How to connect to a RabbitMQ dashboard

  1. In the Overview tab of the deployment you just created, click the RabbitMQ dashboard button. A new tab opens in your browser.

  2. Enter the credentials you set up when you created the deployment, then click Login.

You are now connected to your Cloud Essentials for RabbitMQ deployment.

How to communicate with a deployment using the Management REST API

  1. From the Network section of the Overview tab of the deployment you just created, copy the API endpoint.

  2. In a terminal, run the following command to check RabbitMQ server health using the Management REST API.

    Remember to replace the placeholders with the appropriate values:

    • <username>: the username set up when the deployment was created
    • <password>: the password set up when the deployment was created
    • <rabbitmq_host>: the API endpoint value you have just copied, the string between amqps:// and :<port-number>
    curl -u <username>:<password> http://<rabbitmq_host>:15672/api/healthchecks/node

    An output similar to the following displays:

    {
      status: ok,
      checks: [
        { check: virtual_hosts, status: ok },
        { check: listeners, status: ok },
        { check: certificate_expiry, status: ok }
      ]
    }

You can now interact with your deployment using the Management REST API.

How to communicate with a deployment using the AMQP protocol

  1. From the Network section of the Overview tab of the deployment you just created, copy the API endpoint.

  2. In a terminal, run the following command to test connectivity using the AMQP protocol.

    Remember to replace the placeholders with the appropriate values:

    • <username>: the username set up when the deployment was created
    • <password>: the password set up when the deployment was created
    • <rabbitmq_host>: the API endpoint value you have just copied, the string between amqps:// and :<port-number>
    python3 -c "import pika; conn = pika.BlockingConnection(pika.URLParameters('amqp://<username>:<password>@<rabbitmq_host>:5672')); print('Connection successful'); conn.close()"

    An output similar to the following displays:

    Connection successful

You can now interact with your deployment using the AMQP protocol.

How to manage a Cloud Essentials for RabbitMQ deployment

  1. Click RabbitMQ in the Integration Services section of the console. The list of your RabbitMQ deployments displays.

  2. Click the name of the RabbitMQ deployment you want to manage. Its Overview page displays.

  3. From here, you can:

    • Access the dashboard of your deployment
    • View and manage the users of your deployment
    • Delete your deployment

How to delete a Cloud Essentials for RabbitMQ deployment

  1. Click RabbitMQ in the Integration Services section of the console. The list of your RabbitMQ deployments displays.

  2. Click more iconDotsHorizontalIcon next to the name of the deployment you want to delete. A confirmation pop-up displays.

  3. Type DELETE, then click Delete deployment to confirm your action.

Your deployment is now deleted.

CheckCircleOutlineIcon
Tip

You can also delete a RabbitMQ deployment from its Settings tab.

SearchIcon
No Results