Informationen zu Zielen und Ratensteuerungen in State Manager Zuordnungen

In diesem Thema werden Features von State Manager, eine Funktion von AWS Systems Manager, beschrieben, mit denen Sie eine Assoziation für Dutzende oder Hunderte von Knoten bereitstellen und gleichzeitig steuern können, wie viele Knoten die Assoziation zum geplanten Zeitpunkt ausführen.

Targets (Ziele)

Wenn Sie eine State Manager-Assoziation erstellen, wählen Sie im Abschnitt Targets (Ziele) der Systems Manager-Konsole, welche Knoten mit der Assoziation konfiguriert werden sollen, wie hier gezeigt.

Wenn Sie mithilfe eines Befehlszeilen-Tools wie AWS Command Line Interface (AWS CLI) eine Zuordnung erstellen, geben Sie den Parameter targets an. Wenn Sie Knoten als Ziel auswählen, können Sie Dutzende, Hunderte oder Tausende von Knoten mit einer Assoziation konfigurieren, ohne einzelne Knoten-IDs angeben oder auswählen zu müssen.

Jeder verwaltete Knoten kann von maximal 20 Zuordnungen betroffen sein.

State Manager enthält die folgenden Zieloptionen bei der Erstellung einer Zuordnung.

Tags angeben

Verwenden Sie diese Option, um einen Tag-Schlüssel und (optional) einen Tag-Wert anzugeben, die Ihren Knoten zugewiesen sind. Wenn Sie die Anforderung ausführen, versucht das System, die Assoziation auf allen Knoten zu erstellen, die dem angegebenen Tag-Schlüssel und -Wert entsprechen. Wenn Sie mehrere Tag-Werte angegeben haben, zielt die Assoziation auf jeden Knoten mit mindestens einem dieser Tag-Werte ab. Wenn das System die Zuordnung erstmals erstellt, führt es die Zuordnung aus. Nach dieser erstmaligen Ausführung führt das System die Zuordnung dem angegebenen Zeitplan entsprechend aus.

Wenn Sie neue Knoten erstellen und diesen Konten den angegebenen Tag-Schlüssel und -Wert zuweisen, wendet das System die Assoziation automatisch an und führt sie sofort und anschließend dem angegebenen Zeitplan entsprechend aus. Dies gilt, wenn die Zuordnung ein Befehls- oder Richtliniendokument verwendet und nicht angewendet wird, wenn die Zuordnung ein Automation-Runbook verwendet. Wenn Sie die angegebenen Tags aus einem Knoten löschen, führt das System die Assoziation für diese Knoten nicht mehr aus.

Anmerkung

Wenn Sie Automation-Runbooks mit State Manager und die Tagging-Einschränkung verhindert, dass Sie ein bestimmtes Ziel erreichen, sollten Sie die Verwendung von Automation-Runbooks mit Amazon EventBridge in Betracht ziehen. Weitere Informationen finden Sie unter Ausführen von Automatisierungen basierend auf Ereignissen. Weitere Informationen zur Verwendung von State Manager mithilfe von Runbooks finden Sie unter Planen von Automatisierungen mit State Manager-Zuordnungen.

Als bewährte Methode empfehlen wir die Verwendung von Tags, wenn Sie Zuordnungen erstellen, die ein Befehls- oder Richtlinien-Dokument verwenden. Wir empfehlen auch die Verwendung von Tags, wenn Sie Zuordnungen zu Auto-Scaling-Gruppen erstellen. Weitere Informationen finden Sie unter Ausführen von Auto-Scaling-Gruppen mit Zuordnungen.

Anmerkung

Notieren Sie die folgenden Informationen:

• Wenn Sie eine Zuordnung in der Konsole erstellen und Knoten mit Hilfe von Tags anvisieren, können Sie nur einen Tag-Schlüssel angeben. Wenn Sie die Konsole verwenden und Ihre Knoten mit mehr als einem Tag-Schlüssel anvisieren möchten, weisen Sie die Tag-Schlüssel einer AWS Resource Groups-Gruppe zu und fügen Sie die Knoten zu dieser Gruppe hinzu. Sie können dann die Option Ressourcengruppe in der Zielliste auswählen, wenn Sie die State Manager-Zuordnung erstellen.

• Sie können mit der AWS CLI maximal fünf Tag-Schlüssel angeben. Wenn Sie die AWS CLI verwenden, müssen alle im create-association-Befehl angegebenen Tag-Schlüssel dem Knoten aktuell zugewiesen sein. Sind sie das nicht, kann State Manager den Knoten nicht für eine Zuordnung anvisieren. Weitere Informationen zum Zuweisen von Tags zu Knoten finden Sie unter Markieren von Systems Manager-Ressourcen.

Manuelles Auswählen von Knoten

