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

# 建立 Amazon MQ for ActiveMQ 代理程式組態
<a name="amazon-mq-creating-applying-configurations"></a>

*組態*以 XML 格式 (類似於 ActiveMQ 的 `activemq.xml` 檔案) 包含所有的 ActiveMQ 代理程式設定。您可以在建立任何代理程式之前建立組態。然後，您可以將組態套用至一或多個代理程式。您可以立即或在*維護時段*套用組態。

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

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

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

若要建立新的代理程式組態，請先建立新的組態。

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

1. 在左邊，展開導覽面板並選擇 **Configurations (組態)**。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](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 ActiveMQ 支援的 ActiveMQ 引擎版本，請參閱 [管理 Amazon MQ for ActiveMQ 引擎版本](activemq-version-management.md)。

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

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

建立代理程式組態之後，您將需要使用組態修訂來編輯組態。

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

   在 ***MyConfiguration*** 頁面上，會顯示新組態修訂使用的代理程式引擎類型和版本 （例如 **Apache ActiveMQ 5.15.16**)。

1. 在 **Configuration details** (組態詳細資訊) 標籤上，會顯示組態修訂編號、描述及 XML 格式的代理程式組態。
**注意**  
編輯目前的組態會建立新的組態版本。  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/zh_tw/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. 選擇 **Edit configuration (編輯組態)**，然後變更 XML 組態。

1. 選擇**儲存**。

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

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

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

   隨即儲存組態的新修訂版。
**重要**  
Amazon MQ 主控台會根據結構描述，自動清理無效及禁止的組態參數。如需詳細資訊和允許的完整 XML 參數清單，請參閱 [Amazon MQ for ActiveMQ 代理程式組態](amazon-mq-broker-configuration-parameters.md)。

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

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

1. 在左邊，展開導覽面板並選擇 **Brokers (代理程式)**。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](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. 選擇**套用**。

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