Erstellen einer Zuordnung, die eine Automatisierung ausführt (Konsole)Erstellen einer Zuordnung, die eine Automatisierung ausführt (Befehlszeile)Fehlerbehebung bei Automatisierungen, die ausgeführt werden von State Manager Verbände

Planungsautomatisierungen mit State Manager Verbände

Sie können eine Automatisierung starten, indem Sie eine erstellen State Manager Verknüpfung mit einem Runbook. State Manager ist ein Tool in AWS Systems Manager. Durch die Erstellung eines State Manager Durch die Verknüpfung mit einem Runbook können Sie auf verschiedene Arten von AWS Ressourcen abzielen. Sie können beispielsweise Zuordnungen erstellen, die einen gewünschten Status für eine AWS Ressource erzwingen, einschließlich der folgenden:

Ordnen Sie Amazon Elastic Compute Cloud (Amazon EC2) -Instances eine Systems Manager Manager-Rolle zu, um sie zu verwalteten Instances zu machen.
Erzwingen Sie die gewünschten Eingangs- und Ausgangsregeln für eine Sicherheitsgruppe.
Erstellen oder löschen Sie Amazon DynamoDB-Backups.
Erstellen oder löschen Sie Amazon Elastic Block Store (Amazon EBS)-Snapshots.
Deaktivieren Sie Lese- und Schreibberechtigungen für Amazon Simple Storage Service (Amazon S3)-Buckets.
Starten, Stoppen oder starten Sie verwaltete Instances und Amazon Relational Database Service (Amazon RDS)-Instances neu.
Patches auf Linux anwenden, macOS, und Windows AMIs.

Verwenden Sie die folgenden Verfahren, um eine zu erstellen State Manager Assoziation, die eine Automatisierung mithilfe der AWS Systems Manager Konsole und AWS Command Line Interface (AWS CLI) ausführt. Allgemeine Informationen zu Verknüpfungen und Informationen zum Erstellen einer Zuordndung, die ein Command-SSM-Dokument oder Policy verwendet, finden Sie unter Erstellen von Zuordnungen.

Bevor Sie beginnen

Beachten Sie die folgenden wichtigen Details, bevor Sie eine Automatisierung ausführen, indem Sie State Manager:

