【CDK】EC2が停止したらEventBridgeを使用してSNSでEメール通知を受け取る方法

るおん

2024.07.13

リテールアプリ共創部のるおんです。
今回は、EC2インスタンスが停止したときにEventBridgeを使用して、SNSを通じてEメールで通知を受け取る機能をCDKで実装してみました！
使用言語はTypeScriptです。

Amazon EventBridgeとは

EventBridgeは、AWSのサービス間やアプリケーションのイベントを連携させるためのサーバーレスイベントバスサービスです。様々なAWSサービスからのイベントを監視し、指定したルールに基づいて特定のアクションを実行することができます。

参考：Amazon EventBridge とは

全体像

今回は以下の構成をAWS CDKを用いてデプロイします。

EC2インスタンスの停止をEventBridgeで監視し、停止イベントを検知したらSNSを通じてEメールを送信するというシンプルな構成です。

スクリーンショット 2024-07-13 5.20.31

CDK書いてみる

それではこの構成をCDKで実装していきます。
TypeScriptが使用可能で、AWS CDKを用いて手元のマシンからデプロイができる環境が整っていることを前提に進めていきます。

実装

まず、プロジェクトを作成してCDKを開始します。

mkdir ec2_stop_notification
cd ec2_stop_notification
cdk init app --language typescript

CDKプロジェクトが構築できたら、lib/ec2_stop_notification-stack.tsに以下のコードを記述します。

import * as cdk from 'aws-cdk-lib';
import { Construct } from 'constructs';
import * as sns from 'aws-cdk-lib/aws-sns';
import * as subscriptions from 'aws-cdk-lib/aws-sns-subscriptions';
import * as events from 'aws-cdk-lib/aws-events';
import * as targets from 'aws-cdk-lib/aws-events-targets';

export class Ec2StopNotificationStack extends cdk.Stack {
  constructor(scope: Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props);

    // SNSトピックの作成
    const topic = new sns.Topic(this, 'EC2StopTopic', {
      topicName: 'ec2-stop-notification',
      displayName: 'EC2インスタンスが停止しました。',
    });

    // SNSトピックにEメールサブスクリプションを追加
    topic.addSubscription(new subscriptions.EmailSubscription('your-email@example.com'));

    // EventBridgeルールを作成
    const rule = new events.Rule(this, 'EC2StopRule', {
      eventPattern: {
        source: ['aws.ec2'],
        detailType: ['EC2 Instance State-change Notification'],
        detail: {
          state: ['stopped'],
          "instance-id": ['i-xxxxxxxxxxxxxxxxx'],
        },
      },
    });

    // ルールのターゲットとしてSNSトピックを追加
    rule.addTarget(new targets.SnsTopic(topic));
  }
}

解説

それでは、このコードについて簡単に解説します。

 // SNSトピックの作成
    const topic = new sns.Topic(this, 'EC2StopTopic', {
      topicName: 'ec2-stop-notification',
      displayName: 'EC2インスタンスが停止しました。',
    });

    // SNSトピックにEメールサブスクリプションを追加
    topic.addSubscription(new subscriptions.EmailSubscription('your-email@example.com'));

ここでは、SNSトピックを作成し、指定したメールアドレスをサブスクライバーとして追加しています。
このトピックは、EC2インスタンスが停止した際に通知を送るために使用されます。
displayNameを指定することで、メールの件名を任意の文字列に指定することができます。

    // EventBridgeルールを作成
    const rule = new events.Rule(this, 'EC2StopRule', {
      eventPattern: {
        source: ['aws.ec2'],
        detailType: ['EC2 Instance State-change Notification'],
        detail: {
          state: ['stopped'],
          "instance-id": ['i-xxxxxxxxxxxxxxxxx'],
        },
      },
    });

    // ルールのターゲットとしてSNSトピックを追加
    rule.addTarget(new targets.SnsTopic(topic));

ここでは、EventBridgeルールを作成しています。そして、作成したEventBridgeルールのターゲットとして、先ほど作成したSNSトピックを設定しています。
このルールは、特定のEC2インスタンスの状態が stopped に変更されたときにトリガーされます。eventPatternでイベントのソース、タイプ、詳細を指定しています。
検知したいインスタンスのIDを指定してください。

これにより、ルールがトリガーされたときにSNSトピックに通知が送られます。