Verwenden Sie diese Option, um die Knoten, auf denen Sie die Assoziation erstellen möchten, manuell auszuwählen. Im Bereich Instances werden alle von Systems Manager verwalteten Knoten im aktuellen AWS-Konto und in der aktuellen AWS-Region angezeigt. Sie können beliebig viele Knoten manuell auswählen. Wenn das System die Zuordnung erstmals erstellt, führt es die Zuordnung aus. Nach dieser erstmaligen Ausführung führt das System die Zuordnung dem angegebenen Zeitplan entsprechend aus.

Anmerkung

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.

Eine Ressourcengruppe auswählen

Verwenden Sie diese Option, um eine Assoziation für alle Knoten zu erstellen, die von einer Tag-basierten AWS Resource Groups-Abfrage oder einer Stack-basierten AWS CloudFormation-Abfrage zurückgegeben werden.

Unten folgen Details zum Auswählen von Ressourcengruppen als Ziel für eine Zuordnung.

• Wenn Sie einer Gruppe neue Knoten hinzufügen, ordnet das System die Knoten automatisch der Assoziation zu, die die Ressourcengruppe zum Ziel hat. Wenn das System die Änderung erkennt, wendet es die Assoziation auf die Knoten an. Nach dieser erstmaligen Ausführung führt das System die Zuordnung dem angegebenen Zeitplan entsprechend aus.

• Wenn Sie eine Zuordnung erstellen, die auf eine Ressourcengruppe abzielt und der AWS::SSM::ManagedInstance-Ressourcentyp für diese Gruppe angegeben wurde, läuft die Zuordnung in einer Hybrid- und Multi-Cloud-Umgebung standardmäßig sowohl auf Instances der Amazon Elastic Compute Cloud (Amazon EC2) als auch auf Nicht-EC2-Knoten.

• Wenn Sie eine Zuordnung erstellen, die auf eine Ressourcengruppe abzielt, dürfen der Ressourcengruppe nicht mehr als fünf Tag-Schlüssel zugewiesen oder mehr als fünf Werte für einen Tag-Schlüssel angegeben werden. Wenn eine dieser Bedingungen auf die Tags und Schlüssel zutrifft, die Ihrer Ressourcengruppe zugewiesen sind, kann die Zuordnung nicht ausgeführt werden und gibt einen InvalidTarget-Fehler zurück.

• Wenn Sie eine Ressourcengruppe löschen, führen alle Instances in dieser Gruppe die Zuordnung nicht mehr aus. Es ist ratsam, Zuordnungen zu löschen, die die Gruppe zum Ziel haben.

• Sie können für eine Zuordnung maximal eine einzelne Ressourcengruppe als Ziel auswählen. Mehrere oder verschachtelte Gruppen werden nicht unterstützt.

• Nachdem Sie eine Zuordnung erstellt haben, aktualisiert State Manager die Zuordnung in regelmäßigen Abständen mit Informationen zu Ressourcen in der Ressourcengruppe. Wenn Sie einer Ressourcengruppe neue Ressourcen hinzufügen, hängt es von verschiedenen Faktoren ab, wann das System die Zuordnung auf die neuen Ressourcen anwendet. Sie können den Status der Zuordnung auf der Seite State Manager der Systems Manager-Konsole bestimmen.

Warnung

Ein AWS Identity and Access Management (IAM)-Benutzer, eine -Gruppe oder eine -Rolle mit der Berechtigung zum Erstellen einer Zuordnung, die eine Ressourcengruppe von Amazon-EC2-Instances zum Ziel hat, hat automatisch die Kontrolle auf Stammebene für alle Instances in der Gruppe. Sie sollten nur vertrauenswürdigen Administratoren die Berechtigung erteilen, Zuordnungen zu erstellen.

Weitere Informationen zu Resource Groups finden Sie unter Was ist AWS Resource Groups? im AWS Resource Groups-Benutzerhandbuch.

Wählen Sie alle Knoten

Verwenden Sie diese Option, um alle Knoten im aktuellen AWS-Konto und in der aktuellen AWS-Region als Ziel auszuwählen. Wenn Sie die Anforderung ausführen, versucht das System, die Assoziation auf allen Knoten im aktuellen AWS-Konto und in der aktuellen AWS-Region zu erstellen. Wenn das System die Zuordnung erstmals erstellt, führt es die Zuordnung aus. Nach dieser erstmaligen Ausführung führt das System die Zuordnung dem angegebenen Zeitplan entsprechend aus. Wenn Sie neue Instances erstellen, wendet das System die Assoziation automatisch an und führt sie sofort und anschließend dem angegebenen Zeitplan entsprechend aus.

Ratensteuerungen

