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

Amazon SNS を使用した Elastic Beanstalk 環境の通知

AWS Elastic Beanstalk 環境は、Amazon Simple Notification Service (Amazon SNS) を使用して、アプリケーションに影響を与える重要なイベントを通知するように設定できます。エラーが発生したり、環境のヘルスに変化があった場合に AWS から E メールを受信するには、環境の作成時 (またはそれ以降) に E メールアドレスを指定します。

環境に関する通知を設定すると、それに関連する Amazon SNS トピックが、Elastic Beanstalk により自動的に作成されます。Amazon SNS トピックにメッセージを送信するには、Elastic Beanstalk が必要なアクセス許可を持っている必要があります。詳細については、「通知を送信するためのアクセス許可の設定」を参照してください。

重要なイベントが発生すると、Elastic Beanstalk はトピックにメッセージを送信します。そのメッセージは Amazon SNS に受信された後、トピックのサブスクライバーに中継されます。重要なイベントには、環境作成のエラーや環境およびインスタンスのヘルスステータスのあらゆる変化が含まれます。Amazon EC2 Auto Scaling のオペレーションに関するイベント (環境内のインスタンスの追加や削除など) や、その他の情報関連のイベントでは通知はトリガーされません。

ユーザーの E メールアドレスは、環境の作成時もしくはその後の任意の時点で、Elastic Beanstalk コンソールから入力することができます。これにより、Amazon SNS トピックが作成され、サブスクライブされるようになります。Elastic Beanstalk ではトピックのライフサイクルが管理されており、環境が終了した場合や、環境マネジメントコンソールで E メールアドレスを削除した場合、トピックは削除されます。

aws:elasticbeanstalk:sns:topics 名前空間により、設定ファイルまたは CLI や SDK を使用して Amazon SNS トピックを設定するためのオプションが提供されます。これらの方法のいずれかを使用して、サブスクライバとエンドポイントのタイプを設定できます。サブスクライバーのタイプには、Amazon SQS キューまたは HTTP URL が選択可能です。

Amazon SNS 通知は、オン/オフの切り替えのみが可能です。トピックへの通知の送信頻度は、環境のサイズと構成に応じて高くなる場合があります。特定の状況に応じて通知を送信するように設定するための、他のオプションも用意されています。Amazon EventBridge でイベント駆動型ルールを設定しておくと、特定の基準を満たしたために Elastic Beanstalk がイベントを生成した場合の通知を受けられます。または、カスタムメトリクスを公開するように環境を設定し Amazon CloudWatch アラームを設定しておくと、メトリクスが異常なしきい値に達した場合に通知を出力させることも可能です。

Elastic Beanstalk コンソールを使用した通知の設定

Elastic Beanstalk コンソールにメールアドレスを入力することで、環境のための Amazon SNS トピックを作成できます。

通知用の E メールアドレスを入力すると、Elastic Beanstalk は環境に関する Amazon SNS トピックを作成し、サブスクリプションを追加します。Amazon SNS は、サブスクライバ―のアドレスに E メールを送信し、サブスクリプションを確認します。サブスクリプションをアクティベーションして通知を受け取るには、確認メールに記載されたリンクをクリックする必要があります。

設定オプションを使用した通知の設定

環境に関する Amazon SNS 通知を設定するには、aws:elasticbeanstalk:sns:topics名前空間のオプションを使用します。これらのオプションは、設定ファイル、CLI、または SDK を使用して設定できます。

EB CLI および Elastic Beanstalk コンソールでは、上記のオプションに推奨値が適用されます。設定ファイルを使用して同じファイルを設定する場合は、これらの設定を削除する必要があります。詳細については、「推奨値」を参照してください。

通知を送信するためのアクセス許可の設定

このセクションでは、Amazon SNS を使用する通知に関連するセキュリティ上の考慮事項について説明します。これには、次のように 2 つの異なるケースがあります。

Amazon SNS トピックのデフォルトのアクセスポリシーでは、トピック所有者のみがトピックを公開またはサブスクライブできます。ただし、ポリシーを適切に設定することで、このセクションで説明されている 2 つのケースのいずれかにおいて、Elastic Beanstalk に対し Amazon SNS トピックへの公開を許可することが可能になります。この後のサブセクションで、その詳細について説明します。

デフォルトトピックのアクセス許可

環境に関する通知を設定すると、Elastic Beanstalk は環境の Amazon SNS トピックを作成します。Amazon SNS トピックにメッセージを送信するには、Elastic Beanstalk が必要なアクセス許可を持っている必要があります。環境内で、Elastic Beanstalk コンソールまたは EB CLI によって生成されたサービスロールを使用しているか、アカウントのモニタリングサービスにリンクされたロールを使用している場合には、他に何もする必要はありません。これらの管理ロールには、Elastic Beanstalk が Amazon SNS トピックにメッセージを送信するために必要なアクセス許可が含まれています。

ただし、環境の作成時にカスタムサービスロールを設定した場合は、そのカスタムサービスロールに以下のポリシーが含まれていている必要があります。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "arn:aws:sns:us-east-2:123456789012:ElasticBeanstalkNotifications*"
      ]
    }
  ]
}

外部トピックのアクセス許可

「設定オプションを使用した通知の設定」では、Elastic Beanstalk により提供された Amazon SNS トピックを、別の Amazon SNS トピックに置き換える方法について説明しています。SNS トピックを置き換えた場合、そのトピックに対する公開がユーザーに許可されているかが、Elastic Beanstalk により確認されます。このアクセス許可は、そのトピックを環境に関連付けるために必要となります。ユーザーには sns:Publish が必要です。サービスロールでも同じアクセス許可を使用します。この状態となっているか確認するため、Elastic Beanstalk は環境を作成または更新するアクションの中で、テスト通知を SNS に送信します。このテストが失敗すると、当該の環境の作成または更新も失敗します。Elastic Beanstalk からは、この失敗の原因を報告するメッセージが表示されます。

環境にカスタムサービスロールを導入する場合は、そのカスタムサービスロールに次のポリシーが含まれていることを確認してください。これにより、Elastic Beanstalk が Amazon SNS トピックにメッセージを送信できるようになります。次に示すコードでは、sns_topic_name を、設定オプションで指定した Amazon SNS トピックの名前に置き換えています。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "arn:aws:sns:us-east-2:123456789012:sns_topic_name"
      ]
    }
  ]
}

Amazon SNS アクセスコントロールの詳細については、「Amazon Simple Notification Service デベロッパーガイド」の「Amazon SNS アクセスコントロールのケース例」を参照してください。