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.

SSMDokumentinhalte erstellen

Wenn die AWS Systems Manager öffentlichen Dokumente nicht alle Aktionen ausführen, die Sie für Ihre AWS Ressourcen ausführen möchten, können Sie Ihre eigenen SSM Dokumente erstellen. Sie können SSM Dokumente auch mithilfe der Konsole klonen. Beim Klonen von Dokumenten werden Inhalte aus einem vorhandenen Dokument in ein neues Dokument kopiert, das Sie ändern können. Beim Erstellen oder Klonen eines Dokuments darf der Inhalt des Dokuments 64 KB nicht überschreiten. Dieses Kontingent beinhaltet auch den zur Laufzeit für Eingabeparameter angegebenen Inhalt. Wenn Sie ein neues Command- oder Policy-Dokument erstellen, wird empfohlen, Schemaversion 2.2 oder höher zu verwenden, damit Sie die neuesten Features wie Dokumentbearbeitung, automatisches Versioning, Sequenzierung usw. nutzen können.

Schreiben von SSM-Dokumentinhalt

Um Ihren eigenen SSM Dokumentinhalt zu erstellen, ist es wichtig, die verschiedenen Schemas, Funktionen, Plug-ins und Syntax zu verstehen, die für SSM Dokumente verfügbar sind. Wir empfehlen Ihnen, sich mit den folgenden Ressourcen vertraut zu machen.

AWS Mit vordefinierten SSM Dokumenten können einige der von Ihnen benötigten Aktionen ausgeführt werden. Sie können diese Dokumente aufrufen, indem Sie die aws:executeAutomation Plug-ins aws:runDocumentaws:runCommand, oder in Ihrem benutzerdefinierten SSM Dokument verwenden, je nach Dokumenttyp. Sie können auch Teile dieser Dokumente in ein benutzerdefiniertes SSM Dokument kopieren und den Inhalt nach Ihren Anforderungen bearbeiten.

Ein SSM Dokument klonen

Sie können AWS Systems Manager Dokumente mithilfe der Systems Manager Documents Console klonen, um SSM Dokumente zu erstellen. Beim Klonen von SSM Dokumenten werden Inhalte aus einem vorhandenen Dokument in ein neues Dokument kopiert, das Sie ändern können. Sie können kein Dokument klonen, das größer als 64 KB ist.

Nachdem Sie Ihren SSM Dokumentinhalt geschrieben haben, können Sie Ihren Inhalt verwenden, um mithilfe einer der folgenden Methoden ein SSM Dokument zu erstellen.

Erstellen von zusammengesetzten Dokumenten

Ein Verbunddokument AWS Systems Manager (SSM) ist ein benutzerdefiniertes Dokument, das eine Reihe von Aktionen ausführt, indem es ein oder mehrere SSM Sekundärdokumente ausführt. Bei zusammengesetzten Dokumenten wird Infrastruktur als Code dargestellt, indem Sie SSM Standarddokumente für allgemeine Aufgaben wie Boot-Strapping-Software oder Domänenbeitritt erstellen können. Sie können diese Dokumente dann gemeinsam nutzen, um den AWS-Konten Wartungsaufwand AWS-Region zu reduzieren und die Konsistenz zu gewährleistenSSM.

Sie können beispielsweise ein zusammengesetztes Dokument erstellen, das die folgenden Aktionen ausführt:

In diesem Beispiel enthält Ihr benutzerdefiniertes SSM Dokument die folgenden Plugins, um diese Aktionen auszuführen:

Zusammengesetzte und sekundäre Dokumente können in Systems Manager GitHub (öffentliche und private Repositorys) oder Amazon S3 gespeichert werden. Zusammengesetzte Dokumente und Sekundärdokumente können in JSON oder YAML erstellt werden.

Um ein zusammengesetztes Dokument zu erstellen, fügen Sie das aws:runDocument Plugin in ein benutzerdefiniertes SSM Dokument ein und geben Sie die erforderlichen Eingaben an. Folgendes ist ein Beispiel eines zusammengesetzten Dokuments, das die folgenden Aktionen ausführt:

{
  "schemaVersion": "2.2",
  "description": "My composite document for bootstrapping software and installing Docker.",
  "parameters": {
  },
  "mainSteps": [
    {
      "action": "aws:downloadContent",
      "name": "downloadContent",
      "inputs": {
        "sourceType": "GitHub",
        "sourceInfo": "{\"owner\":\"TestUser1\",\"repository\":\"TestPublic\", \"path\":\"documents/bootstrap/StateManagerBootstrap.yml\"}",
        "destinationPath": "bootstrap"
      }
    },
    {
      "action": "aws:runDocument",
      "name": "runDocument",
      "inputs": {
        "documentType": "LocalPath",
        "documentPath": "bootstrap",
        "documentParameters": "{}"
      }
    },
    {
      "action": "aws:runDocument",
      "name": "configureDocker",
      "inputs": {
        "documentType": "SSMDocument",
        "documentPath": "AWS-ConfigureDocker",
        "documentParameters": "{\"action\":\"Install\"}"
      }
    }
  ]
}