本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 建立和套用 RabbitMQ 代理程式組態
<a name="rabbitmq-creating-applying-configurations"></a>

*組態*使用 Cuttlefish 格式，包含 RabbitMQ 代理程式的所有設定。您可以在建立任何代理程式之前建立組態。然後，您可以將組態套用至一或多個代理程式。

以下範例顯示如何使用 AWS 管理主控台建立和套用 RabbitMQ 代理程式組態。

**重要**  
您只能使用 `DeleteConfiguration` API **刪除**組態。如需詳細資訊，請參閱《*Amazon MQ API 參考*》中的[組態](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)。

## 建立新組態
<a name="creating-rabbitmq-configuration-from-scratch-console"></a>

 若要將組態套用至代理程式，您必須先建立組態。

1. 登入 [Amazon MQ 主控台](https://console.aws.amazon.com/amazon-mq/)。

1. 在左邊，展開導覽面板並選擇 **Configurations (組態)**。  
![Amazon MQ 導覽面板顯示中介裝置和組態選項。](http://docs.aws.amazon.com/zh_tw/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. 在 **Configurations (組態)** 頁面上，選擇 **Create configuration (建立組態)**。

1. 在 **Create configuration** (建立組態) 頁面的 **Details** (詳細資訊) 區段中，輸入 **Configuration name** (組態名稱) (例如 `MyConfiguration`)，然後選取 **Broker engine** (代理程式引擎) 版本。

   若要深入了解 Amazon MQ for RabbitMQ 支援的 RabbitMQ 引擎版本，請參閱 [管理 Amazon MQ for RabbitMQ 引擎版本](rabbitmq-version-management.md)。

1. 選擇**建立組態**。

## 建立新的組態修訂
<a name="creating-new-rabbitmq-configuration-revision-console"></a>

 建立組態之後，您必須使用組態修訂來編輯組態。

1. 從組態清單中，選擇 **{{MyConfiguration}}**。
**注意**  
當 Amazon MQ 建立組態時，一律為您建立第一個組態修訂。

   **{{我的組態}}**頁面上會顯示新的組態修訂所使用的代理程式引擎類型和版本 (例如 **RabbitMQ 3.xx.xx**)。

1. **組態詳細資訊**標籤上會顯示組態修訂編號、描述及 Cuttlefish 格式的代理程式組態。
**注意**  
編輯目前的組態會建立新的組態版本。

1. 選擇**編輯組態**，然後變更 Cuttlefish 組態。

1. 選擇**儲存**。

   **Save revision (儲存修訂)** 對話方塊隨即顯示。

1. (選用) 輸入 `A description of the changes in this revision`。

1. 選擇 **Save (儲存)**。

   隨即儲存組態的新修訂版。
**重要**  
對組態進行變更，*不會*立即將變更套用至代理程式。若要套用變更，您必須等待下一個維護時段或[重新啟動代理程式](amazon-mq-rebooting-broker.md)。  
您目前無法刪除組態。

## 將組態修訂套用至您的代理程式
<a name="apply-rabbitmq-configuration-revision-creating-console"></a>

 建立組態修訂之後，您可以將組態修訂套用至代理程式。

1. 在左邊，展開導覽面板並選擇 **Brokers (代理程式)**。  
![Amazon MQ 導覽面板顯示中介裝置和組態選項。](http://docs.aws.amazon.com/zh_tw/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. 從代理程式清單，選取您的代理程式 (例如 **MyBroker**)，然後選擇 **Edit (編輯)**。

1. 在 **Edit {{MyBroker}} (編輯 MyBroker)** 頁面的 **Configuration (組態)** 區段中，選取 **Configuration (組態)** 和 **Revision (修訂)**，然後選擇 **Schedule Modifications (排程修改)**。

1. 在 **Schedule broker modifications** (排定代理程式修改) 部分，選擇套用修改的時機是 **During the next scheduled maintenance window** (下一個排程的維護時段) 或 **Immediately** (立即)。
**重要**  
重新啟動時，單一執行個體代理程式處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。

1. 選擇**套用**。

   組態修訂會在指定時間套用至代理程式。