View a markdown version of this page

Automatisches Ausführen von Vorgängen auf EC2-Instances als Reaktion auf Ereignisse in AWS Health - AWS Health
VoraussetzungenErstellen Sie eine Regel für EventBridge

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Automatisches Ausführen von Vorgängen auf EC2-Instances als Reaktion auf Ereignisse in AWS Health

Sie können Aktionen automatisieren, die auf geplante Ereignisse für Ihre Amazon EC2-Instances reagieren. Wenn ein Ereignis an Ihr AWS Konto AWS Health gesendet wird, kann Ihre EventBridge Regel dann Ziele wie AWS Systems Manager Automatisierungsdokumente aufrufen, um Aktionen in Ihrem Namen zu automatisieren.

Wenn beispielsweise ein Ereignis zur Außerbetriebnahme einer Amazon EC2-Instance für eine vom Amazon Elastic Block Store (Amazon EBS) unterstützte EC2-Instance geplant ist, AWS Health wird der AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULED Ereignistyp an Ihr Dashboard gesendet. AWS Health Wenn Ihre Regel diesen Ereignistyp erkennt, können Sie das Stoppen und Starten der Instance automatisieren. Auf diese Weise müssen Sie diese Aktionen nicht manuell ausführen.

Anmerkung

Um Aktionen für Ihre Amazon EC2-Instances zu automatisieren, müssen die Instances von Systems Manager verwaltet werden.

Weitere Informationen finden Sie unter Automatisieren von Amazon EC2 mit EventBridge im Amazon EC2-Benutzerhandbuch.

Voraussetzungen

Sie müssen eine AWS Identity and Access Management (IAM-) Richtlinie erstellen, eine IAM-Rolle erstellen und die Vertrauensrichtlinie der Rolle aktualisieren, bevor Sie eine Regel erstellen können.

Gehen Sie wie folgt vor, um eine vom Kunden verwaltete Richtlinie für Ihre Rolle zu erstellen. Diese Richtlinie gibt der Rolle die Erlaubnis, Aktionen in Ihrem Namen auszuführen. Dieses Verfahren verwendet den JSON-Richtlinieneditor in der IAM-Konsole.

So erstellen Sie eine IAM-Richtlinie

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im Navigationsbereich Richtlinien.

  3. Wählen Sie Richtlinie erstellen aus.

  4. Wählen Sie den Tab JSON.

  5. Kopieren Sie das folgende JSON und ersetzen Sie dann das Standard-JSON im Editor.

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:DescribeInstanceStatus"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "ssm:*"
      ],
      "Resource": [
        "*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "sns:Publish"
      ],
      "Resource": [
        "arn:aws:sns:*:*:Automation*"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": "arn:aws:iam::123456789012:role/AutomationEVRole"
    }
  ]
}

    1. Geben Sie im Resource Parameter für den Amazon-Ressourcennamen (ARN) Ihre AWS Konto-ID ein.

    2. Sie können auch den Rollennamen ersetzen oder den Standardnamen verwenden. Dieses Beispiel verwendet AutomationEVRole.

  6. Wählen Sie Next: Markierungen (Weiter: Markierungen).

  7. (Optional) Sie können Tags als Schlüssel-Wert-Paare verwenden, um der Richtlinie Metadaten hinzuzufügen.

  8. Wählen Sie Weiter: Prüfen aus.

  9. Geben Sie auf der Seite „Richtlinie überprüfen“ einen Namen ein, z. B. AutomationEVRolePolicy und optional eine Beschreibung.

  10. Sehen Sie auf der Seite „Zusammenfassung“ nach, welche Berechtigungen die Richtlinie zulässt. Wenn Sie mit Ihrer Richtlinie zufrieden sind, wählen Sie Richtlinie erstellen aus.

Diese Richtlinie definiert die Aktionen, die die Rolle ausführen kann. Weitere Informationen finden Sie unter Erstellen von IAM-Richtlinien (Konsole) im IAM-Benutzerhandbuch.

Nachdem Sie die Richtlinie erstellt haben, müssen Sie eine IAM-Rolle erstellen und die Richtlinie dann dieser Rolle anfügen.

Um eine Rolle für einen zu erstellen AWS Service nicht zulässig

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im Navigationsbereich Rollen und dann Rolle erstellen.

  3. Wählen Sie unter Select type of trusted entity (Typ der vertrauenswürdigen Entität wählen) die Option AWS Service aus.

  4. Wählen Sie EC2 für den Dienst aus, dem Sie die Übernahme dieser Rolle gestatten möchten.

  5. Wählen Sie Weiter: Berechtigungen aus.

  6. Geben Sie den Richtliniennamen ein, den Sie erstellt habenAutomationEVRolePolicy, z. B., und aktivieren Sie dann das Kontrollkästchen neben der Richtlinie.

  7. Wählen Sie Weiter: Tags aus.

  8. (Optional) Sie können Tags als Schlüssel-Wert-Paare verwenden, um der Rolle Metadaten hinzuzufügen.

  9. Wählen Sie Weiter: Prüfen aus.

  10. Geben Sie für Role name (Rollenname) den Namen AutomationEVRole ein. Bei diesem Namen muss es sich um denselben Namen handeln, der im ARN der von Ihnen erstellten IAM-Richtlinie erscheint.

  11. (Optional) Geben Sie im Feld Role description (Rollenbeschreibung) eine Beschreibung für die Rolle ein.

  12. Prüfen Sie die Rolle und klicken Sie dann auf Create Role (Rolle erstellen).