Sie können die Ausführung einer Assoziation für Ihre Knoten steuern, indem Sie einen Gleichzeitigkeitswert und einen Fehlerschwellenwert angeben. Der Gleichzeitigkeitswert gibt an, wie viele Knoten die Assoziation gleichzeitig ausführen können. Der Fehlerschwellenwert gibt an, wie viele Assoziationsausführungen fehlschlagen dürfen, bevor Systems Manager einen Befehl an alle mit dieser Assoziation konfigurierten Knoten sendet, um die Ausführung der Assoziation zu beenden. Der Befehl verhindert, dass die Zuordnung vor der nächsten geplanten Zuordnung ausgeführt wird. Die Gleichzeitigkeits- und die Fehlergrenzwertfeature werden gemeinsam als Ratensteuerungen bezeichnet.

Nebenläufigkeit

Durch Angabe eines Gleichzeitigkeitswerts können die Auswirkungen der Ausführung auf Ihre Knoten begrenzt werden, indem Sie angeben, dass jeweils nur eine bestimmte Anzahl von Knoten eine Assoziation gleichzeitig verarbeiten kann. Sie können entweder eine absolute Anzahl an verwalteten Knoten, z. B. 20, oder einen Prozentsatz des Ziel-Knotensatzes, beispielsweise 10 %, angeben.

Bitte beachten Sie die folgenden Einschränkungen und Begrenzungen für die Gleichzeitigkeitsfunktion bei State Manager:

• Wenn Sie eine Assoziation erstellen, indem Sie Ziele angeben, aber keinen Gleichzeitigkeitswert festlegen, dann gibt State Manager automatisch eine maximale Gleichzeitigkeit von 50 Knoten vor.

• Wenn eine Assoziation ausgeführt wird, die die Gleichzeitigkeitsfunktion verwendet, und ein neuer Knoten online geht, der den Zielkriterien entspricht, führen diese neuen Knoten die Assoziation aus, wenn damit der Gleichzeitigkeitswert nicht überschritten wird. Wenn der Gleichzeitigkeitswert überschritten wird, wird der Knoten für das aktuelle Assoziationsausführungsintervall ignoriert. Die Knoten werden dann zum nächsten geplanten Intervall bei normaler Beachtung der Gleichzeitigkeitsbeschränkung ausgeführt.

• Wenn Sie eine Assoziation aktualisieren, die die Gleichzeitigkeitsfunktion verwendet, und diese Assoziation wird gerade auf einer oder mehreren Knoten ausgeführt, dann erhalten diese Knoten die Erlaubnis, die Ausführung der Assoziation abzuschließen. Zuordnungen, deren Ausführung noch nicht begonnen hat, werden nicht mehr ausgeführt. Nachdem die Ausführung laufender Assoziationen abgeschlossen wurde, führen alle Ziel-Knoten die Assoziation sofort erneut aus, da sie aktualisiert wurde. Auch bei dieser erneuten Ausführung gilt der festgelegte Gleichzeitigkeitswert.

Fehlerschwellenwerte

Ein Fehlergrenzwert gibt an, wie viele Assoziationsausführungen auftreten dürfen, bevor Systems Manager einen Befehl zu jedem mit dieser Assoziation konfigurierten Knoten sendet. Der Befehl verhindert, dass die Zuordnung vor der nächsten geplanten Zuordnung ausgeführt wird. 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. die absolute Zahl von drei Fehlern angeben, sendet State Manager einen Befehl zum Anhalten, wenn der vierte Fehler zurückgegeben wird. Wenn Sie 0 angeben, sendet State Manager den Befehl zum Anhalten, wenn der erste Fehler gemeldet wird.

Wenn Sie einen Fehlerschwellenwert von 10 % für 50 Zuordnungen angeben, sendet State Manager den Befehl zum Anhalten, wenn der sechste Fehler zurückgegeben wird. Zuordnungen, die bereits ausgeführt werden, wenn ein Fehlerschwellenwert erreicht wird, werden noch abgeschlossen, es besteht jedoch die Möglichkeit, dass einige dieser Zuordnungen fehlschlagen. Um sicherzustellen, dass nicht mehr Fehler als im Fehlerschwellenwert angegeben auftreten, setzen Sie den Wert für die Concurrency (Gleichzeitigkeit) auf 1, sodass die Zuordnungen jeweils einzeln ausgeführt werden.

Es gelten die folgenden Einschränkungen und Begrenzungen für Fehlerschwellenwert in State Manager:

• Fehlerschwellenwerte werden für das aktuelle Intervall übernommen.

• Informationen zu den einzelnen Fehlern werden mit detaillierten Informationen zu den Arbeitsschritten im Zuordnungsverlauf aufgezeichnet.

• Wenn Sie eine Zuordnung unter Verwendung von Zielen erstellen, aber keinen Fehlerschwellenwert angeben, dann gibt State Manager automatisch einen Schwellenwert von 100 % Fehlern vor.