Bevor Sie eine Zuordnung erstellen können, die ein Runbook verwendet, stellen Sie sicher, dass Sie die Berechtigungen für Automation konfiguriert haben, ein Tool in AWS Systems Manager. Weitere Informationen finden Sie unter Einrichten der Automatisierung.
State Manager Zuordnungen, die Runbooks verwenden, tragen zur maximalen Anzahl gleichzeitig ausgeführter Automatisierungen in Ihrem bei. AWS-Konto Sie können maximal 100 Automatisierungen gleichzeitig ausführen. Informationen finden Sie unter Systems Manager Service Quotas im Allgemeine Amazon Web Services-Referenz.
Wenn Sie eine Automatisierung ausführen, State Manager protokolliert die durch die Automatisierung initiierten API-Operationen nicht AWS CloudTrail.
Systems Manager erstellt automatisch eine serviceverknüpfte Rolle, sodass State Manager hat die Berechtigung, API-Operationen von Systems Manager Automation aufzurufen. Wenn Sie möchten, können Sie die dienstbezogene Rolle selbst erstellen, indem Sie den folgenden Befehl über AWS CLI oder AWS Tools for PowerShell ausführen.
Linux & macOS
```
aws iam create-service-linked-role \
--aws-service-name ssm.amazonaws.com
```
Windows
```
aws iam create-service-linked-role ^
--aws-service-name ssm.amazonaws.com
```
PowerShell
```
New-IAMServiceLinkedRole `
-AWSServiceName ssm.amazonaws.com
```
Weitere Informationen zu serviceverknüpften Rollen finden Sie unter Verwenden von serviceverknüpften Rollen für Systems Manager.

Erstellen einer Zuordnung, die eine Automatisierung ausführt (Konsole)

Das folgende Verfahren beschreibt, wie Sie die Systems Manager Manager-Konsole verwenden, um ein State Manager Assoziation, die eine Automatisierung ausführt.

Um eine zu erstellen State Manager Assoziation, die eine Automatisierung ausführt

Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/.
Wählen Sie im Navigationsbereich State Manager, und wählen Sie dann Verknüpfung erstellen aus.
Geben Sie im Feld Name einen Namen an. Dies ist zwar optional, wird aber empfohlen.
Wählen Sie in der Liste Document ein Runbook aus. Verwenden Sie die Suchleiste, um nach allen Runbooks mit Document type : Equal : Automation zu filtern. Zur Anzeige von weiteren Runbooks verwenden Sie die Zahlen rechts neben der Suchleiste.

Anmerkung
Sie können Informationen zu einem Runbook einsehen, indem Sie den Runbook-Namen auswählen.
Wählen Sie Simple execution (Einfache Ausführung) aus, um die Automatisierung auf einem oder mehreren Zielen auszuführen, indem Sie die Ressourcen-ID für diese Ziele angeben. Wählen Sie Ratensteuerung, um die Automatisierung für eine ganze Flotte von AWS Ressourcen auszuführen, indem Sie eine Targeting-Option wie Tags oder angeben AWS Resource Groups. Sie können auch die Operation der Automatisierung auf Ihren Ressourcen steuern, indem Sie Gleichzeitigkeits- und Fehlergrenzwerte angeben.

Wenn Sie Rate control (Ratensteuerung) auswählen, wird der Abschnitt Targets (Ziele) angezeigt.
Wählen Sie im Abschnitt Targets (Ziele) eine Methode zur Ausrichtung der Ressourcen aus.
1. (Erforderlich) Wählen Sie in der Liste Parameter einen Parameter aus. Die Elemente in der Liste Parameter richten sich nach den Parametern in dem Runbook, das Sie zu Beginn dieses Verfahrens ausgewählt haben. Durch Auswahl eines Parameters legen Sie den Typ der Ressource fest, für die die Automatisierung ausgeführt wird.
2. (Erforderlich) Wählen Sie in der Liste Targets (Ziele) ein Verfahren für die Ausrichtung auf Ressourcen aus.
  - Resource Group (Ressourcengruppe): Wählen Sie den Namen der Gruppe aus der Liste Resource Group (Ressourcengruppe) aus. Weitere Informationen zum Targeting AWS Resource Groups in Runbooks finden Sie unterTargeting von AWS Resource Groups.
  - Tags: Geben Sie den Tag-Schlüssel und (optional) den Tag-Wert in die dafür vorgesehenen Felder ein. Wählen Sie Hinzufügen aus. Weitere Informationen zum Targeting von Tags in Runbooks finden Sie unter Anzielen eines Tags.
  - Parameter Values (Parameterwerte): Geben Sie die Werte im Abschnitt Input parameters (Eingabeparameter) ein. Wenn Sie mehrere Werte angeben, führt Systems Manager eine untergeordnete Automatisierung für jeden angegebenen Wert aus.
    
    Nehmen Sie beispielsweise an, dass das Runbook einen InstanceID-Parameter enthält. Wenn Sie die Werte des InstanceID-Parameters beim Ausführen der Automatisierung verwenden, führt Systems Manager eine untergeordnete Automatisierung für jeden angegebenen Instance-ID-Wert aus. Die übergeordnete Automatisierung ist abgeschlossen, wenn Automatisierung die Ausführung jeder angegebenen Instance abgeschlossen hat oder wenn die Automatisierung fehlschlägt. Sie können maximal 50 Parameterwerte für die Ausrichtung verwenden. Weitere Informationen zum Targeting von Parameterwerten in Runbooks finden Sie unter Ausrichtung auf Parameterwerte.
Geben Sie im Abschnitt Eingabeparameter die erforderlichen Eingabeparameter an.

Wenn Sie die Zielressourcen mithilfe von Tags oder einer Ressourcengruppe ausgewählt haben, müssen Sie möglicherweise keine der Optionen im Abschnitt Input parameters (Eingabeparameter) auswählen. Wenn Sie beispielsweise das AWS-RestartEC2Instance Runbook ausgewählt haben und sich dafür entschieden haben, Instances mithilfe von Tags anzusprechen, müssen Sie IDs im Abschnitt Eingabeparameter keine Instanz angeben oder auswählen. Die Automatisierung sucht die Instances für den Neustart mit den von Ihnen angegebenen Tags.

Wichtig
Sie müssen in dem AutomationAssumeRoleFeld einen Rollen-ARN angeben. State Manager verwendet die im Runbook AWS-Services angegebene Rolle, um Automatisierungszuordnungen in Ihrem Namen aufzurufen und auszuführen.
Wählen Sie im Abschnitt Specify schedule (Zeitplan angeben) die Option On Schedule (Nach Zeitplan) aus, wenn Sie die Zuordnungen in regelmäßigen Abständen ausführen möchten. Wenn Sie diese Option auswählen, verwenden Sie die bereitgestellten Optionen zum Erstellen des Zeitplans mithilfe von Cron- oder Rate-Ausdrücken. Weitere Informationen zu Cron- und Rate-Ausdrücken für State Manager, finden Sie unter Cron- und Rate-Ausdrücke für Zuordnungen.

Anmerkung
Ratenausdrücke sind der bevorzugte Planungsmechanismus für State Manager Verbände, die Runbooks verwenden. Rate-Ausdrücke ermöglichen mehr Flexibilität für die Ausführung von Zuordnungen für den Fall, dass Sie die maximale Anzahl von gleichzeitig ausgeführten Automatisierungen erreichen. Mit einem Ratenzeitplan kann Systems Manager die Automatisierung kurz nach dem Empfangen der Benachrichtigungen, dass gleichzeitige Automatisierungen das Maximum erreicht haben und gedrosselt wurden, wiederholen.

Wählen Sie No schedule (Kein Zeitplan)aus, wenn Sie die Zuordnung einmalig ausführen möchten.
(Optional) Wählen Sie im Bereich „Ratensteuerung“ die Optionen Parallelität und Schwellenwert für Fehler aus, um die Bereitstellung der Automatisierung auf Ihren AWS Ressourcen zu steuern.
1. Wählen Sie im Abschnitt Gleichzeitigkeit eine Option aus:
  - Wählen Sie targets (Ziele) aus, um eine absolute Anzahl von Zielen einzugeben, die die Automatisierung gleichzeitig ausführen können.
  - Wählen Sie percentage (Prozentsatz) aus, um einen Prozentsatz der Ziele anzugeben, die den Automatisierung gleichzeitig ausführen können.
2. Wählen Sie im Abschnitt Fehlerschwellenwert eine Option aus:
  - Wählen Sie errors (Fehler), um eine absolute Anzahl von zulässigen Fehlern anzugeben, bevor die Automation damit aufhört, die Automatisierung an andere Ressourcen zu senden.
  - Wählen Sie percentage (Prozentsatz) aus, um einen Prozentsatz von zulässigen Fehlern anzugeben, bevor Automation damit aufhört, die Automatisierung an andere Ressourcen zu senden.
Weitere Informationen zur Verwendung von Zielen und Ratensteuerungen mit Automation finden Sie unter Automatisierte Abläufe in großem Umfang ausführen.
Wählen Sie Zuordnung erstellen.

Wichtig
Wenn Sie eine Zuordnung erstellen, wird die Zuordnung sofort für die ausgewählten Ziele ausgeführt. Die Zuordnung wird anschließend auf Grundlage des ausgewählten Cron- oder Rate-Ausdrucks ausgeführt. Wenn Sie No schedule (Kein Zeitplan) ausgewählt haben, wird die Zuordnung nicht mehr ausgeführt.

Erstellen einer Zuordnung, die eine Automatisierung ausführt (Befehlszeile)

Das folgende Verfahren beschreibt, wie Sie den AWS CLI (unter Linux oder Windows) verwenden oder AWS Tools for PowerShell einen erstellen State Manager Assoziation, die eine Automatisierung ausführt.

Bevor Sie beginnen

Bevor Sie das folgende Verfahren ausführen, stellen Sie sicher, dass Sie eine IAM-Dienstrolle erstellt haben, die die für die Ausführung des Runbooks erforderlichen Berechtigungen enthält, und eine Vertrauensstellung für Automation, ein Tool in, konfiguriert haben. AWS Systems Manager Weitere Informationen finden Sie unter Aufgabe 1: Erstellen einer Servicerolle für Automation.

So erstellen Sie eine Zuordnung zum Ausführen einer Automatisierung

Installieren und konfigurieren Sie das AWS CLI oder das AWS Tools for PowerShell, falls Sie das noch nicht getan haben.

Weitere Informationen finden Sie unter Installieren oder Aktualisieren der neuesten Version der AWS CLI und Installieren des AWS Tools for PowerShell.
Nutzen Sie den folgenden Befehl, um eine Liste der Dokumente anzuzeigen.
Linux & macOS
```
aws ssm list-documents
```
Windows
```
aws ssm list-documents
```
PowerShell
```
Get-SSMDocumentList
```
Notieren Sie den Namen des Runbooks, das Sie für die Zuordnung verwenden möchten.
Führen Sie den folgenden Befehl aus, um Details des Runbooks einsehen zu können: Ersetzen Sie den Befehl im folgenden Befehl runbook name durch Ihre eigenen Informationen.
Linux & macOS
```
aws ssm describe-document \
--name runbook name
```
Notieren Sie einen Parameternamen (z. B. InstanceId), den Sie für die Option --automation-target-parameter-name verwenden möchten. Dieser Parameter bestimmt den Typ der Ressource, für die die Automatisierung ausgeführt wird.
Windows
```
aws ssm describe-document ^
--name runbook name
```
Notieren Sie einen Parameternamen (z. B. InstanceId), den Sie für die Option --automation-target-parameter-name verwenden möchten. Dieser Parameter bestimmt den Typ der Ressource, für die die Automatisierung ausgeführt wird.
PowerShell
```
Get-SSMDocumentDescription `
-Name runbook name
```
Notieren Sie einen Parameternamen (z. B. InstanceId), den Sie für die Option AutomationTargetParameterName verwenden möchten. Dieser Parameter bestimmt den Typ der Ressource, für die die Automatisierung ausgeführt wird.

