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 Befehlen in großem Maßstab
Sie können Run Command, ein Tool in AWS Systems Manager, verwenden, um Befehle auf einer Flotte verwalteter Knoten auszuführen, indem Sie die targets verwenden. Der targets-Parameter nimmt eine Key,Value-Kombination basierend auf Tags an, die Sie für Ihre verwalteten Knoten angegeben haben. Wenn Sie den Befehl ausführen, versucht das System, den Befehl auf allen verwalteten Knoten auszuführen, die den angegebenen Tags entsprechen. Weitere Informationen zum Markieren von verwalteten Instances finden Sie unter Markieren Ihrer AWS-Ressourcen im Benutzerhandbuch zum Markieren von AWS-Ressourcen. Weitere Informationen über das Markieren Ihrer verwalteten IoT-Geräte finden Sie unter Markieren Sie Ihre AWS IoT Greengrass Version 2-Ressourcen im AWS IoT Greengrass Version 2-Entwicklerhandbuch.
Sie können auch den targets-Parameter verwenden, um eine Liste spezifischer IDs von verwalteten Knoten als Ziel zu wählen, wie im nächsten Abschnitt beschrieben.
Zur Steuerung der Befehlsausführung auf Hunderten und Tausenden von verwalteten Knoten umfasst Run Command auch Parameter für die Einschränkung, wie viele Knoten gleichzeitig eine Anforderung verarbeitet können, und wie viele Fehler durch einen Befehl ausgelöst werden können, bevor der Befehl beendet wird.
Mehrere verwaltete Knoten anvisieren
Sie können einen Befehl ausführen und verwaltete Knoten anvisieren, indem Sie Tags, Namen von AWS-Ressourcengruppen oder IDs von verwalteten Knoten angeben.
Die folgenden Beispiele zeigen das Befehlsformat bei Verwendung von Run Command aus der AWS Command Line Interface (AWS CLI). Ersetzen Sie jeden Beispiel Platzhalter für Ressourcen mit Ihren eigenen Informationen. Die Beispielbefehle werden in diesem Abschnitt sind mit [...] abgeschnitten.
Beispiel 1: Angabe von Tags als Ziel
Beispiel 2: Angabe einer AWS-Ressourcengruppe nach Namen
Sie können maximal einen Ressourcengruppenamen pro Befehlsaufruf angeben. Wenn Sie eine Ressourcengruppe erstellen, empfehlen wir, AWS::SSM:ManagedInstance und AWS::EC2::Instance als Ressourcentypen in dem Gruppierungskriterium aufzunehmen.
Anmerkung
Zum Senden von Befehlen mit einer Ressourcengruppe als Ziel benötigen Sie AWS Identity and Access Management (IAM)-Berechtigungen zum Auflisten oder Anzeigen der Ressourcen, die zu der Gruppe gehören. Weitere Informationen finden Sie unter Einrichten von Berechtigungen im AWS Resource Groups-Benutzerhandbuch.
Beispiel 3: Angabe einer AWS-Ressource Groups nach Ressourcentyp
Sie können maximal fünf Ressourcengruppentypen pro Befehlsaufruf angeben. Wenn Sie eine Ressourcengruppe erstellen, empfehlen wir, AWS::SSM:ManagedInstance und AWS::EC2::Instance als Ressourcentypen in dem Gruppierungskriterium aufzunehmen.
Anmerkung
Zum Senden von Befehlen mit einer Ressourcengruppe als Ziel benötigen Sie IAM-Berechtigungen zum Auflisten oder Anzeigen der Ressourcen, die zu der Gruppe gehören. Weitere Informationen finden Sie unter Einrichten von Berechtigungen im AWS Resource Groups-Benutzerhandbuch.
Beispiel 4: Angabe von Instance-IDs als Ziel
Die folgenden Beispiele veranschaulichen, wie verwaltete Knoten mithilfe des instanceids-Schlüssels mit dem targets-Parameter anvisiert werden können. Sie können diesen Schlüssel verwenden, um verwaltete AWS IoT Greengrass-Core-Geräte anzuvisieren, da jedem Gerät ein mi-ID_Nummer zugewiesen ist. Sie können Geräte-IDs in Fleet Manager, einem Tool in AWS Systems Manager, anzeigen.
Wenn Sie verwaltete Knoten für unterschiedliche Umgebungen mit einem Key namens Environment und Values von Development, Test, Pre-production undProduction markiert haben, könnten Sie einen Befehl an alle verwalteten Knoten in einer dieser Umgebungen mit dem targets-Parameter mit der folgenden Syntax senden.
Sie könnten weitere verwaltete Knoten in anderen Umgebungen auswählen, indem Sie sie zur Values-Liste hinzufügen. Trennen Sie die Elemente durch Kommas.
Variation: Anpassung Ihrer Ziele mit mehreren Key-Kriterien
Sie können die Anzahl der Ziele für Ihren Befehl verfeinern, indem Sie mehrere Key Kriterien berücksichtigen. Wenn Sie mehr als ein Key-Kriterium einschließen, wird das System verwaltete Knoten anvisieren, die alle Kriterien erfüllen. Mit dem folgenden Befehl werden alle verwaltete Knoten anvisiert, die für die Finanzabteilung und für die Datenbankserver-Rolle markiert sind.
Variation: Verwenden mehrerer Key- und Value-Kriterien
Aufbauend auf dem vorherigen Beispiel können Sie mehrere Abteilungen und mehrere Server-Rollen auswählen, indem zusätzliche Elemente in die Values Kriterien einfügen.
Variation: Anvisieren markierter verwalteter Knoten mithilfe von mehreren Values-Kriterien
Wenn Sie verwaltete Knoten für unterschiedliche Umgebungen mit einem Key namens Department und Values von Sales und Finance markiert haben, könnten Sie einen Befehl an alle Knoten in diesen Umgebungen mit dem targets-Parameter mit der folgenden Syntax senden.
Sie können maximal fünf Schlüssel und fünf Werte für jeden Schlüssel angeben.
Wenn entweder ein Tag-Schlüssel (der Variablenname) oder eine Tag-Wert Leerzeichen enthält, setzen Sie den Tagschlüssel oder den Wert in Anführungszeichen, wie in den folgenden Beispielen gezeigt.
Beispiel: Leerzeichen in Value-Tag
Beispiel: Leerzeichen in tag-Schlüssel und Value
Beispiel: Leerzeichen in einem Element in einer Liste von Values
Verwenden von Ratensteuerungen
Sie können das Tempo steuern, mit dem Befehle an verwaltete Knoten in einer Gruppe gesendet werden, indem Sie Nebenläufigkeits-Kontrollen und Fehlerkontrollen verwenden.
Verwenden von Gleichzeitigkeitssteuerungen
Sie können die Anzahl der verwalteten Knoten steuern, die einen Befehl gleichzeitig ausführen, indem Sie den max-concurrency-Parameter verwenden (die Concurrency (Nebenläufigkeit)-Optionen auf der Seite Run a command (Befehl ausführen). Sie können entweder eine absolute Anzahl an verwalteten Knoten, z. B. 10, oder einen Prozentsatz des festgelegten Ziels, beispielsweise 10%, angeben. Das Warteschlangensystem liefert den Befehl an einen einzelnen Knoten und wartet, bis das System den ersten Aufruf bestätigt hat, bevor der Befehl an zwei weitere Knoten gesendet wird. Das System sendet exponentiell Befehle an mehrere Knoten, bis das System den Wert max-concurrency erreicht hat. Der Standardwert max-concurrency beträgt 50. Die folgenden Beispiele zeigen, wie Sie Werte für den Parameter max-concurrency angeben.
Verwenden von Fehlersteuerungen
Sie können auch die Ausführung eines Befehls auf Hunderten oder Tausenden von verwalteten Knoten steuern, indem Sie eine Fehlerbegrenzung mit den max-errors-Parametern einstellen (das Feld Error threshold (Fehlerschwelle) auf der Seite Run a command (Befehl ausführen)). Der Parameter gibt an, wie viele Fehler zulässig sind, bevor das System keinen Befehl mehr an zusätzliche verwaltete Knoten sendet. Sie können entweder eine absolute Anzahl an Fehlern, z. B. 10, oder einen Prozentsatz des festgelegten Ziels, beispielsweise 10%, festlegen. Wenn Sie z. B. 3 angeben, sendet das System keinen Befehl mehr, wenn der vierte Fehler empfangen wird. Wenn Sie 0 angeben, sendet das System keinen weiteren Befehl an zusätzliche verwaltete Knoten, nachdem das erste Fehlerergebnis zurückgegeben wird. Wenn Sie einen Befehl an 50 verwaltete Knoten senden und max-errors auf 10% einstellen, sendet das System keinen Befehl mehr an weitere Knoten, wenn der sechste Fehler empfangen wird.
Aufrufe, die bereits einen Befehl ausführen, wenn max-errors erreicht ist, dürfen abgeschlossen werden, jedoch können einige dieser Aufrufe ebenso fehlschlagen. Wenn Sie sicherstellen müssen, dass es nicht mehr als max-errors fehlgeschlagene Aufrufe geben wird, setzen Sie max-concurrency auf 1, sodass die Aufrufe jeweils um eins fortfahren. Die Standardwert für max-errors ist 0. Die folgenden Beispiele zeigen, wie Sie Werte für den Parameter max-errors angeben.
