Verwenden Sie Systems Manager SSM-Dokumente mit AWS FIS

Voraussetzungen

Bei Aktionen, bei denen der SSM Agent die Aktion auf dem Ziel ausführen muss, müssen Sie Folgendes sicherstellen:

• Der Agent ist auf dem Ziel installiert. SSM Agent ist standardmäßig auf einigen Amazon Machine Images (AMIs) installiert. Andernfalls können Sie den SSM Agent auf Ihren Instances installieren. Weitere Informationen finden Sie im Benutzerhandbuch unter Manuelles Installieren des SSM Agents für EC2-Instances. AWS Systems Manager

• Systems Manager ist berechtigt, Aktionen auf Ihren Instances auszuführen. Sie gewähren Zugriff mithilfe eines IAM-Instanzprofils. Weitere Informationen finden Sie im Benutzerhandbuch unter Erstellen eines IAM-Instanzprofils für Systems Manager und Anhängen eines IAM-Instanzprofils an eine EC2-Instance. AWS Systems Manager

• documentArn – Erforderlich. Der Amazon-Ressourcenname (ARN) des SSM-Dokuments.

• documentParameters— Befristet. Die erforderlichen und optionalen Parameter, die das SSM-Dokument akzeptiert. Das Format ist ein JSON-Objekt mit Schlüsseln, bei denen es sich um Zeichenketten handelt, und Werten, die entweder Zeichenketten oder Zeichenkettenarrays sind.

• documentVersion – Optional. Die Version des SSM-Dokuments, das ausgeführt werden soll.

Voraussetzungen

• Die von AWS FIS bereitgestellten vorkonfigurierten SSM-Dokumente werden nur auf den folgenden Betriebssystemen unterstützt:

  • Amazon Linux 2023

  • Ubuntu

  • REGEL 8, 9

  • CentOS 9

• Die von AWS FIS bereitgestellten vorkonfigurierten SSM-Dokumente werden nur auf EC2-Instances unterstützt. Sie werden auf anderen Arten von verwalteten Knoten, wie z. B. lokalen Servern, nicht unterstützt.

• Action duration: Bei Experimenten mit einer einzigen Wirkung entspricht die Wirkdauer der Versuchsdauer. Bei mehreren Aktionen hängt die Versuchsdauer von der Dauer der einzelnen Aktionen und der Reihenfolge ab, in der sie ausgeführt werden. AWS FIS überwacht jede Aktion, bis ihre Aktionsdauer abgelaufen ist.

• DokumentparameterDurationSeconds: Die in Sekunden angegebene Dauer, für die das SSM-Dokument ausgeführt wird.

• Action duration exceeds DurationSeconds: Die Ausführung des SSM-Dokuments wird abgeschlossen, bevor die Aktion abgeschlossen ist. AWS FIS wartet, bis die Aktionsdauer abgelaufen ist, bevor nachfolgende Aktionen gestartet werden.

• Action duration is shorter than DurationSeconds: Das SSM-Dokument setzt die Ausführung fort, nachdem die Aktion abgeschlossen ist. Wenn die Ausführung des SSM-Dokuments noch im Gange ist und die Aktionsdauer abgelaufen ist, wird der Aktionsstatus auf Abgeschlossen gesetzt. AWS FIS überwacht die Ausführung nur, bis die Aktionsdauer abgelaufen ist.

Parameter des Dokuments

• DurationSeconds – Erforderlich. Die Dauer des CPU-Stresstests in Sekunden.

• CPU – Optional. Die Anzahl der zu verwendenden CPU-Stressoren. Die Standardeinstellung ist 0, wodurch alle CPU-Stressoren verwendet werden.

• LoadPercent – Optional. Der Prozentsatz der CPU-Ziellast, von 0 (keine Last) bis 100 (Volllast). Der Standardwert ist 100.

• InstallDependencies – Optional. Wenn der Wert gleich istTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeit iststress-ng.

Parameter des Dokuments

• DurationSeconds – Erforderlich. Die Dauer des Festplattenfülltests in Sekunden.