Erstellen Sie einen Befehl, der eine Automatisierung mit einem ausführt State Manager Assoziation. Ersetzen Sie jeden example resource placeholder durch Ihre Informationen.

Ausrichtung mithilfe von Tags

Linux & macOS


aws ssm create-association \
--association-name association name \
--targets Key=tag:key name,Values=value \
--name runbook name \
--parameters AutomationAssumeRole=arn:aws:iam::123456789012:role/RunbookAssumeRole \
--automation-target-parameter-name target parameter \
--schedule "cron or rate expression"

Anmerkung

Wenn Sie eine Assoziation mithilfe von erstellen AWS CLI, verwenden Sie den --targets Parameter, um Instances als Ziel für die Zuordnung festzulegen. Verwenden Sie nicht den Parameter --instance-id. Der Parameter --instance-id ist veraltet.

Windows


aws ssm create-association ^
--association-name association name ^
--targets Key=tag:key name,Values=value ^
--name runbook name ^
--parameters AutomationAssumeRole=arn:aws:iam::123456789012:role/RunbookAssumeRole ^
--automation-target-parameter-name target parameter ^
--schedule "cron or rate expression"

Anmerkung

PowerShell


$Targets = New-Object Amazon.SimpleSystemsManagement.Model.Target
$Targets.Key = "tag:key name"
$Targets.Values = "value"

