Tutorial: Ein Runbook mithilfe der visuellen Designerfahrung erstellen - AWS Systems Manager
Schritt 1: Zur visuellen Designerfahrung navigierenSchritt 2: Einen Workflow erstellenSchritt 3: Den automatisch generierten Code überprüfenSchritt 4: Ihr neues Runbook ausführenSchritt 5: Bereinigen

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 Designoberfläche 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 abschließen.

  1. Melden Sie sich bei der Systems-Manager-Automation-Konsole an.

  2. 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

  2. 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.

    2. Wählen Sie in der Dropdownliste Typ die Option AWS::: :Instance aus. EC2

    3. Wählen Sie den Schalter Erforderlich aus.

    Einen Parameter für Ihr Runbook erstellen

  3. Geben Sie im AWS APIsBrowser DescribeInstances in die Suchleiste ein.

  4. Ziehe eine Amazon EC2 — DescribeInstances Aktion auf die leere Leinwand.

  5. Geben Sie für Schrittname einen Wert ein. Verwenden Sie in diesem Tutorial GetInstanceState als Namen.

    Wählen Sie eine API Amazon-Aktion zur EC2 Beschreibung von Instanzen aus.

    1. Erweitern Sie das Dropdown-Menü Zusätzliche Eingaben und geben Sie im Feld Eingabename InstanceIds ein.

    2. Wählen Sie die Registerkarte Eingaben.

    3. 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 InstanceIdsEingabe für die DescribeInstances Aktion StringList Werte akzeptiert, müssen Sie die InstanceIdEingabe in eckige Klammern setzen. Der Wert YAML für die Eingabe sollte mit dem Folgenden übereinstimmen:['{{ InstanceId }}'].

    4. Wählen Sie auf der Registerkarte Ausgaben die Option Ausgabe hinzufügen aus und geben Sie InstanceState in das Feld Name ein.

    5. Geben Sie $.Reservations[0].Instances[0].State.Name im Feld Auswahl ein.

    6. Wählen Sie in der Dropdownliste Typ die Option Zeichenfolge aus.

  6. Ziehen Sie eine Branch-Aktion aus dem Aktionsbrowser und legen Sie sie unter dem GetInstanceState-Schritt ab.

  7. 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 #1 zu bearbeiten.

    2. Wählen Sie Bedingungen hinzufügen.

    3. Wählen Sie im Dialogfeld Bedingungen für Regel #1 die GetInstanceState.InstanceState-Schrittausgabe aus der Dropdownliste Variable aus.

    4. Wählen Sie für Operator die Option Ist gleich aus.

    5. Wählen Sie als Wert Zeichenfolge aus der Dropdown-Liste aus. Geben Sie stopped ein.

      Definieren Sie eine Bedingung für eine Branch-Aktion.

    6. Wählen Sie Bedingungen speichern aus.

    7. Wählen Sie Neue Auswahlregel hinzufügen aus.

    8. Wählen Sie Bedingungen hinzufügen für Regel #2.

    9. Wählen Sie im Dialogfeld Bedingungen für Regel #2 die GetInstanceState.InstanceState-Schrittausgabe aus der Dropdownliste Variable aus.

    10. Wählen Sie für Operator die Option Ist gleich aus.

    11. Wählen Sie als Wert Zeichenfolge aus der Dropdown-Liste aus. Geben Sie stopping ein.

    12. Wählen Sie Bedingungen speichern aus.

    13. Wählen Sie Neue Auswahlregel hinzufügen aus.

    14. Wählen Sie für Regel #3 Bedingungen hinzufügen.

    15. Wählen Sie im Dialogfeld Bedingungen für Regel #3 die GetInstanceState.InstanceState-Schrittausgabe aus der Dropdownliste Variable aus.

    16. Wählen Sie für Operator die Option Ist gleich aus.

    17. Wählen Sie als Wert Zeichenfolge aus der Dropdown-Liste aus. Geben Sie running ein.

    18. Wählen Sie Bedingungen speichern aus.

    19. Wählen Sie in der Standardregel für den Standardschritt die Option Gehe zum Ende aus.

  8. Ziehen Sie eine Aktion „Instanzstatus ändern“ in das leere Feld Aktion hierher ziehen unter dem Feld {{ GetInstanceState. InstanceState }} == Zustand „gestoppt“.

    1. Geben Sie als Schrittnamen StartInstance ein.

    2. Wählen Sie auf der Registerkarte „Eingaben“ unter „Instanz IDs“ den Eingabewert für InstanceIddas Dokument aus der Dropdownliste aus.

    3. Geben Sie für den gewünschten Status running an.

  9. Ziehen Sie eine Aktion „Auf AWS Ressource warten“ in das leere Feld Aktion hierher ziehen unter dem Feld {{ GetInstanceState. InstanceState }} == Zustand „stoppt“.

  10. 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 ausEC2.

    2. Wählen Sie für das APIFeld DescribeInstances.

    3. Geben Sie für das Feld Eigenschaftsauswahl den Wert $.Reservations[0].Instances[0].State.Name ein.

    4. Geben ["stopped"] Sie für den Parameter Gewünschte Werte ein.

    5. Wählen Sie auf der Registerkarte „Konfiguration“ der WaitForInstanceStopAktion die Option „Nächster Schritt“ StartInstanceaus.

  11. Ziehen Sie die Aktion „Befehl auf Instanzen ausführen“ in das leere Feld Aktion hierher ziehen unter {{ GetInstanceState. InstanceState }} == Zustand „läuft“.

  12. Geben Sie als Schrittnamen SayHello ein.

    1. Geben Sie auf der Registerkarte Eingaben den Wert AWS-RunShellScript für den Parameter Dokumentname ein.

    2. Wählen Sie für InstanceIdsden InstanceIdDokumenteingabewert aus der Dropdownliste aus.

    3. Erweitern Sie das Dropdownmenü Zusätzliche Eingaben und wählen Sie im Dropdownmenü Eingabename die Option Parameter aus.

    4. Geben Sie im Feld Eingabewert {"commands": "echo 'Hello World'"} ein.

  13. 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.

