EventBridge Pipes から CloudFormation テンプレートを生成する - Amazon EventBridge
パイプテンプレートに含まれるリソース生成されたテンプレートを使用するときの考慮EventBridge Pipes から CloudFormation テンプレートを生成する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

EventBridge Pipes から CloudFormation テンプレートを生成する

AWS CloudFormation では、インフラストラクチャをコードとして扱うことで、複数のアカウントやリージョンの AWS リソースを一元的かつ繰り返し可能な方法で設定および管理できます。CloudFormation では、これを実現するために、プロビジョニングおよび管理するリソースを定義するテンプレートを作成できます。

EventBridge では、CloudFormation テンプレートの開発をすぐに開始するための補助として、アカウント内の既存のイベントバスからテンプレートを生成できます。1 つまたは複数のパイプを選択してテンプレートに含めることができます。次に、これらのテンプレートに基づいて CloudFormation で管理するリソースのスタックを作成できます。

CloudFormation の詳細については、「CloudFormation ユーザーガイド」を参照してください。

イベントバスの場合、イベントバスとイベントバスルールから CloudFormation テンプレートを生成できます。

EventBridge Pipe テンプレートに含まれるリソース

EventBridge が CloudFormation テンプレートを生成すると、選択したパイプごとに AWS::Pipes::Pipe リソースが作成されます。さらに、EventBridge には、説明された条件下で以下のリソースが含まれています。

  • AWS::Events::ApiDestination

    パイプに API デスティネーションがエンリッチメントまたはターゲットとして含まれている場合、EventBridge は、これらを AWS::Events::ApiDestination リソースとして CloudFormation テンプレートに含めます。

  • AWS::Events::EventBus

    パイプにイベントバスがターゲットとして含まれている場合、EventBridge は、これを AAWS::Events::EventBus リソースとして CloudFormation テンプレートに含めます。

  • AWS::IAM::Role

    パイプの設定時に EventBridge で新しい実行ロールを作成した場合は、EventBridge がそのロールをテンプレートに AWS::IAM::Role リソースとして含めるように選択できます。EventBridge はお客様が作成したロールを含めません。(いずれの場合も、AWS::Pipes::Pipe リソースの RoleArn プロパティにはロールの ARN が含まれます。)

EventBridge パイプから生成した CloudFormation テンプレートを使用する際の考慮事項

EventBridge から生成した CloudFormation テンプレートを使用するときは、次の点を考慮してください。

  • EventBridge は、生成テンプレートにパスワードを含みません。

    テンプレートを編集してテンプレートパラメータを含めると、ユーザーがテンプレートを使用して CloudFormation スタックを作成または更新するときに、パスワードやその他の機密情報を指定できるようになります。

    さらに、ユーザーは Secrets Manager を使用して目的のリージョンにシークレットを作成し、生成されたテンプレートを編集して動的パラメーターを使用できます。

  • 生成したテンプレートのターゲットは、元のパイプで指定していたものと同じです。テンプレートを使用して他のリージョンにスタックを作成する前に、テンプレートを適切に編集しないと、リージョン間の問題が発生する可能性があります。

    また、生成したテンプレートでは、下流のターゲットが自動的には作成されません。

EventBridge Pipes から CloudFormation テンプレートを生成する

EventBridge コンソールを使用して 1 つ以上のパイプから CloudFormation テンプレートを生成するには、次の操作を行います。

1 つ以上のパイプから CloudFormation テンプレートを生成するには

  1. Amazon EventBridge コンソールの https://console.aws.amazon.com/events/ を開いてください。

  2. ナビゲーションペインで、[パイプ] を選択します。

  3. [パイプ] で、生成した CloudFormation テンプレートに含めるパイプを 1 つ以上選択します。

    パイプが 1 つの場合は、パイプの詳細ページに表示するパイプ名を選択することもできます。

  4. [CloudFormation テンプレート] を選択し、EventBridge でテンプレートを生成したいフォーマット (JSON または YAML) を選択します。

    EventBridge には、選択した形式で生成されたテンプレートが表示されます。

  5. EventBridge で選択したパイプのいずれかに新しい実行ロールを作成し、EventBridge がそれらのロールをテンプレートに含める場合は、[コンソールによって作成された IAM ロールを含める] を選択します。

  6. EventBridge では、テンプレートファイルをダウンロードするか、テンプレートをクリップボードにコピーするかを選択できます。

    • テンプレートファイルをダウンロードするには、[Download] (ダウンロード) を選択します。

    • テンプレートをクリップボードにコピーするには、[Copy] (コピー) を選択します。

  7. テンプレートを終了するには、[Cancel] (キャンセル) を選択します。