Weitere Informationen finden Sie im IAM-Benutzerhandbuch unter Erstellen einer Rolle für einen AWS Dienst.

Schließlich können Sie die Vertrauensrichtlinie für die von Ihnen erstellte Rolle aktualisieren. Sie müssen dieses Verfahren abschließen, damit Sie diese Rolle in der EventBridge Konsole auswählen können.

Um die Vertrauensrichtlinie für die Rolle zu aktualisieren

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im Navigationsbereich Rollen.

  3. Wählen Sie in der Liste der Rollen in Ihrem AWS Konto den Namen der Rolle aus, die Sie erstellt haben, z. B. AutomationEVRole

  4. Klicken Sie auf der Registerkarte Trust Relationships (Vertrauensbeziehungen) auf Edit Trust Relationship (Vertrauensbeziehungen bearbeiten).

  5. Kopieren Sie für das Richtliniendokument die folgende JSON-Datei, entfernen Sie die Standardrichtlinie und fügen Sie die kopierte JSON-Datei an ihrer Stelle ein.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "ssm.amazonaws.com",
                    "events.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

  6. Wählen Sie Update Trust Policy (Trust Policy aktualisieren).

Weitere Informationen finden Sie unter Ändern einer Rollenvertrauensrichtlinie (Konsole) im IAM-Benutzerhandbuch.

Erstellen Sie eine Regel für EventBridge

Gehen Sie wie folgt vor, um in der EventBridge Konsole eine Regel zu erstellen, mit der Sie das Stoppen und Starten von EC2-Instances automatisieren können, deren Außerbetriebnahme geplant ist.

So erstellen Sie eine Regel EventBridge für automatische Aktionen von Systems Manager

  1. Öffnen Sie die EventBridge Amazon-Konsole unter https://console.aws.amazon.com/events/.

  2. Wählen Sie im Navigationsbereich unter Events (Ereignisse) die Option Rules (Regeln) aus.

  3. Geben Sie auf der Seite Regel erstellen einen Namen und eine Beschreibung für Ihre Regel ein.

  4. Wählen Sie unter Muster definieren die Option Ereignismuster und dann Pre-defined Muster nach Dienst aus.

  5. Wählen Sie für Service provider (Serviceanbieter) die Option AWS aus.

  6. Wählen Sie als Dienstname die Option Health aus.

  7. Wählen Sie als Ereignistyp die Option Spezifische Gesundheitsereignisse aus.

  8. Wählen Sie Bestimmte Dienste und dann EC2 aus.

  9. Wählen Sie Kategorie (n) für bestimmte Ereignistypen und dann ScheduledChange aus.

  10. Wählen Sie „Code (s) für bestimmte Ereignistypen“ und dann den Code für den Ereignistyp.

    Wählen AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULED Sie beispielsweise für Amazon EBS-backed EC2-Instances. Wählen Sie für vom Amazon EC2-Instance-Speicher unterstützte Instances. AWS_EC2_INSTANCE_RETIREMENT_SCHEDULED

  11. Wählen Sie Irgendeine Ressource.

    Ihr Event-Muster wird dem folgenden Beispiel ähneln.

    Beispiel
    {
  "source": [
    "aws.health"
  ],
  "detail-type": [
    "AWS Health Event"
  ],
  "detail": {
    "service": [
      "EC2"
    ],
    "eventTypeCategory": [
      "scheduledChange"
    ],
    "eventTypeCode": [
      "AWS_EC2_PERSISTENT_INSTANCE_RETIREMENT_SCHEDULED"
    ]
  }
}

  12. Fügen Sie das Systems Manager Automation-Dokumentziel hinzu. Wählen Sie unter Ziele auswählen für Ziel die Option SSM Automation aus.

  13. Wählen Sie AWS-RestartEC2Instance für Dokument aus.

  14. Erweitern Sie das Feld Automationsparameter (n) konfigurieren und wählen Sie dann Input Transformer aus.

  15. Geben Sie für das Feld Eingabepfad Folgendes ein{"Instances":"$.resources"}.

  16. Geben Sie für das zweite Feld ein{"InstanceId": <Instances>}.

  17. Wählen Sie Bestehende Rolle verwenden aus, und wählen Sie dann die IAM-Rolle aus, die Sie erstellt haben, z. B. AutomationEVRole

    Ihr Ziel sollte wie im folgenden Beispiel aussehen.

    Screenshot des Beispiels „SSM Automation“ in der EventBridge Konsole.
    Anmerkung

    Wenn Sie noch keine IAM-Rolle mit den erforderlichen EC2- und Systems Manager-Berechtigungen und einer vertrauenswürdigen Beziehung haben, wird Ihre Rolle nicht in der Liste angezeigt. Weitere Informationen finden Sie unter Voraussetzungen.

  18. Wählen Sie Erstellen aus.

    Wenn in Ihrem Konto ein Ereignis eintritt, das Ihrer Regel entspricht, EventBridge wird das Ereignis an das von Ihnen angegebene Ziel gesendet.