Schritt 3: Den automatisch generierten Code überprüfen

Wenn Sie Aktionen aus dem Aktionsbrowser auf die Arbeitsfläche ziehen und dort ablegen, erstellt das visuelle Designerlebnis automatisch den YAML 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/

  2. Wählen Sie im Navigationsbereich Automation (Automatisierung) und Execute automation (Automatisierung ausführen) aus.

  3. Wählen Sie in der Liste Automation-Dokument ein Runbook. Wählen Sie im Bereich Dokumentkategorien eine oder mehrere Optionen aus, 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 Mit mir geteilt-Registerkarte. Um alle Runbooks anzuzeigen, wählen Sie die Alle Dokumente-Registerkarte.

    Anmerkung

    Sie können Informationen zu einem Runbook einsehen, indem Sie den Runbook-Namen auswählen.

  4. Überprüfen Sie im Abschnitt Document details (Dokument-Details), ob Document version (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.

  5. Wählen Sie Weiter.

  6. Klicken Sie auf der Seite Automation-Runbook ausführen auf Einfache Ausführung.

  7. Geben Sie im Abschnitt Input Parameters (Eingabeparameter) die erforderlichen Eingaben an. Optional können Sie eine IAM Servicerolle aus der AutomationAssumeRoleListe auswählen.

  8. (Optional) Wählen Sie einen CloudWatch Amazon-Alarm aus, der auf Ihre Automatisierung zur Überwachung angewendet werden soll. Um Ihrer Automatisierung einen CloudWatch Alarm hinzuzufügen, 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. Wenn die Automatisierung gestoppt wird, wird Ihr Alarm aktiviert. Wenn Sie diese Option verwenden AWS CloudTrail, wird Ihnen der API Anruf in Ihrer Spur angezeigt.

  9. Wählen Sie Execute (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/.

  2. Wählen Sie im Navigationsbereich die Option Documents (Dokumente) aus.

  3. Wählen Sie die Registerkarte In meinem Besitz aus.

  4. Suchen Sie das VisualDesignExperienceTutorialRunbook.

  5. 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.