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

# 從 EventBridge 管道產生 CloudFormation 範本
<a name="pipes-generate-template"></a>

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

EventBridge 可讓您從帳戶中現有的管道產生範本，以協助您快速開始開發 CloudFormation 範本。您可以選取要在範本中包含的一或多個管道。然後，您可以使用這些範本作為基礎，以便建立受 CloudFormation 管理的資源[堆疊](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html)。

如需 CloudFormation 的詳細資訊，請參閱 [* CloudFormation 使用者指南*。](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)

對於事件匯流排，您可以從[事件匯流排](eb-generate-event-bus-template.md)和[事件匯流排規則](rule-generate-template.md)產生 CloudFormation 範本。

## EventBridge 管道範本中包含的資源
<a name="pipes-generate-template-resources"></a>

當 EventBridge 產生 CloudFormation 範本時，它會為每個選取的管道建立 [AWS::Pipes::Pipe](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-pipes-pipe.html) 資源。此外，在所述的條件下 EventBridge 包含下列資源：
+ [AWS::Events::ApiDestination](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-apidestination.html)

  如果管道包含 API 目的地 (無論是作為擴充項目或目標)，EventBridge 會將其包含在 CloudFormation 範本中，作為 AWS::Events::ApiDestination 資源。
+ [AWS::Events::EventBus](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html)

  如果管道包含作為目標的事件匯流排，則 EventBridge 會將其作為 AWS::Events::EventBus 資源包含在 CloudFormation 範本中。
+ [AWS::IAM::Role](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html)

  如果您在[設定管道](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-pipes-create.html#pipes-configure-pipe-settings)時 EventBridge 有建立新的執行角色，您可以選擇 EventBridge 在範本中將該角色包含為 AWS::IAM::Role resource. EventBridge does 不包含您建立的角色。（在任何一種情況下，AWS::Pipes::Pipe 資源的 `RoleArn` 屬性都會包含角色的 ARN。)

## 使用從 EventBridge 管道產生的 CloudFormation 範本時的注意事項
<a name="pipes-generate-template-considerations"></a>

使用從 EventBridge 產生的 CloudFormation 範本時，請考量下列因素：
+ EventBridge 不會在產生的範本中包含任何密碼。

  您可以編輯範本以包含[範本參數](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)，讓使用者在使用範本建立或更新 CloudFormation 堆疊時，能夠指定密碼或其他敏感資訊。

  此外，使用者可以使用 Secrets Manager 在所需區域中建立密碼，然後編輯產生的範本以使用[動態參數](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager)。
+ 產生之範本中的目標會保持與原始管道中指定的目標完全相同。如果您在使用範本在其他地區建立堆疊之前未適當地編輯範本，這可能會導致跨區域問題。

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

## 從 EventBridge 管道產生 CloudFormation 範本
<a name="pipes-generate-template-console"></a>

若要使用 EventBridge 主控台從一或多個管道產生 CloudFormation 範本，請執行下列動作：

**從一或多個管道產生 CloudFormation 範本**

1. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

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

1. 在**管道**下，選擇您要包含在產生的 CloudFormation 範本中的一或多個管道。

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

1. 選擇**CloudFormation 範本**，然後選擇您希望 EventBridge 在 **JSON** 或 **YAML** 中產生範本的格式。

   EventBridge 會顯示以所選取格式產生的範本。

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

1. EventBridge 可讓您選擇下載範本檔案，或將範本複製到剪貼簿。
   + 選擇**立即下載**以下載範本檔案。
   + 若要將範本複製剪貼簿，請選擇**複製**。

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