• Percent – Optional. Der Prozentsatz der Festplatte, der während des Festplattenfülltests zugewiesen werden soll. Die Standardeinstellung ist 95%.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeiten sindatd, kmod undfallocate.

Parameter des Dokuments

• DurationSeconds – Erforderlich. Die Dauer des IO-Stresstests in Sekunden.

• Workers – Optional. Die Anzahl der Worker, die eine Mischung aus sequentiellen, zufälligen und speicherzugewiesenen read/write Vorgängen, erzwungener Synchronisation und Cache-Löschen ausführen. Mehrere untergeordnete Prozesse führen unterschiedliche I/O Operationen an derselben Datei aus. Der Standardwert ist 1.

• Percent – Optional. Der Prozentsatz des freien Speicherplatzes im Dateisystem, der während des I/O-Stresstests verwendet werden soll. Die Standardeinstellung ist 80%.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeit iststress-ng.

Parameter des Dokuments

• ProcessName – Erforderlich. Der Name des Prozesses, der gestoppt werden soll.

• Signal – Optional. Das Signal, das zusammen mit dem Befehl gesendet werden soll. Die möglichen Werte sind SIGTERM (die der Empfänger ignorieren kann) und SIGKILL (die nicht ignoriert werden können). Der Standardwert ist SIGTERM.

• InstallDependencies – Optional. Wenn der Wert 0 istTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeit istkillall.

Parameter des Dokuments

• DurationSeconds – Erforderlich. Die Dauer des Gedächtnis-Stresstests in Sekunden.

• Workers – Optional. Die Anzahl der virtuellen Speicherbelastungen. Der Standardwert ist 1.

• Percent – Erforderlich. Der Prozentsatz des virtuellen Speichers, der während des Speicherstresstests verwendet werden soll.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeit iststress-ng.

Parameter des Dokuments

• Protocol – Erforderlich. Das Protokoll. Die möglichen Werte sind tcp und udp.

• Port – Erforderlich. Die Port-Nummer.

• TrafficType – Optional. Der Typ des Datenverkehrs. Die möglichen Werte sind ingress und egress. Der Standardwert ist ingress.

• DurationSeconds – Erforderlich. Die Dauer des Netzwerk-Blackhole-Tests in Sekunden.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeiten sindatd, diglsof, undiptables.

Parameter des Dokuments

• Interface – Optional. Die Netzwerkschnittstelle. Der Standardwert ist eth0.

• DelayMilliseconds – Optional. Die Verzögerung in Millisekunden. Die Standardeinstellung ist 200.

• DurationSeconds – Erforderlich. Die Dauer des Netzwerklatenztests in Sekunden.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeiten sind atddig, undtc.

Parameter des Dokuments

• Interface – Optional. Die Netzwerkschnittstellen, durch Kommas getrennt. ALL- und DEFAULT-Werte werden unterstützt. Die Standardeinstellung istDEFAULT, die auf die primäre Netzwerkschnittstelle für das Betriebssystem abzielt.

• DelayMilliseconds – Optional. Die Verzögerung in Millisekunden. Die Standardeinstellung ist 200.

• JitterMilliseconds – Optional. Der Jitter in Millisekunden. Der Standardwert ist 10.

• FlowsPercent – Optional. Der Prozentsatz der Netzwerkflüsse, die von der Aktion betroffen sein werden. Der Standardwert für ist 100 %.

• Sources – Erforderlich. Die Quellen, durch Kommas getrennt, ohne Leerzeichen. Die möglichen Werte sind: eine IPv4-Adresse, ein IPv4-CIDR-Block, ein Domänenname, ein AZ-Name (us-east-1a), eine AZ-ID (use1-az1), ALL und. DYNAMODB S3 Wenn Sie DYNAMODB oder angebenS3, gilt dies nur für den regionalen Endpunkt in der aktuellen Region. Der IPv6-Verkehr wird durch dieses Dokument nicht beeinträchtigt.

