Arbeiten mit Systems-Manager-Automation-Dokumenten - AWS Toolkit for VS Code
Annahmen und VoraussetzungenIAM-Berechtigungen für Dokumente zur Automatisierung von Systems ManagerErstellen eines neuen Systems-Manager-Automation-dokumentsÖffnen eines bestehenden Systems-Manager-Automation-dokumentsBearbeiten eines Systems-Manager-Automation-DokumentsVeröffentlichen eines Dokuments zur Automatisierung von Systems ManagerLöschen eines Systems-Manager-Automation-DokumentsAusführen eines Systems-Manager-Automation-Dokuments

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.

Arbeiten mit Systems-Manager-Automation-Dokumenten

AWS Systems Managerbietet Ihnen Transparenz und Kontrolle über Ihre Infrastruktur aufAWS. Systems Manager verfügt über eine einheitliche Benutzeroberfläche zum Anzeigen von operativen Daten aus mehreren AWS-Services, damit Sie operative Aufgaben in Ihren AWS-Ressourcen automatisieren können.

Ein Systems-Manager-Dokument definiert die Aktionen, die Systems Manager auf Ihren verwalteten Instances durchführt. Ein Automatisierungsdokument ist eine Art Systems-Manager-Dokument, das Sie verwenden, um allgemeine Wartungs- und Bereitstellungsaufgaben wie das Erstellen oder Aktualisieren eines Amazon Machine Image (AMI) durchzuführen. In diesem Thema wird beschrieben, wie Dokumente zur Automatisierung mitAWS Toolkit for Visual Studio Code.

Themen

Annahmen und Voraussetzungen

Bevor Sie beginnen, stellen Sie Folgendes sicher:

IAM-Berechtigungen für Dokumente zur Automatisierung von Systems Manager

Im Toolkit for VS Code müssen Sie über ein Anmeldeprofil verfügen, dasAWS Identity and Access Management(IAM) -Berechtigungen, die zum Erstellen, Veröffentlichen und Löschen von Dokumenten zur Automatisierung von Systems Manager Automation-Dokumenten erforderlich sind Das folgende Richtliniendokument definiert die erforderlichen IAM-Berechtigungen, die in einer Hauptrichtlinie verwendet werden können:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:CreateDocument",
                "ssm:UpdateDocument",
                "ssm:UpdateDocumentDefaultVersion",
                "ssm:DeleteDocument"
            ],
            "Resource": "*"
        }
    ]
}

Informationen zum Aktualisieren einer IAM-Richtlinie finden Sie unter Erstellen von IAM-Richtlinien im IAM-Benutzerhandbuch. Informationen zum Einrichten Ihres Anmeldeprofils finden Sie unterAWS IAM-Anmeldeinformationen.

Erstellen eines neuen Systems-Manager-Automation-dokuments

Sie können ein neues Automatisierungsdokument inJSONoderYAMLmit Visual Studio Code. Wenn Sie ein neues Automatisierungsdokument erstellen, wird es in einer unbenannten Datei dargestellt. Sie können Ihre Datei benennen und in VS-Code speichern, der Name der Datei ist jedoch nicht sichtbarAWS.

Erstellen Sie ein neues Automation-dokument

  1. Öffnen Sie VS-Code.

  2. Auf derAnzeigenMenü, wählen Sie-Befehlspaletteum die Befehlspalette zu öffnen.

  3. Geben Sie in der BefehlspaletteAWSToolkit Erstellen Sie lokal ein neues Systems-Manager-Dokument.

  4. Wählen Sie eine der Startervorlagen für ein Hello-World-Beispiel aus.

  5. Wählen Sie JSON oder YAML.

    Ein neues Automatisierungsdokument wird erstellt.

Anmerkung

Ihr neues Automatisierungsdokument in VS Code erscheint nicht automatisch inAWS. Sie müssen es auf AWS veröffentlichen, bevor Sie es ausführen können.

Öffnen eines bestehenden Systems-Manager-Automation-dokuments

Du benutztAWSExplorer, um vorhandene Dokumente zur Automatisierung von Systems Manager Automation-Explorer Wenn Sie ein vorhandenes Automation-dokument öffnen, wird es als unbenannte Datei in VS-Code angezeigt.

So öffnen Sie Ihr Automatisierungsdokument

  1. Öffnen Sie VS-Code.

  2. Wählen Sie in der linken NavigationsleisteAWSumAWS-Explorer.

  3. In derAWS-Explorer, fürSystems Manager, wählen Sie das Downloadsymbol auf dem Dokument, das Sie öffnen möchten, und wählen Sie dann die Dokumentversion aus. Die Datei wird im Format für diese Version geöffnet. Andernfalls wählen Sie entwederAls JSON herunterladenoderAls YAML herunterladen.

Anmerkung

Wenn Sie ein Automatisierungsdokument lokal als Datei in VS Code speichern, wird es nicht in angezeigtAWS. Es muss veröffentlicht werden aufAWSvor der Ausführung.

Bearbeiten eines Systems-Manager-Automation-Dokuments

