기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 Pipe 템플릿에 포함된 리소스
<a name="pipes-generate-template-resources"></a>

가 CloudFormation 템플릿을 EventBridge 생성하면 선택한 각 파이프에 대한 [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는 이를 CloudFormation 템플릿에 AWS::Events::EventBus 리소스로 포함시킵니다.
+ [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 생성한 경우 템플릿에 해당 역할을 AWS::IAM::Role 리소스로 포함하도록 선택할 EventBridge 수 있습니다.생성한 역할은 포함되지 EventBridge 않습니다. (어떤 경우든 AWS::Pipes::Pipe 리소스의 `RoleArn` 속성에는 역할의 ARN이 포함됩니다.)

## EventBridge Pipes에서 생성된 CloudFormation 템플릿 사용 시 고려할 사항
<a name="pipes-generate-template-considerations"></a>

EventBridge에서 생성한 CloudFormation 템플릿을 사용할 때는 다음 요소를 고려합니다.
+ EventBridge는 생성 템플릿에 암호를 포함하지 않습니다.

  템플릿을 사용하여 CloudFormation 스택을 생성하거나 업데이트할 때 사용자가 암호 또는 기타 중요한 정보를 지정할 수 있는 [템플릿 파라미터](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html)를 포함하도록 템플릿을 편집할 수 있습니다.

  또한 사용자는 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. Amazon EventBridge 콘솔([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/))을 엽니다.

1. 탐색 창에서 **파이프**를 선택합니다.

1. **파이프**에서 생성된 CloudFormation 템플릿에 포함할 파이프를 하나 이상 선택합니다.

   단일 파이프의 경우 파이프 이름을 선택하여 파이프의 세부 정보 페이지를 표시할 수도 있습니다.

1. **CloudFormation 템플릿**을 선택한 다음, EventBridge에서 템플릿을 생성할 때 사용할 형식(**JSON** 또는 **YAML**)을 선택합니다.

   EventBridge는 선택한 형식으로 생성된 템플릿을 표시합니다.

1. 선택한 파이프에 대해 새 실행 역할을 EventBridge 생성했고 템플릿에 해당 역할을 포함 EventBridge 하려면 **사용자를 대신하여 콘솔에서 생성한 IAM 역할 포함을** 선택합니다.

1. EventBridge 는 템플릿 파일을 다운로드하거나 템플릿을 클립보드에 복사하는 옵션을 제공합니다.
   + 템플릿 파일을 다운로드하려면 **다운로드**를 선택합니다.
   + 템플릿을 클립보드에 복사하려면 **복사**를 선택합니다.

1. 템플릿을 종료하려면 **취소**를 선택합니다.