New-SSMAssociation `
-AssociationName "association name" `
-Target $Targets `
-Name "runbook name" `
-Parameters @{
"AutomationAssumeRole"="arn:aws:iam::123456789012:role/RunbookAssumeRole" } `
-AutomationTargetParameterName "target parameter" `
-ScheduleExpression "cron or rate expression"

Anmerkung

Wenn Sie eine Assoziation mithilfe von erstellen AWS Tools for PowerShell, verwenden Sie den Target Parameter, um Instances als Ziel für die Zuordnung festzulegen. Verwenden Sie nicht den Parameter InstanceId. Der Parameter InstanceId ist veraltet.

Ausrichtung mithilfe von Parameterwerten

Targeting mit AWS Resource Groups

Targeting mehrerer Konten und Regionen

Der Befehl gibt Details für die neue Zuordnung zurück, die den folgenden ähneln.

Linux & macOS

{
"AssociationDescription": {
    "ScheduleExpression": "cron(0 7 ? * MON *)",
    "Name": "AWS-StartEC2Instance",
    "Parameters": {
        "AutomationAssumeRole": [
            "arn:aws:iam::123456789012:role/RunbookAssumeRole"
        ]
    },
    "Overview": {
        "Status": "Pending",
        "DetailedStatus": "Creating"
    },
    "AssociationId": "1450b4b7-bea2-4e4b-b340-01234EXAMPLE",
    "DocumentVersion": "$DEFAULT",
    "AutomationTargetParameterName": "InstanceId",
    "LastUpdateAssociationDate": 1564686638.498,
    "Date": 1564686638.498,
    "AssociationVersion": "1",
    "AssociationName": "CLI",
    "Targets": [
        {
            "Values": [
                "DEV"
            ],
            "Key": "tag:ENV"
        }
    ]
}
}

