Creating, editing, and applying RabbitMQ broker configurations - Amazon MQ
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Creating, editing, and applying RabbitMQ broker configurations

A configuration contains all of the settings for your RabbitMQ broker in Cuttlefish format. You can create a configuration before creating any brokers. You can then apply the configuration to one or more brokers

For more information, see the following:

The following examples show how you can create and apply a RabbitMQ broker configuration using the Amazon Web Services Management Console.

Create a New Configuration

  1. Sign in to the Amazon MQ console.

  2. On the left, expand the navigation panel and choose Configurations.

  3. On the Configurations page, choose Create configuration.

  4. On the Create configuration page, in the Details section, type the Configuration name (for example, MyConfiguration) and select a Broker engine version.

    To learn more about RabbitMQ engine versions supported by Amazon MQ for RabbitMQ, see Managing Amazon MQ for RabbitMQ engine versions.

  5. Choose Create configuration.

Create a New Configuration Revision

  1. From the configuration list, choose MyConfiguration.

    Note

    The first configuration revision is always created for you when Amazon MQ creates the configuration.

    On the MyConfiguration page, the broker engine type and version that your new configuration revision uses (for example, RabbitMQ 3.xx.xx) are displayed.

  2. On the Configuration details tab, the configuration revision number, description, and broker configuration in Cuttlefish format are displayed.

    Note

    Editing the current configuration creates a new configuration revision.

  3. Choose Edit configuration and make changes to the Cuttlefish configuration.

  4. Choose Save.

    The Save revision dialog box is displayed.

  5. (Optional) Type A description of the changes in this revision.

  6. Choose Save.

    The new revision of the configuration is saved.

    Important

    Making changes to a configuration does not apply the changes to the broker immediately. To apply your changes, you must wait for the next maintenance window or reboot the broker. For more information, see Amazon MQ broker configuration lifecycle.

    Currently, you can't delete a configuration.

Apply a Configuration Revision to Your Broker

  1. On the left, expand the navigation panel and choose Brokers.

  2. From the broker list, select your broker (for example, MyBroker) and then choose Edit.

  3. On the Edit MyBroker page, in the Configuration section, select a Configuration and a Revision and then choose Schedule Modifications.

  4. In the Schedule broker modifications section, choose whether to apply modifications During the next scheduled maintenance window or Immediately.

    Important

    Your broker will be offline while it is being rebooted.

  5. Choose Apply.

    Your configuration revision is applied to your broker at the specified time.

Edit a Configuration Revision

  1. Sign in to the Amazon MQ console.

  2. From the broker list, select your broker (for example, MyBroker) and then choose Edit.

  3. On the MyBroker page, choose Edit.

  4. On the Edit MyBroker page, in the Configuration section, select a Configuration and a Revision and then choose Edit.

    Note

    Unless you select a configuration when you create a broker, the first configuration revision is always created for you when Amazon MQ creates the broker.

    On the MyBroker page, the broker engine type and version that the configuration uses (for example, RabbitMQ 3.xx.xx) are displayed.

  5. On the Configuration details tab, the configuration revision number, description, and broker configuration in Cuttlefish format are displayed.

    Note

    Editing the current configuration creates a new configuration revision.

  6. Choose Edit configuration and make changes to the Cuttlefish configuration.

  7. Choose Save.

    The Save revision dialog box is displayed.

  8. (Optional) Type A description of the changes in this revision.

  9. Choose Save.

    The new revision of the configuration is saved.

    Important

    Making changes to a configuration does not apply the changes to the broker immediately. To apply your changes, you must wait for the next maintenance window or reboot the broker. For more information, see Amazon MQ broker configuration lifecycle.

    Currently, you can't delete a configuration.