Wenn Sie Automatisierungsdokumente besitzen, werden diese in derIm Besitz von mirKategorie der Systems Manager Manager-Dokumente in derAWS-Explorer. Sie können Automatisierungsdokumente besitzen, die bereits inAWS, und Sie können Eigentümer neuer oder aktualisierter Dokumente sein, in denen Sie zuvor veröffentlicht habenAWSvon VS Code.

Wenn Sie ein Automationsdokument zur Bearbeitung in VS Code öffnen, können Sie mehr daraus machen als imAWS Management Console. Zum Beispiel:

  • Es gibt eine Schemaüberprüfung für beideJSONundYAML-Formate.

  • Im Dokumenteditor stehen Snippets zur Verfügung, mit denen Sie jeden der Automatisierungsschritttypen erstellen können.

  • Es gibt Unterstützung für die automatische Vervollständigung verschiedener Optionen inJSONundYAML.

Arbeiten mit Versionen

Dokumente zur Automatisierung von Systems Manager Automation-Versionen für das Änderungsmanagement. Sie können die Standardversion für ein Automatisierungsdokument in VS Code auswählen.

Legen Sie eine Standardversion fest wie folgt

  • Navigieren Sie im AWS Explorer zu dem Dokument, für das Sie die Standardversion festlegen möchten, öffnen Sie das Kontextmenü (Rechtsklick) für das Dokument und wählen Sie Set default version (Standardversion festlegen).

    Anmerkung

    Wenn das ausgewählte Dokument nur eine Version enthält, können Sie den Standardwert nicht ändern.

Veröffentlichen eines Dokuments zur Automatisierung von Systems Manager

Nachdem Sie Ihr Automatisierungsdokument in VS-Code bearbeitet haben, können Sie es aufAWS.

So veröffentlich Sie Ihr Automatisierungsdokument

  1. Öffnen Sie das Automationdokument, das Sie veröffentlichen möchten, mit dem in beschriebenen VerfahrenÖffnen eines bestehenden Systems-Manager-Automation-dokuments.

  2. Nehmen Sie die Änderungen vor, die veröffentlicht werden sollen. Weitere Informationen finden Sie unter Bearbeiten eines Systems-Manager-Automation-Dokuments.

  3. Wählen Sie rechts unten in der geöffneten Datei das Uploadsymbol aus.

  4. Wählen Sie im Dialogfeld des VeröffentlichungsarbeitsablaufsAWS-Region, in der Sie das Automatisierungsdokument veröffentlichen möchten

  5. Wenn Sie ein neues Dokument veröffentlichen, wählen SieQuick Create. Wählen Sie andernfallsQuick Updateum ein vorhandenes Automatisierungsdokument darin zu aktualisierenAWSRegion :

  6. Geben Sie den Namen für dieses Automatisierungsdokument ein.

Wenn Sie ein Update für ein vorhandenes Automatisierungsdokument in veröffentlichenAWSwird dem Dokument eine neue Version hinzugefügt.

Löschen eines Systems-Manager-Automation-Dokuments

Sie können Automatisierungsdokumente in VS-Code löschen. Durch das Löschen eines Automatisierungsdokuments werden das Dokument und alle Versionen des Dokuments gelöscht.

Wichtig

  • Löschen ist eine zerstörerische Aktion, die nicht rückgängig gemacht werden kann.

  • Durch das Löschen eines Automatisierungsdokuments, das bereits ausgeführt wurde, wird dasAWSRessourcen, die beim Start erstellt oder geändert wurden.

So löschen Sie Ihr Automatisierungsdokument

  1. Öffnen Sie VS-Code.

  2. Wählen Sie in der linken NavigationsleisteAWSumAWS-Explorer.

  3. In derAWS-Explorer, fürSystems Manager, öffnen Sie das Kontextmenü (rechte Maustaste) für das Dokument, das Sie löschen möchten, und wählen SieDokument löschen.

Ausführen eines Systems-Manager-Automation-Dokuments

Sobald Ihr Automatisierungsdokument in veröffentlicht wurdeAWSkönnen Sie es ausführen, um Aufgaben in Ihrem Namen in IhremAWSKonto. Um Ihr Automatisierungsdokument auszuführen, verwenden Sie die AWS Management Console, die Systems-Manager-APIs, die AWS CLI oder AWS -Tools für PowerShell. Anweisungen zum Ausführen eines Automationdokuments finden Sie unterAusführen einer einfachen AutomatisierungimAWS Systems ManagerBenutzerhandbuch.

Wenn Sie alternativ eines der AWS-SDKs mit den Systems-Manager-APIs verwenden möchten, um Ihr Automatisierungsdokument auszuführen, lesen Sie die AWS-SDK-Referenzen.

Anmerkung

Durch das Ausführen eines Automatisierungsdokuments können neue Ressourcen inAWSund kann Abrechnungskosten verursachen. Wir empfehlen Ihnen dringend nachzuvollziehen, was Ihr Automatisierungsdokument in Ihrem Konto erstellt, bevor Sie es starten.