Windows

{
"AssociationDescription": {
    "ScheduleExpression": "cron(0 7 ? * MON *)",
    "Name": "AWS-StartEC2Instance",
    "Parameters": {
        "AutomationAssumeRole": [
            "arn:aws:iam::123456789012:role/RunbookAssumeRole"
        ]
    },
    "Overview": {
        "Status": "Pending",
        "DetailedStatus": "Creating"
    },
    "AssociationId": "1450b4b7-bea2-4e4b-b340-01234EXAMPLE",
    "DocumentVersion": "$DEFAULT",
    "AutomationTargetParameterName": "InstanceId",
    "LastUpdateAssociationDate": 1564686638.498,
    "Date": 1564686638.498,
    "AssociationVersion": "1",
    "AssociationName": "CLI",
    "Targets": [
        {
            "Values": [
                "DEV"
            ],
            "Key": "tag:ENV"
        }
    ]
}
}

PowerShell

Name                  : AWS-StartEC2Instance
InstanceId            : 
Date                  : 8/1/2019 7:31:38 PM
Status.Name           : 
Status.Date           : 
Status.Message        : 
Status.AdditionalInfo :

Anmerkung

Wenn Sie auf einer oder mehreren Instances eine Zuordnung anhand von Tags erstellen und von einer dieser Instances die Tags entfernen, wird die Zuordnung auf dieser Instance nicht mehr ausgeführt. Die Instance ist von der getrennt State Manager Dokumente

Fehlerbehebung bei Automatisierungen, die ausgeführt werden von State Manager Verbände

Systems Manager setzt ein Limit von 100 gleichzeitigen Automatisierungen und 1.000 Automatisierungen in der Warteschlange pro Konto und Region. Wenn ein State Manager Eine Assoziation, die ein Runbook verwendet, zeigt den Status Fehlgeschlagen und den detaillierten Status an AutomationExecutionLimitExceeded, dann hat Ihre Automatisierung möglicherweise das Limit erreicht. Daher drosselt Systems Manager die Automatisierungen. Führen Sie folgende Schritte aus, um dieses Problem zu lösen:

Verwenden Sie einen anderen Rate- oder Cron-Ausdruck für Ihre Zuordnung. Beispiel: Wenn die Zuordnung alle 30 Minuten ausgeführt werden soll, ändern Sie den Ausdruck so, dass er jede Stunde oder alle zwei Stunden ausgeführt wird.
Löschen Sie vorhandene Automatisierungen mit dem Status Pending (Ausstehend). Durch Löschen dieser Automatisierungen bereinigen Sie die aktuelle Warteschlange.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Ausführen einer Automatisierung Schritt für Schritt

Planen von Automatisierungen mit Wartungsfenstern

Planungsautomatisierungen mit State Manager Verbände

Bevor Sie beginnen

Erstellen einer Zuordnung, die eine Automatisierung ausführt (Konsole)

Um eine zu erstellen State Manager Assoziation, die eine Automatisierung ausführt

Anmerkung

Wichtig

Anmerkung

Wichtig

Erstellen einer Zuordnung, die eine Automatisierung ausführt (Befehlszeile)

Bevor Sie beginnen

So erstellen Sie eine Zuordnung zum Ausführen einer Automatisierung

Anmerkung

Anmerkung

Anmerkung

Anmerkung

Fehlerbehebung bei Automatisierungen, die ausgeführt werden von State Manager Verbände