• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der [Amazon CloudWatch Dashboard-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
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.
# Tutorial: Ein Runbook mithilfe der visuellen Designerfahrung erstellen
In diesem Tutorial lernen Sie die Grundlagen für die Arbeit mit der visuellen Designerfahrung von Systems Manager Automation. In der visuellen Designerfahrung können Sie ein Runbook erstellen, das mehrere Aktionen verwendet. Sie verwenden das Drag-and-Drop-Feature, um Aktionen auf der Arbeitsfläche anzuordnen. Sie suchen auch nach diesen Aktionen, wählen sie aus und konfigurieren sie. Anschließend können Sie den automatisch generierten YAML-Code für den Workflow Ihres Runbooks anzeigen, die visuelle Designerfahrung beenden, das Runbook ausführen und die Ausführungsdetails überprüfen.
In diesem Tutorial erfahren Sie auch, wie Sie das Runbook aktualisieren und die neue Version anzeigen. Am Ende des Tutorials führen Sie einen Bereinigungsschritt durch und löschen Ihr Runbook.
Nachdem Sie dieses Tutorial abgeschlossen haben, wissen Sie, wie Sie mithilfe der visuellen Designerfahrung ein Runbook erstellen können. Sie werden auch wissen, wie Sie Ihr Runbook aktualisieren, ausführen und löschen.
**Anmerkung**
Bevor Sie mit diesem Tutorial beginnen, stellen Sie sicher, dass Sie [Einrichten der Automatisierung](automation-setup.md) abschließen.
**Topics**
+ [Schritt 1: Zur visuellen Designerfahrung navigieren](#navigate-console)
+ [Schritt 2: Einen Workflow erstellen](#create-workflow)
+ [Schritt 3: Den automatisch generierten Code überprüfen](#view-generated-code)
+ [Schritt 4: Ihr neues Runbook ausführen](#use-tutorial-runbook)
+ [Schritt 5: Bereinigen](#cleanup-tutorial-runbook)
## Schritt 1: Zur visuellen Designerfahrung navigieren
1. Melden Sie sich bei der [Systems-Manager-Automation-Konsole](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/) an.
1. Wählen Sie **Automation-Runbook erstellen**.
## Schritt 2: Einen Workflow erstellen
In der visuellen Designerfahrung ist ein Workflow eine grafische Darstellung Ihres Runbooks auf der Arbeitsfläche. Sie können die visuelle Designerfahrung verwenden, um die einzelnen Aktionen Ihres Runbooks zu definieren, zu konfigurieren und zu untersuchen.
**So erstellen Sie ein Workflow**
1. Wählen Sie neben der Option **Design** und **Code** das Stiftsymbol aus und geben Sie einen Namen für Ihr Runbook ein. Geben Sie für dieses Tutorial **VisualDesignExperienceTutorial** ein.
![\[Visuelle Designerfahrung – Ihr Runbook benennen\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/images/visual_designer_tutorial_name.png)
1. Erweitern Sie im Bereich **Dokumentattribute** des Bedienfelds **Formular** die Dropdownliste **Eingabeparameter** und wählen Sie **Parameter hinzufügen** aus.
1. Geben Sie im Feld **Parametername** **InstanceId** ein.
1. Wählen Sie in der Dropdownliste **Typ** die Option **AWS::EC2::Instance**.
1. Wählen Sie den Schalter **Erforderlich** aus.
![\[Einen Parameter für Ihr Runbook erstellen\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/images/visual_designer_actions_tutorial_parameter.png)
1. Geben Sie im **AWS APIs**Browser **DescribeInstances** in die Suchleiste ein.
1. Ziehen Sie eine **Amazon EC2 — DescribeInstances** Aktion auf die leere Leinwand.
1. Geben Sie für **Schrittname** einen Wert ein. Verwenden Sie in diesem Tutorial **GetInstanceState** als Namen.
![\[Wählen Sie eine Amazon-EC2-API-Aktion zum Beschreiben von Instances aus.\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/images/visual_designer_tutorial_api_action.png)
1. Erweitern Sie das Dropdown-Menü **Zusätzliche Eingaben** und geben Sie im Feld **Eingabename** **InstanceIds** ein.
1. Wählen Sie die Registerkarte **Eingaben**.
1. Wählen Sie im Feld **Eingabewert** die **InstanceId** Dokumenteingabe aus. Dies verweist auf den Wert des Eingabeparameters, den Sie zu Beginn des Verfahrens erstellt haben. Da die **InstanceIds**Eingabe für die `DescribeInstances` Aktion `StringList` Werte akzeptiert, müssen Sie die **InstanceId**Eingabe in eckige Klammern setzen. Das YAML für den **Eingabewert sollte dem Folgenden entsprechen**: **['\$1\$1 InstanceId \$1\$1']**.
1. Wählen Sie auf der Registerkarte **Ausgaben** die Option **Ausgabe hinzufügen** aus und geben Sie **InstanceState** in das Feld **Name** ein.
1. Geben Sie **\$1.Reservations[0].Instances[0].State.Name** im Feld **Auswahl** ein.
1. Wählen Sie in der Dropdownliste **Typ** die Option **Zeichenfolge** aus.
1. Ziehen Sie eine **Branch-Aktion** aus dem **Aktionsbrowser** und legen Sie sie unter dem **`GetInstanceState`**-Schritt ab.
1. Geben Sie für **Schrittname** einen Wert ein. Verwenden Sie in diesem Tutorial den Namen `BranchOnInstanceState`.
Um die Branch-Logik zu definieren, führen Sie die folgenden Schritte aus:
1. Wählen Sie den **`Branch`**-Status auf der Arbeitsfläche aus. Wählen Sie dann unter **Eingaben** und **Wahlmöglichkeiten** das Stiftsymbol aus, um **Regel \$11** zu bearbeiten.
1. Wählen Sie **Bedingungen hinzufügen**.
1. Wählen Sie im Dialogfeld **Bedingungen für Regel \$11** die **GetInstanceState.InstanceState**-Schrittausgabe aus der Dropdownliste **Variable** aus.
1. Wählen Sie für **Operator** die Option **Ist gleich** aus.
1. Wählen Sie als **Wert** **Zeichenfolge** aus der Dropdown-Liste aus. Geben Sie **stopped** ein.
![\[Definieren Sie eine Bedingung für eine Branch-Aktion.\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/images/visual_designer_tutorial_condition.png)
1. Wählen Sie **Bedingungen speichern** aus.
1. Wählen Sie **Neue Auswahlregel hinzufügen** aus.
1. Wählen Sie **Bedingungen hinzufügen** für **Regel \$12**.
1. Wählen Sie im Dialogfeld **Bedingungen für Regel \$12** die **GetInstanceState.InstanceState**-Schrittausgabe aus der Dropdownliste **Variable** aus.
1. Wählen Sie für **Operator** die Option **Ist gleich** aus.
1. Wählen Sie als **Wert** **Zeichenfolge** aus der Dropdown-Liste aus. Geben Sie **stopping** ein.
1. Wählen Sie **Bedingungen speichern** aus.
1. Wählen Sie **Neue Auswahlregel hinzufügen** aus.
1. Wählen Sie für **Regel \$13** **Bedingungen hinzufügen**.
1. Wählen Sie im Dialogfeld **Bedingungen für Regel \$13** die **GetInstanceState.InstanceState**-Schrittausgabe aus der Dropdownliste **Variable** aus.
1. Wählen Sie für **Operator** die Option **Ist gleich** aus.
1. Wählen Sie als **Wert** **Zeichenfolge** aus der Dropdown-Liste aus. Geben Sie **running** ein.
1. Wählen Sie **Bedingungen speichern** aus.
1. Wählen Sie in der **Standardregel** für den **Standardschritt** die Option **Gehe zum Ende** aus.
1. Ziehen Sie eine Aktion „**Instanzstatus ändern**“ in das leere Feld „**Aktion hierher ziehen**“ unter dem Feld **\$1\$1 GetInstanceState. InstanceState \$1\$1 == Zustand „gestoppt“**.
1. Geben Sie als **Schrittnamen** **StartInstance** ein.
1. Wählen Sie auf der Registerkarte „**Eingaben**“ unter „**Instanz IDs**“ den Eingabewert für **InstanceId**das Dokument aus der Dropdownliste aus.
1. Geben Sie für den **gewünschten Status** **`running`** an.
1. Ziehen Sie eine Aktion „**Auf AWS Ressource warten**“ in das leere Feld **Aktion hierher ziehen** unter dem Feld **\$1\$1 GetInstanceState. InstanceState \$1\$1 == Zustand „stoppt“**.
1. Geben Sie für **Schrittname** einen Wert ein. Verwenden Sie in diesem Tutorial den Namen `WaitForInstanceStop`.
1. Wählen Sie für das Feld **Service** **Amazon EC2** aus.
1. Wählen Sie für das **API-Feld **DescribeInstances****.
1. Geben Sie für das Feld **Eigenschaftsauswahl** den Wert **\$1.Reservations[0].Instances[0].State.Name** ein.
1. Geben **`["stopped"]`** Sie für den Parameter **Gewünschte Werte** ein.
1. Wählen Sie auf der Registerkarte „**Konfiguration**“ der **WaitForInstanceStop**Aktion die Option „**Nächster Schritt**“ **StartInstance**aus.
1. Ziehen Sie die Aktion **„Befehl auf Instanzen ausführen**“ in das leere Feld **Aktion hierher ziehen** unter **\$1\$1 GetInstanceState. InstanceState \$1\$1 == Zustand „läuft“**.
1. Geben Sie als **Schrittnamen** **SayHello** ein.
1. Geben Sie auf der Registerkarte **Eingaben** den Wert **AWS-RunShellScript** für den Parameter **Dokumentname** ein.
1. Wählen Sie für **InstanceIds**den **InstanceId**Dokumenteingabewert aus der Dropdownliste aus.
1. Erweitern Sie das Dropdownmenü **Zusätzliche Eingaben** und wählen Sie im Dropdownmenü **Eingabename** die Option **Parameter** aus.
1. Geben Sie im Feld **Eingabewert** **`{"commands": "echo 'Hello World'"}`** ein.
1. Prüfen Sie das fertige Runbook auf der Arbeitsfläche und wählen Sie **Runbook erstellen** aus, um das Tutorial-Runbook zu speichern.
![\[Überprüfen und erstellen Sie das Runbook.\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/images/visual_designer_tutorial_complete.png)
## Schritt 3: Den automatisch generierten Code überprüfen
Wenn Sie Aktionen aus dem Browser **Aktion** auf die Arbeitsfläche ziehen und dort ablegen, erstellt die visuelle Designerfahrung automatisch den YAML- oder JSON-Inhalt Ihres Runbooks in Echtzeit. Sie können diesen Code anzeigen und bearbeiten. Um den automatisch generierten Code anzuzeigen, wählen Sie **Code** für die Umschalter **Design** und **Code** aus.
## Schritt 4: Ihr neues Runbook ausführen
Nachdem Sie Ihr Runbook erstellt haben, können Sie die Automatisierung ausführen.
**So führen Sie Ihr neues Automation-Runbook aus**
1. Öffnen Sie die AWS Systems Manager Konsole unter. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Wählen Sie im Navigationsbereich **Automatisierung** und **Automatisierung ausführen** aus.
1. Wählen Sie in der Liste **Automation-Dokument** ein Runbook. Wählen Sie eine oder mehrere Optionen im Bereich **Dokumentkategorien**, um SSM-Dokumente nach ihrem Zweck zu filtern. Um ein Runbook anzuzeigen, das Sie besitzen, wählen Sie die **Im Besitz von mir**-Registerkarte. Um ein Runbook anzuzeigen, das für Ihr Konto freigegeben ist, wählen Sie die Registerkarte **Mit mir geteilt**. Um alle Runbooks anzuzeigen, wählen Sie die Registerkarte **Alle Dokumente**.
**Anmerkung**
Sie können Informationen zu einem Runbook einsehen, indem Sie den Runbook-Namen auswählen.
1. Überprüfen Sie im Abschnitt **Dokument-Details**, ob **Dokumentversion** auf die Version gesetzt ist, die Sie ausführen möchten. Das System bietet die folgenden Versionsoptionen:
+ **Standardversion zur Laufzeit** – Wählen Sie diese Option aus, wenn das Automation-Runbook regelmäßig aktualisiert wird und eine neue Standardversion zugewiesen ist.
+ **Letzte Version zur Laufzeit** – Wählen Sie diese Option aus, wenn das Automation-Runbook regelmäßig aktualisiert wird, und Sie die Version auszuführen möchten, die zuletzt aktualisiert wurde.
+ **1 (Standard)** – Wählen Sie diese Option zur Ausführung der ersten Version des Dokuments, welches der Standard ist.
1. Wählen Sie **Weiter** aus.
1. Klicken Sie auf der Seite **Automation-Runbook ausführen** auf **Einfache Ausführung**.
1. Geben Sie im Abschnitt **Eingabeparameter** die erforderlichen Eingaben an. Optional können Sie eine IAM-Dienstrolle aus der **AutomationAssumeRole**Liste auswählen.
1. (Optional) Wählen Sie einen CloudWatch Amazon-Alarm aus, der auf Ihre Automatisierung zur Überwachung angewendet werden soll. Um Ihrer Automatisierung einen CloudWatch Alarm zuzuweisen, muss der IAM-Principal, der die Automatisierung startet, über die Genehmigung für die `iam:createServiceLinkedRole` Aktion verfügen. Weitere Informationen zu CloudWatch Alarmen finden Sie unter [ CloudWatchAmazon-Alarme verwenden](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Wenn die Automatisierung gestoppt wird, wird Ihr Alarm aktiviert. Wenn Sie AWS CloudTrail verwenden, sehen Sie den API-Aufruf in Ihrem Trail.
1. Wählen Sie **Ausführen**.
## Schritt 5: Bereinigen
**So löschen Sie Ihr Runbook**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich die Option **Dokumente** aus.
1. Wählen Sie die Registerkarte **In meinem Besitz** aus.
1. Suchen Sie das **VisualDesignExperienceTutorial**Runbook.
1. Wählen Sie die Schaltfläche auf der Dokumentkartenseite aus und wählen Sie dann in der Dropdownliste **Aktionen** die Option **Dokument löschen** aus.