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.
Verwenden von Document Builder zur Erstellung von Runbooks
Wenn die öffentlichen AWS Systems Manager-Runbooks nicht alle Aktionen unterstützen, die Sie mit Ihren AWS-Ressourcen durchführen möchten, können Sie Ihre eigenen Runbooks erstellen. Um ein benutzerdefiniertes Runbook zu erstellen, können Sie manuell eine lokale Datei im YAML- oder JSON-Format mit den entsprechenden Automatisierungsaktionen erstellen. Alternativ können Sie Document Builder in der Systems-Manager-Automation-Konsole verwenden, um ein benutzerdefiniertes Runbook zu erstellen.
Mit Document Builder können Sie Ihrem benutzerdefinierten Runbook Automatisierungsaktionen hinzufügen und die erforderlichen Parameter bereitstellen, ohne die JSON- oder YAML-Syntax verwenden zu müssen. Nachdem Sie Schritte hinzugefügt und das Runbook erstellt haben, konvertiert das System die von Ihnen hinzugefügten Aktionen in das YAML-Format, das von Systems Manager zum Ausführen von Automation verwendet werden kann.
Runbooks unterstützen die Verwendung von Markdown, einer Markup-Sprache, mit der Sie Wiki-Beschreibungen zu Runbooks und einzelnen Schritten innerhalb des Runbooks hinzufügen können. Weitere Informationen zur Verwendung von Markdown finden Sie unter Verwenden von Markdown in AWS.
Erstellen eines Runbooks mithilfe von Document Builder
Bevor Sie beginnen
Wir empfehlen Ihnen, sich über die verschiedenen Aktionen zu informieren, die Sie in einem Runbook verwenden können. Weitere Informationen finden Sie unter Systems Manager Automation Aktionen-Referenz.
So erstellen Sie ein Runbook mit Document Builder
Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/
. Wählen Sie im Navigationsbereich die Option Dokumente aus.
-
Wählen Sie Create automation (Automation erstellen).
-
Geben Sie unter Name einen aussagekräftigen Namen für das Runbook ein.
-
Geben Sie für Document description (Dokumentbeschreibung) die Beschreibung des Markdown-Stils für das Runbook an. Sie können Anweisungen für die Verwendung des Runbooks, nummerierte Schritte oder jede andere Art von Informationen zur Beschreibung des Runbooks bereitstellen. Informationen zum Formatieren von Inhalten finden Sie im Standardtext.
Tipp
Wechseln Sie zwischen Hide preview (Vorschau ausblenden) und Show preview (Vorschau anzeigen), um zu sehen, wie der Beschreibungsinhalt während der Erstellung aussieht.
-
(Optional) Geben Sie unter Assume role (Rolle übernehmen) den Namen oder den ARN einer Servicerolle ein, um Aktionen in Ihrem Auftrag auszuführen. Wenn Sie keine Rolle angeben, verwendet Automation die Zugriffsberechtigungen des Benutzers, der die Automatisierung durchführt.
Wichtig
Für Runbooks, die sich nicht im Besitz von Amazon befinden und die die
aws:executeScript
-Aktion verwenden, muss eine Rolle angegeben werden. Weitere Informationen finden Sie unter Berechtigungen für die Verwendung von Runbooks. -
(Optional) Geben Sie unter Outputs (Ausgänge) alle Ausgaben für die Automatisierung dieses Runbooks ein, um sie für andere Prozesse verfügbar zu machen.
Wenn Ihr Runbook beispielsweise ein neues AMI erstellt, können Sie ["CreateImage.ImageId"] angeben und dann mit dieser Ausgabe neue Instances in einer nachfolgenden Automatisierung erstellen.
-
(Optional) Erweitern Sie den Abschnitt Input parameters (Eingabeparameter) und führen Sie die folgenden Schritte aus.
-
Geben Sie unter Parameter name (Parametername) einen beschreibenden Namen für den Runbookparameter ein, den Sie erstellen.
-
Wählen Sie unter Type (Typ) einen Typ für den Parameter, z. B.
String
oderMapList
. -
Führen Sie unter Required (Erforderlich) eine der folgenden Aktionen aus:
-
Wählen Sie Yes (Ja), wenn zur Laufzeit ein Wert für diesen Runbookparameter angegeben werden muss.
-
Wählen Sie No (Nein), wenn der Parameter nicht erforderlich ist, und geben Sie (optional) unter Default value (Standardwert) einen Standardparameterwert ein.
-
-
Geben Sie unter Description (Beschreibung) eine Beschreibung für den Runbookparameter ein.
Anmerkung
Um weitere Runbookparameter hinzuzufügen, wählen Sie Add a parameter (Parameter hinzufügen). Um einen Runbookparameter zu entfernen, klicken Sie auf die Schaltfläche X (Entfernen).
-
-
(Optional) Erweitern Sie den Abschnitt Target type (Zieltyp) und wählen Sie einen Zieltyp, um die Arten der Ressourcen zu definieren, auf denen die Automatisierung ausgeführt werden kann. Um beispielsweise ein Runbook auf EC2-Instances zu wählen, wählen Sie
/AWS::EC2::Instance
.Anmerkung
Wenn Sie den Wert '
/
' angeben, kann das Runbook auf allen Arten von Ressourcen ausgeführt werden. Eine Liste gültiger Ressourcentypen finden Sie unter AWS-Ressourcentypen – Referenz im AWS CloudFormationBenutzerhandbuch. -
(Optional) Erweitern Sie den Abschnitt Document tags (Dokument-Tags) und geben Sie ein oder mehrere Tag-Schlüssel-Wert-Paare ein, die auf das Runbook angewendet werden sollen. Tags erleichtern die Identifizierung, Organisation und Suche nach Ressourcen.
-
Geben Sie im Abschnitt Step 1 (Schritt 1) die folgenden Informationen an.
-
Geben Sie unter Step name (Schrittname) einen beschreibenden Namen für den ersten Schritt der Automatisierung ein.
-
Wählen Sie unter Action type (Aktionstyp) den Aktionstyp aus, der für diesen Schritt verwendet werden soll.
Eine Liste und Informationen zu den verfügbaren Aktionstypen finden Sie unter Systems Manager Automation Aktionen-Referenz.
-
Geben Sie unter Description (Beschreibung) eine Beschreibung für den Automatisierungsschritt ein. Sie können Markdown verwenden, um Ihren Text zu formatieren.
-
Je nach ausgewähltem Action type (Aktionstyp) geben Sie im Abschnitt Step inputs (Schritteingaben) die erforderlichen Eingaben für den Aktionstyp ein. Wenn Sie beispielsweise die Aktion
aws:approve
ausgewählt haben, müssen Sie einen Wert für dieApprovers
-Eigenschaft angeben.Informationen zu den Schritteingabefeldern finden Sie im Eintrag Systems Manager Automation Aktionen-Referenz für den ausgewählten Aktionstyp. Beispiel: aws:executeStateMachine – Führen Sie eine AWS Step Functions-State Machine aus..
-
(Optional) Geben Sie für Additional inputs (Zusätzliche Eingaben) alle zusätzlichen Eingabewerte an, die für das Runbook erforderlich sind. Die verfügbaren Eingabetypen hängen vom Aktionstyp ab, den Sie für den Schritt ausgewählt haben. (Beachten Sie, dass einige Aktionstypen Eingabewerte erfordern.)
Anmerkung
Um weitere Eingaben hinzuzufügen, wählen Sie Add optional input (Optionale Eingabe hinzufügen). Um eine Eingabe zu entfernen, wählen Sie die Schaltfläche X (Entfernen).
-
(Optional) Geben Sie unter Outputs (Ausgänge) alle Ausgaben für diesen Schritts ein, um sie für andere Prozesse verfügbar zu machen.
Anmerkung
Outputs (Ausgaben) sind nicht für alle Aktionstypen verfügbar.
-
(Optional) Erweitern Sie den Abschnitt Common properties (Allgemeine Eigenschaften) und geben Sie Eigenschaften für die Aktionen an, die allen Automation-Aktionen gemeinsam sind. Beispielsweise können Sie für Timeout seconds (Timeout in Sekunden) anhand eines Werts in Sekunden angeben, wie lange der Schritt ausgeführt werden kann, bevor er beendet wird.
Weitere Informationen finden Sie unter Von allen Aktionen gemeinsam genutzte Eigenschaften.
Anmerkung
Um weitere Schritte hinzuzufügen, wählen Sie Add step (Schritt hinzufügen) aus und wiederholen Sie das Verfahren zum Erstellen eines Schritts. Um einen Schritt zu entfernen, wählen Sie Remove step (Schritt entfernen).
-
-
Wählen Sie Create automation (Automation erstellen), um das Runbook zu speichern.
Erstellen eines Runbooks, das Skripte ausführt
Das folgende Verfahren zeigt, wie Sie mit Document Builder in der AWS Systems Manager-Automation-Konsole ein benutzerdefiniertes Runbook erstellen, das ein Skript ausführt.
Im ersten Schritt des von Ihnen erstellten Runbooks wird ein Skript ausgeführt, um eine Amazon Elastic Compute Cloud (Amazon EC2)-Instance zu starten. Im zweiten Schritt wird ein weiteres Skript ausgeführt, um zu überwachen, ob die Instance-Zustandsprüfung auf ok
geändert werden soll. Anschließend wird für die Automatisierung ein Gesamtzustand von Success
gemeldet.
Bevor Sie beginnen
Stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:
-
Stellen Sie sicher, dass Sie über Administratorrechte verfügen oder dass Ihnen die entsprechenden Berechtigungen für den Zugriff auf Systems Manager in AWS Identity and Access Management (IAM) erteilt wurden.
Weitere Informationen finden Sie unter Überprüfen des Benutzerzugriffs für Runbooks.
-
Stellen Sie sicher, dass Sie in Ihrem AWS-Konto über eine IAM-Service-Rolle für Automation (auch als Rolle übernehmen bezeichnet) verfügen. Die Rolle ist erforderlich, da in dieser Anleitung die Aktion
aws:executeScript
verwendet wird.Weitere Informationen zum Erstellen dieser Rolle finden Sie unter Konfigurieren eines Service-Rollenzugriffs (Rolle übernehmen) für Automatisierungen.
Hinweise zur IAM-Service-Rollenanforderung zum Ausführen von
aws:executeScript
, finden Sie unter Berechtigungen für die Verwendung von Runbooks. -
Stellen Sie sicher, dass Sie berechtigt sind, EC2-Instances zu starten.
Informationen zu IAM-Rollen finden Sie unter IAM-Rollen und Amazon EC2 im Amazon-EC2-Benutzerhandbuch.
So erstellen Sie ein benutzerdefiniertes Runbook, das Skripts mit Document Builder ausführt
Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/
. Wählen Sie im Navigationsbereich die Option Dokumente aus.
-
Wählen Sie Create automation (Automation erstellen).
-
Geben Sie unter Name diesen beschreibenden Namen für das Runbook ein:
LaunchInstanceAndCheckStatus
. -
(Optional) Ersetzen Sie bei Document description (Dokumentbeschreibung) den Standardtext durch eine Beschreibung für dieses Runbooks, indem Sie Markdown verwenden. Im Folgenden wird ein Beispiel gezeigt.
##Title: LaunchInstanceAndCheckState ----- **Purpose**: This runbook first launches an EC2 instance using the AMI ID provided in the parameter ```imageId```. The second step of this runbook continuously checks the instance status check value for the launched instance until the status ```ok``` is returned. ##Parameters: ----- Name | Type | Description | Default Value ------------- | ------------- | ------------- | ------------- assumeRole | String | (Optional) The ARN of the role that allows Automation to perform the actions on your behalf. | - imageId | String | (Optional) The AMI ID to use for launching the instance. The default value uses the latest Amazon Linux AMI ID available. | {{ ssm:/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-gp2 }}
-
Geben Sie unter Assume role (Rolle übernehmen) den ARN der IAM-Service-Rolle für Automation (Rolle übernehmen) für die Automatisierung im Format
arn:aws:iam::111122223333:role/AutomationServiceRole
ein. Ersetzen Sie Ihre AWS-Konto-ID mit 111122223333.Die von Ihnen angegebene Rolle wird verwendet, um die Berechtigungen bereitzustellen, die zum Starten der Automatisierung erforderlich sind.
Wichtig
Für Runbooks, die sich nicht im Besitz von Amazon befinden und die die
aws:executeScript
-Aktion verwenden, muss eine Rolle angegeben werden. Weitere Informationen finden Sie unter Berechtigungen für die Verwendung von Runbooks. -
Erweitern Sie Input parameters (Eingabeparameter) und gehen Sie folgendermaßen vor.
-
Geben Sie unter Parameter name (Parametername)
imageId
ein. -
Wählen Sie für Type (Typ) die Option
String
aus. -
Wählen Sie unter Required (Erforderlich) die Option
No
. -
Geben Sie unter Default value (Standardwert) Folgendes ein.
{{ ssm:/aws/service/ami-amazon-linux-latest/amzn-ami-hvm-x86_64-gp2 }}
Anmerkung
Dieser Wert startet eine Amazon-EC2-Instance mit der neuesten Amazon Linux 1 Amazon Machine Image (AMI)-ID. Wenn Sie ein anderes AMI verwenden möchten, ersetzen Sie den Wert durch Ihre AMI-ID.
-
Geben Sie unter Description (Beschreibung) Folgendes ein.
(Optional) The AMI ID to use for launching the instance. The default value uses the latest released Amazon Linux AMI ID.
-
-
Wählen Sie Add a parameter (Parameter hinzufügen), um den zweiten Parameter
tagValue
zu erstellen, und geben Sie Folgendes ein.-
Geben Sie unter Parameter name (Parametername)
tagValue
ein. -
Wählen Sie für Type (Typ) die Option
String
aus. -
Wählen Sie unter Required (Erforderlich) die Option
No
. -
Für Default value (Standardwert) geben Sie
LaunchedBySsmAutomation
ein. Dadurch wird der Instance der Schlüsselpaarwert des TagsName:LaunchedBySsmAutomation
hinzugefügt. -
Geben Sie unter Description (Beschreibung) Folgendes ein.
(Optional) The tag value to add to the instance. The default value is LaunchedBySsmAutomation.
-
-
Wählen Sie Add a parameter (Parameter hinzufügen), um den dritten Parameter
instanceType
zu erstellen, und geben Sie folgende Informationen ein.-
Geben Sie unter Parameter name (Parametername)
instanceType
ein. -
Wählen Sie für Type (Typ) die Option
String
aus. -
Wählen Sie unter Required (Erforderlich) die Option
No
. -
Für Default value (Standardwert) geben Sie
t2.micro
ein. -
Geben Sie unter Parameter description (Parameterbeschreibung) Folgendes ein.
(Optional) The instance type to use for the instance. The default value is t2.micro.
-
-
Erweitern Sie Target type (Zieltyp) und wählen Sie
"/"
. -
(Optional) Erweitern Sie Document tags (Dokument-Tags), um Ressourcen-Tags auf Ihr Runbook anzuwenden. Geben Sie für Tag key (Tag-Schlüssel
Purpose
und für Tag value (Tag-Wert)LaunchInstanceAndCheckState
ein. -
Führen Sie im Abschnitt Step 1 (Schritt 1) die folgenden Schritte aus.
-
Geben Sie unter Step name (Schrittname) diesen beschreibenden Schrittnamen für den ersten Schritt der Automatisierung ein:
LaunchEc2Instance
. -
Wählen Sie unter Action type (Aktionstyp) die Option Run a script (Skript ausführen) (
aws:executeScript
). -
Geben Sie unter Description (Beschreibung) eine Beschreibung für den Automation-Schritt ein, wie etwa folgende.
**About This Step** This step first launches an EC2 instance using the ```aws:executeScript``` action and the provided script.
-
Erweitern Sie Inputs (Eingaben).
-
Wählen Sie für Runtime (Laufzeit) die Laufzeitsprache aus, die zum Ausführen des bereitgestellten Skripts verwendet werden soll.
-
Geben Sie unter Handler
launch_instance
ein. Dies ist der Funktionsname, der im folgenden Skript deklariert wird.Anmerkung
Dies ist für PowerShell nicht erforderlich.
-
Ersetzen Sie für Script (Skript) den Standardinhalt durch Folgendes. Stellen Sie sicher, dass das Skript dem entsprechenden Laufzeitwert entspricht.
-
Erweitern Sie Additional inputs (Zusätzliche Eingaben).
-
Wählen Sie für Input name (Eingabename) die Option InputPayload. Geben Sie unter Input value (Eingabewert) die folgenden YAML-Daten ein.
image_id: "{{ imageId }}" tag_value: "{{ tagValue }}" instance_type: "{{ instanceType }}"
-
-
Erweitern Sie Outputs (Ausgänge) und gehen Sie folgendermaßen vor:
-
Geben Sie unter Name
payload
ein. -
Geben Sie für Selector (Selektor)
$.Payload
ein. -
Wählen Sie für Type (Typ) die Option
StringMap
aus.
-
-
Klicken Sie auf Schritt hinzufügen, um dem Runbook einen zweiten Schritt hinzuzufügen. Der zweite Schritt fragt den Status der in Schritt 1 gestarteten Instance ab und wartet, bis der zurückgegebene Status
ok
ist. -
Gehen Sie im Abschnitt Step 2 (Schritt 2) folgendermaßen vor.
-
Geben Sie unter Step name (Schrittname) diesen beschreibenden Namen für den zweiten Schritt der Automatisierung ein:
WaitForInstanceStatusOk
. -
Wählen Sie unter Action type (Aktionstyp) die Option Run a script (Skript ausführen) (
aws:executeScript
). -
Geben Sie unter Description (Beschreibung) eine Beschreibung für den Automation-Schritt ein, wie etwa folgende.
**About This Step** The script continuously polls the instance status check value for the instance launched in Step 1 until the ```ok``` status is returned.
-
Bei Runtime (Laufzeit) wählen Sie die Laufzeitsprache für die Ausführung des bereitgestellten Skripts verwendet werden soll.
-
Geben Sie unter Handler
poll_instance
ein. Dies ist der Funktionsname, der im folgenden Skript deklariert wird.Anmerkung
Dies ist für PowerShell nicht erforderlich.
-
Ersetzen Sie für Script (Skript) den Standardinhalt durch Folgendes. Stellen Sie sicher, dass das Skript dem entsprechenden Laufzeitwert entspricht.
-
Erweitern Sie Additional inputs (Zusätzliche Eingaben).
-
Wählen Sie für Input name (Eingabename) die Option InputPayload. Geben Sie unter Input value (Eingabewert) Folgendes ein:
{{ LaunchEc2Instance.payload }}
-
-
Wählen Sie Create automation (Automation erstellen), um das Runbook zu speichern.