從 EventBridge 管產生 AWS CloudFormation 樣板

AWS CloudFormation 透過將基礎結構視為程式碼，讓您以集中且可重複的方式，跨帳戶和區域設定和管理 AWS 資源。 CloudFormation 透過讓您建立範本 (定義您要佈建和管理的資源) 來執行此作業。

EventBridge 可讓您從帳戶中的現有管道產生範本，以協助您快速開發 CloudFormation 範本。您可以選取要在範本中包含的一或多個管道。然後，您可以使用這些範本作為建立受 CloudFormation 管理資源堆疊的基礎。

若要取得更多資訊 CloudFormation，請參閱《 AWS CloudFormation 使用指南》。

對於事件匯流排，您可以從事件匯流排和事件匯流排規則產生 CloudFormation 範本。

EventBridge 管樣板中包含的資源

EventBridge 產生 CloudFormation 樣板時，會為每個選取的管建立AWS::Pipes::Pipe資源。此外，在描述的條件下 EventBridge 包括以下資源：

• AWS::Events::ApiDestination

  如果您的管道包含 API 目的地 (無論是作為擴充項目或目標)，請將它們作為 AWS::Events::ApiDestination資源 EventBridge包含在 CloudFormation 範本中。

• AWS::Events::EventBus

  如果您的管道包括事件匯流排做為目標，請將其作為 AWS::Events::EventBus 資源 EventBridge 包含在 CloudFormation 樣板中。

• AWS::IAM::Role

  如果您在配置管道時 EventBridge 建立了新的執行角色，則可以選擇將該角色 EventBridge 納入範本中作為 AWS::IAM::Role 資源。 EventBridge 不包括您建立的角色。(在任何一種情況下， AWS::Pipes::Pipe 資源的RoleArn屬性都包含角色的 ARN。)

使用從 EventBridge 管產生的 CloudFormation 樣板時的注意事項

使用從中產生的 CloudFormation 範本時，請考量下列因素 EventBridge：

• EventBridge 生成模板中不包含任何密碼。

  您可以編輯範本以包含範本參數，讓使用者在使用範本建立或更新 CloudFormation堆疊時指定密碼或其他敏感資訊。

  此外，使用者可以使用 Secrets Manager 在所需區域中建立密碼，然後編輯產生的範本以使用動態參數。

• 產生之範本中的目標會保持與原始管道中指定的目標完全相同。如果您在使用範本在其他地區建立堆疊之前未適當地編輯範本，這可能會導致跨區域問題。

  此外，產生的範本不會自動建立下游目標。

從 EventBridge 管產生 CloudFormation 樣板

若要使用 EventBridge 控制台從一個或多個管道產生 CloudFormation 樣板，請執行以下操作：

從一個或多個管產生 CloudFormation 樣板的步驟

1. 在 https://console.aws.amazon.com/events/ 打開 Amazon EventBridge 控制台。

2. 在導覽窗格中，選擇管道。

3. 在「管」下，選擇要包括在產生的 CloudFormation 樣板中的一個或多個管。

   對於單一管道，您也可以選擇管道名稱以顯示管道的詳細資訊頁面。

4. 選擇 [CloudFormation 範本]，然後選擇要用 EventBridge 來產生範本的格式：JSON 或 YAML。

   EventBridge 顯示以所選格式產生的樣板。

5. 如果您已為任何選取的管道 EventBridge 建立新的執行角色，並且想 EventBridge 要在範本中包含這些角色，請選擇 [包含由控制台代表您建立的 IAM 角色]。

6. EventBridge 可讓您選擇下載範本檔案，或將範本複製到剪貼簿。

   • 選擇立即下載以下載範本檔案。

   • 若要將範本複製剪貼簿，請選擇複製。

7. 若要結束範本，請選擇取消。