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.
Ausführen von -Dokumenten von Remote-Standorten
Sie können AWS Systems Manager (SSM) Dokumente von entfernten Standorten aus ausführen, indem Sie das AWS-RunDocument
vordefinierte SSM Dokument verwenden. Dieses Dokument unterstützt das Ausführen von SSM Dokumenten, die an den folgenden Speicherorten gespeichert sind:
-
Öffentliche und private GitHub Repositorien (GitHub Enterprisewird nicht unterstützt)
-
Amazon-S3-Buckets
-
Systems Manager
Sie können zwar auch Remote-Dokumente mithilfe von State Manager oder Automation, Funktionen von ausführen AWS Systems Manager, aber das folgende Verfahren beschreibt nur, wie Sie SSM Remote-Dokumente mithilfe AWS Systems Manager Run Command der Systems Manager Manager-Konsole ausführen.
Anmerkung
AWS-RunDocument
kann nur zum Ausführen von SSM Dokumenten vom Typ Befehl verwendet werden, nicht zum Ausführen anderer Typen wie Automatisierungs-Runbooks. Das AWS-RunDocument
verwendet das aws:downloadContent
-Plugin. Weitere Informationen zum aws:downloadContent
-Plugin finden Sie unter aws:downloadContent.
Bevor Sie beginnen
Bevor Sie ein Remote-Dokument ausführen, müssen Sie die folgenden Aufgaben erledigen.
-
Erstellen Sie ein SSM Befehlsdokument und speichern Sie es an einem entfernten Ort. Weitere Informationen finden Sie unter SSMDokumentinhalte erstellen
-
Wenn Sie ein Remote-Dokument ausführen möchten, das in einem privaten GitHub Repository gespeichert ist, müssen Sie einen Systems Manager
SecureString
Manager-Parameter für Ihr GitHub Sicherheitszugriffstoken erstellen. Sie können nicht auf ein Remote-Dokument in einem privaten GitHub Repository zugreifen, indem Sie Ihr Token manuell übergebenSSH. Das Zugriffstoken muss alsSecureString
-Systems Manager-Parameter übertragen werden. Weitere Informationen zum Erstellen einesSecureString
-Parameters finden Sie unter Erstellen von Systems Manager-Parametern.
Ausführen eines Remote-Dokuments (Konsole)
So führen Sie ein Remote-Dokument aus
Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/
. Wählen Sie im Navigationsbereich Run Command aus.
-
Wählen Sie Run Command (Befehl ausführen) aus.
-
Wählen Sie in der Liste Dokument die Option
AWS-RunDocument
. -
Wählen Sie unter Command parameters (Befehlsparameter) für Source Type (Quelltyp) eine Option aus.
-
Wenn Sie möchten GitHub, geben Sie die Quellinformationen im folgenden Format an:
{ "owner": "
owner_name
", "repository": "repository_name
", "path": "path_to_document
", "getOptions":"branch:branch_name
", "tokenInfo": "{{ssm-secure:secure-string-token
}}" }Beispielsweise:
{ "owner":"TestUser", "repository":"GitHubTestExamples", "path":"scripts/python/test-script", "getOptions":"branch:exampleBranch", "tokenInfo":"{{ssm-secure:my-secure-string-token}}" }
Anmerkung
getOptions
sind zusätzliche Optionen zum Abrufen von Inhalten aus einem anderen Branch als dem Master-Branch oder aus einem bestimmten Commit im Repository.getOptions
kann weggelassen werden, wenn Sie den letzten Commit in der Master-Branch verwenden. Derbranch
Parameter ist nur erforderlich, wenn Ihr SSM Dokument in einer anderen Filiale als gespeichert istmaster
.Um die Version Ihres SSM Dokuments in einem bestimmten Commit in Ihrem Repository zu verwenden, verwenden Sie
commitID
withgetOptions
anstelle vonbranch
. Beispielsweise:"getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",
-
Wenn Sie S3 auswählen, geben Sie für Source Info Informationen in folgendem Format an:
{"path":"
URL_to_document_in_S3
"}Beispielsweise:
{"path":"https://s3.amazonaws.com/amzn-s3-demo-bucket/scripts/ruby/mySSMdoc.json"}
-
Wenn Sie möchten SSMDocument, geben Sie die Quellinformationen im folgenden Format an:
{"name": "document_name"}
Beispielsweise:
{"name": "mySSMdoc"}
-
-
Geben Sie im Feld Dokumentparameter Parameter für das SSM Remote-Dokument ein. Wenn Sie beispielsweise das Dokument
AWS-RunPowerShell
ausführen, könnten Sie Folgendes angeben:{"commands": ["date", "echo \"Hello World\""]}
Wenn Sie das Dokument
AWS-ConfigureAWSPack
ausführen, könnten Sie Folgendes angeben:{ "action":"Install", "name":"AWSPVDriver" }
Identifizieren Sie für den Abschnitt Targets (Ziele) die verwalteten Knoten, auf denen Sie diese Operation ausführen möchten, indem Sie Tags angeben, Instances oder Edge-Geräte manuell auswählen oder eine Ressourcengruppe angeben.
Tipp
Wenn ein verwalteter Knoten, den Sie erwarten, nicht aufgeführt ist, finden Sie weitere Informationen unter Problembehandlung bei der Verfügbarkeit verwalteter Knoten Tipps zur Fehlerbehebung.
Für Other parameters (Weitere Parameter):
-
Geben Sie im Feld Comment (Kommentar) Informationen zu diesem Befehl ein.
-
Geben Sie für Timeout (seconds) (Timeout (Sekunden)) in Sekunden an, wie lange gewartet werden soll, bis für die gesamte Befehlsausführung ein Fehler auftritt.
-
Für Rate control (Ratenregelung):
-
Geben Sie unter Concurrency (Nebenläufigkeit) entweder eine Zahl oder einen Prozentsatz der verwalteten Knoten an, auf denen der Befehl gleichzeitig ausgeführt werden soll.
Anmerkung
Wenn Sie Ziele ausgewählt haben, indem Sie Tags angeben, die auf verwaltete Knoten angewendet werden, oder indem Sie AWS -Ressourcengruppen angeben, und Sie noch nicht sicher sind, wie viele verwaltete Knoten anvisiert sind, sollten Sie die Anzahl von Zielen, die das Dokument gleichzeitig ausführen kann, beschränken, indem Sie einen Prozentsatz angeben.
-
Geben Sie unter Error threshold (Fehlerschwellenwert) an, wann die Ausführung des Befehls auf anderen verwalteten Knoten beendet werden soll, nachdem dafür entweder auf einer bestimmten Anzahl oder einem Prozentsatz von Knoten ein Fehler aufgetreten ist. Falls Sie beispielsweise drei Fehler angeben, sendet Systems Manager keinen Befehl mehr, wenn der vierte Fehler empfangen wird. Von verwalteten Knoten, auf denen der Befehl noch verarbeitet wird, werden unter Umständen ebenfalls Fehler gesendet.
-
(Optional) Wenn Sie im Abschnitt Output options (Ausgabeoptionen) die Befehlsausgabe in einer Datei speichern möchten, aktivieren Sie das Kontrollkästchen Enable writing to a S3 bucket (Schreiben in einen S3-Bucket aktivieren). Geben Sie die Namen für den Bucket und das Präfix (Ordner) in die Textfelder ein.
Anmerkung
Die S3-Berechtigungen, die das Schreiben der Daten in einen S3-Bucket ermöglichen, sind diejenigen des Instanzprofils (für EC2 Instances) oder der IAM Servicerolle (hybridaktivierte Maschinen), die der Instanz zugewiesen wurden, nicht die des IAM Benutzers, der diese Aufgabe ausführt. Weitere Informationen finden Sie unter Konfigurieren der für Systems Manager erforderlichen Instanzberechtigungen oder Erstellen einer IAM Servicerolle für eine Hybridumgebung. Wenn sich der angegebene S3-Bucket in einem anderen befindet, stellen Sie außerdem sicher AWS-Konto, dass das dem verwalteten Knoten zugeordnete Instanzprofil oder die IAM Servicerolle über die erforderlichen Berechtigungen verfügt, um in diesen Bucket zu schreiben.
Wenn Sie möchten, dass SNSBenachrichtigungen über den Status der Befehlsausführung gesendet werden, aktivieren Sie im Abschnitt Benachrichtigungen das Kontrollkästchen SNSBenachrichtigungen aktivieren.
Weitere Informationen zur Konfiguration von SNS Amazon-Benachrichtigungen für Run Command finden Sie unterÜberwachung von Systems Manager-Statusänderungen mit Amazon SNS-Benachrichtigungen.
-
Wählen Sie Ausführen aus.
Anmerkung
Informationen zum Neustarten von Servern und Instances bei Verwendung von Run Command für den Aufruf von Skripts finden Sie unter Umgang mit Neustarts beim Ausführen von Befehlen.