• TrafficType – Optional. Der Typ des Datenverkehrs. Die möglichen Werte sind ingress und egress. Der Standardwert ist ingress.

• DurationSeconds – Erforderlich. Die Dauer des Netzwerklatenztests in Sekunden.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen, sofern sie nicht bereits installiert sind. Der Standardwert ist True. Die Abhängigkeiten sind atddig, jqlsof, undtc.

• ec2:DescribeInstances

• ec2:DescribeSubnets

Parameter des Dokuments

• Interface – Optional. Die Netzwerkschnittstelle. Der Standardwert ist eth0.

• LossPercent – Optional. Der Prozentsatz des Paketverlusts. Die Standardeinstellung ist 7%.

• DurationSeconds – Erforderlich. Die Dauer des Tests zum Verlust von Netzwerkpaketen in Sekunden.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen. Der Standardwert ist True. Die Abhängigkeiten sindatd, lsofdig, undtc.

Parameter des Dokuments

• Interface – Optional. Die Netzwerkschnittstellen, durch Kommas getrennt. ALL- und DEFAULT-Werte werden unterstützt. Die Standardeinstellung istDEFAULT, die auf die primäre Netzwerkschnittstelle für das Betriebssystem abzielt.

• LossPercent – Optional. Der Prozentsatz des Paketverlusts. Die Standardeinstellung ist 7%.

• FlowsPercent – Optional. Der Prozentsatz der Netzwerkflüsse, die von der Aktion betroffen sein werden. Der Standardwert für ist 100 %.

• Sources – Erforderlich. Die Quellen, durch Kommas getrennt, ohne Leerzeichen. Die möglichen Werte sind: eine IPv4-Adresse, ein IPv4-CIDR-Block, ein Domänenname, ein AZ-Name (us-east-1a), eine AZ-ID (use1-az1), ALL und. DYNAMODB S3 Wenn Sie DYNAMODB oder angebenS3, gilt dies nur für den regionalen Endpunkt in der aktuellen Region. Der IPv6-Verkehr wird durch dieses Dokument nicht beeinträchtigt.

• TrafficType – Optional. Der Typ des Datenverkehrs. Die möglichen Werte sind ingress und egress. Der Standardwert ist ingress.

• DurationSeconds – Erforderlich. Die Dauer des Tests zum Verlust von Netzwerkpaketen in Sekunden.

• InstallDependencies – Optional. Wenn der Wert lautetTrue, installiert Systems Manager die erforderlichen Abhängigkeiten auf den Zielinstanzen. Der Standardwert ist True. Die Abhängigkeiten sind atddig, jqlsof, undtc.

• ec2:DescribeInstances

• ec2:DescribeSubnets

• Die folgenden Dokumente können nicht parallel ausgeführt werden:

  • AWSFIS-Run-Network-Blackhole-Port

  • AWSFIS-Run-Network-Latency

  • AWSFIS-Run-Network-Latency-Sources

  • AWSFIS-Run-Network-Packet-Loss

  • AWSFIS-Run-Network-Packet-Loss-Sources

Einzelheiten zur Erstellung

• Speicherort — Skripte werden im /var/lib/amazon/ssm/ Verzeichnis erstellt.

• Benennungsmuster — FAULT_NAME-FAULT_IDENTIFIER-Rollback.sh wo FAULT_IDENTIFIER ist eine zufällig generierte 32-stellige Zeichenfolge

• Timing — Wird zu Beginn jedes Fault-Injection-Experiments erstellt, bevor die Fehlerinjektion beginnt.

• Inhalt — Enthält alle notwendigen Umgebungsvariablen und Befehle, um den spezifischen Fehler rückgängig zu machen.

• Temporäre Dateien — /tmp/aws-fis-rollback-TIMESTAMP-PID.log

• Systemprotokolle — Mit Funktion an Syslog gesendet local0.info

• Schlagwort — aws-fis-rollback

• Priorität — local0.info

• Format — [YYYY-MM-DDTHH:MM:SSZ] log_message