Skip to content

Brokers

A message broker is a software component that acts as an intermediary between various components of a distributed system. Brokers can be created and modified using ICDC Message Queue API operations or the Brokers tab.
Using the sidebar menu, the user can edit and delete brokers.

Brokers statuses

Depending on ongoing processes, brokers can have different statuses:

Status Description
Creating the broker is being created (during its creation, the broker is unavailable)
Stopped the broker instance has been stopped
Deleting the broker is being deleted
Available the broker is healthy and available
Maintenance ICDC Message Queue is applying a maintenance update to the broker
Modifying the broker instance is being modified based on the client's request
Starting the broker is starting up
Storage-full the broker has reached its storage capacity allocation limit. This is a critical status, and if it occurs, it is recommended to resolve the issue immediately. To do this, you need to increase the storage scale by changing it in the broker settings.

Broker creation

To create a broker, follow these steps:

  1. Go to the Brokers tab;
  2. Click New Broker;
  3. In the modal window, fill in the information necessary for creating the broker.

    Broker Information:

    • Name of the broker in the account;
    • Engine - select the engine for the broker being created (ActiveMQ/RabbitMQ);
    • Version - select the version/release of the chosen broker engine;
    • Master user name;
    • Master password.

    Resource Configuration:

    • CPU - number of CPU cores for the broker;
    • RAM - amount of RAM allocated for the broker;
    • Disk type;
    • Disk size - storage volume for the database.

    Network and Security:

    • Subnet or network in which the message queue broker will be deployed. This determines the network environment and connection parameters for the broker.
    • Security group for the broker. Security groups manage incoming and outgoing traffic for the broker, allowing you to define access rules and permissions.

    The user can also select Public access for the broker. Public access allows connections from the internet, and disabling it restricts access to specified networks or subnets.

    Note

    Take security measures when deciding to enable public access.

    Broker Configuration: At this step, you need to select a configuration for the broker being created.

    Note

    If a specific configuration is required for the new broker, create a new configuration in the Configurations tab before creating the broker.

    Broker Protection and Maintenance:

    • Delete protection - when the broker protection is selected, it cannot be deleted without editing this parameter;
    • Maintenance window - the period during which scheduled changes or maintenance will be applied to the broker.
  4. Click Create.

The created broker will be displayed in the Brokers tab.

After clicking on the created broker, the user has access to a summary of broker information with details. The Stop button to pause the broker's operation is available only when the broker status is Available. If the broker has a Stopped status, the Start button will be available to resume the broker's operation.

The user can edit the broker by clicking the Edit Broker button. Deleting the broker is also available using the Delete button.

Note

Delete action is irreversible.

Roles and Permissions

Action Member Admin Billing Operator Owner
Create Broker
Edit Broker only own only own
Stop/Start Broker only own only own
Delete Broker only own only own