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.
# Prüfpunkte zu einer Instance-Aktualisierung hinzufügen
Wenn Sie eine Instance-Aktualisierung verwenden, können Sie Instances phasenweise ersetzen, damit Sie bei laufendem Betrieb Überprüfungen für Ihre Instances durchführen können. Um eine schrittweise Ersetzung durchzuführen, fügen Sie Checkpoints hinzu. Dies sind Zeitpunkte, an denen die Instance-Aktualisierung pausiert wird. Die Verwendung von Prüfpunkten gibt Ihnen eine bessere Kontrolle darüber, wie Sie Ihre Auto-Scaling-Gruppe aktualisieren. Damit können Sie bestätigen, dass Ihre Anwendung zuverlässig und vorhersehbar funktioniert.
**Topics**
+ [Funktionsweise](#instance-refresh-checkpoints-how-it-works)
+ [Überlegungen](#instance-refresh-checkpoints-considerations)
+ [Checkpoints aktivieren](enable-checkpoints-console-cli.md)
## Funktionsweise
Wenn Sie eine Instance-Aktualisierung starten, geben Sie Checkpoints als Prozentsätze der Gesamtzahl der Instances in der Auto Scaling Scaling-Gruppe an. Diese Checkpoints geben den Mindestprozentsatz der Instances in der Auto Scaling Scaling-Gruppe an, die neue Instances sein müssen, bevor der Checkpoint als erreicht gilt. Wenn Ihre Checkpoints beispielsweise so sind`[20, 50, 100]`, ist der erste Checkpoint erreicht, wenn 20 Prozent der Instances neu sind, der zweite, wenn 50 Prozent neu sind, und der letzte Checkpoint, wenn alle Instances neu sind.
Amazon EC2 Auto Scaling passt Instance-Ersetzungen so an, dass sie die angegebenen Checkpoint-Prozentsätze einhalten und gleichzeitig den minimalen fehlerfreien Prozentsatz der Gruppe beibehalten. Um einen Checkpoint-Prozentsatz zu erreichen, ersetzt Amazon EC2 Auto Scaling manchmal weniger fest, aber nie mehr, als der minimale fehlerfreie Prozentsatz zulässt.
Stellen Sie sich die folgende Auto-Scaling-Gruppe mit 10 Instanzen vor. Die Prozentsätze der Kontrollpunkte sind `[20,50,100]`, der minimale fehlerfreie Prozentsatz ist 80 Prozent, und der maximale fehlerfreie Prozentsatz ist 100 Prozent. Um den minimalen fehlerfreien Prozentsatz aufrechtzuerhalten, können nur zwei Instances auf einmal ersetzt werden. Im folgenden Diagramm ist der Prozess zum Ersetzen aller Instances dargestellt, bevor ein Checkpoint erreicht wird.
![\[Dieses Diagramm zeigt, wie sich Checkpoints auf den Ablauf einer Instance-Aktualisierung auswirken.\]](http://docs.aws.amazon.com/de_de/autoscaling/ec2/userguide/images/checkpoints-instance-refresh.png)
Im obigen Beispiel gibt es für jede neue Instance, die gestartet wird, eine Instance-Aufwärmphase. Möglicherweise haben Sie auch einen Lebenszyklus-Hook, der eine Instance in einen Wartestatus versetzt und dann eine benutzerdefinierte Aktion ausführt, während sie gestartet oder beendet wird.
Amazon EC2 Auto Scaling gibt Ereignisse für jeden Checkpoint aus, mit Ausnahme des Checkpoints, der zu 100 Prozent abgeschlossen ist. Sie können eine EventBridge Regel hinzufügen, um die Ereignisse an ein Ziel wie Amazon SNS zu senden. So werden Sie benachrichtigt, wenn Sie die erforderlichen Überprüfungen durchführen können. Weitere Informationen finden Sie unter [Erstellen Sie EventBridge Regeln für Instance-Aktualisierungsereignisse](monitor-events-eventbridge-sns.md).
## Überlegungen
Behalten Sie bei der Verwendung von Prüfpunkten die folgenden Überlegungen im Auge:
+ Da Prüfpunkte auf Prozentsätzen basieren, ändert sich die Anzahl der zu ersetzenden Instances mit der Größe der Gruppe. Wenn eine Scale-Out-Aktivität stattfindet und die Größe der Gruppe zunimmt, kann ein laufender Vorgang erneut einen Checkpoint erreichen. In diesem Fall sendet Amazon EC2 Auto Scaling eine weitere Benachrichtigung und wiederholt die Wartezeit zwischen den Checkpoints, bevor Sie fortfahren.
+ Unter bestimmten Umständen ist es möglich, einen Checkpoint zu überspringen. Angenommen, Ihre Auto-Scaling-Gruppe hat zwei Instances und Ihre Prüfpunkt-Prozentsätze sind `[10,40,100]`. Nachdem die erste Instance ersetzt wurde, berechnet Amazon EC2 Auto Scaling, dass 50 Prozent der Gruppe ersetzt wurden. Da 50 Prozent höher ist als die ersten beiden Prüfpunkte, überspringt es den ersten Prüfpunkt (`10`) und sendet eine Benachrichtigung für den zweiten Prüfpunkt (`40`).
+ Wenn Sie den Vorgang abbrechen, werden alle weiteren Ersetzungen beendet. Wenn Sie den Vorgang abbrechen oder er vor dem Erreichen des letzten Checkpoints fehlschlägt, werden alle Instances, die bereits ersetzt wurden, nicht auf die vorherige Konfiguration zurückgesetzt.
+ Bei einer teilweisen Aktualisierung startet Amazon EC2 Auto Scaling beim erneuten Ausführen des Vorgangs nicht ab dem Zeitpunkt des letzten Checkpoints neu und stoppt nicht, wenn nur die älteren Instances ersetzt werden. Es wird jedoch zuerst ältere Instances ersetzen, bevor es neue Instances ersetzt.
+ Der Prozentsatz, der tatsächlich abgeschlossen ist, kann höher sein als der Prozentsatz für diesen Checkpoint, wenn der Prozentsatz des Checkpoints im Verhältnis zur Anzahl der Instanzen in der Gruppe zu niedrig ist. Nehmen wir zum Beispiel an, der Prozentsatz des Checkpoints liegt bei 20 Prozent und die Gruppe hat vier Instances. Wenn Amazon EC2 Auto Scaling eine der vier Instances ersetzt, ist der tatsächliche Prozentsatz, der ersetzt wurde (25 Prozent), höher als der Prozentsatz des Checkpoints (20 Prozent).
+ Nachdem ein Checkpoint erreicht wurde, wird der angezeigte Gesamtprozentsatz für abgeschlossen erst aktualisiert, nachdem die Instances den Warmlauf abgeschlossen haben. Ihre Checkpoint-Prozentsätze weisen beispielsweise eine Verzögerung von 15 Minuten und einen fehlerfreien Mindestprozentsatz von 80 Prozent auf. `[20,50]` Ihre Auto Scaling Scaling-Gruppe hat 10 Instances und nimmt die folgenden Ersetzungen vor:
+ 0:00: Zwei ältere Instances werden durch neue ersetzt.
+ 0:10: Zwei neue Instances schließen das Aufwärmen ab.
+ 0:25: Zwei ältere Instances werden durch neue ersetzt. (Damit der minimale fehlerfreie Prozentsatz beibehalten wird, werden nur zwei Instances ersetzt.)
+ 0:35: Zwei neue Instances schließen das Aufwärmen ab.
+ 0:35: Eine ältere Instance wird durch eine neue ersetzt.
+ 0:45: Eine neue Instance schließt das Aufwärmen ab.
Bei 0:35 hört der Vorgang auf, neue Instance zu starten. Der abgeschlossene Prozentsatz spiegelt die Anzahl der abgeschlossenen Ersetzungen noch nicht genau wider (50 Prozent), da die neue Instance nicht aufgewärmt ist. Nachdem die neue Instance ihre Aufwärmphase um 0:45 Uhr abgeschlossen hat, wird für den Prozentsatz „Abgeschlossen“ ein Wert von 50 Prozent angezeigt.
+ Wenn mehrere Checkpoints aktiviert sind, muss der Checkpoint für die Instance-Aktualisierung auf 100% gesetzt werden, um sicherzustellen, dass alle Instances vollständig ersetzt werden. Wenn Sie den letzten Checkpoint auf einen Prozentsatz von weniger als 100% (z. B. 50%) setzen, ersetzt die Instanzaktualisierung keine Instances mehr, sobald dieser Checkpoint-Prozentsatz erreicht ist, und es wird nicht automatisch zu 100% fortgesetzt.
# Aktivieren Sie Checkpoints mithilfe von oder AWS-Managementkonsole AWS CLI
Sie können das AWS-Managementkonsole oder verwenden, um Checkpoints AWS CLI zu aktivieren.
## Aktivieren von Prüfpunkten (Konsole)
Sie können Prüfpunkte aktivieren, bevor Sie eine Instance-Aktualisierung starten, um Instances mit einem inkrementellen oder schrittweisen Ansatz zu ersetzen. Dies bietet zusätzliche Zeit für die Überprüfung.
**So starten Sie eine Instance-Aktualisierung, die Checkpoints verwendet**
1. Öffnen Sie die Amazon EC2 EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)und wählen Sie im Navigationsbereich **Auto Scaling Groups** aus.
1. Aktivieren Sie das Kontrollkästchen neben Ihrer Auto-Scaling-Gruppe.
Unten auf der Seite **Auto-Scaling-Gruppen** wird ein geteilter Bereich geöffnet.
1. Wählen Sie auf der Registerkarte **Instance refresh** (Instance-Aktualisierung) unter **Active instance refresh** (Aktive Instance-Aktualisierung) die Option **Start instance refresh** (Instance-Aktualisierung starten) aus.
1. Auf der Seite **Start instance refresh** (Instance-Aktualisierung starten) geben Sie die Werte für **Minimum healthy percentage** (Minimaler gesunder Prozentsatz) und **Instance warmup** (Instance-Aufwärmphase) ein.
1. Aktivieren Sie das Kontrollkästchen **Enable checkpoints** (Prüfpunkte aktivieren).
Dadurch wird ein Feld angezeigt, in dem Sie den prozentualen Schwellenwert für den ersten Checkpoint definieren können.
1. Für **Proceed until \$1\$1\$1\$1 % of the group is refreshed** (Fortfahren, bis \$1\$1\$1\$1% der Gruppe aktualisiert wurde), geben Sie eine Zahl ein (1-100). Dies legt den Prozentsatz für den ersten Prüfpunkt fest.
1. Um einen weiteren Checkpoint hinzuzufügen, wählen Sie **Hinzufügen eines Checkpoints** aus und definieren Sie dann den Prozentsatz für den nächsten Checkpoint.
1. Um anzugeben, wie lange Amazon EC2 Auto Scaling wartet, nachdem ein Checkpoint erreicht wurde, aktualisieren Sie die Felder in **Zwischen Checkpoints `1` `hour` warten**. Die Zeiteinheit kann Stunden, Minuten oder Sekunden sein.
1. Wenn Sie mit Ihrer Auswahl für die Instance-Aktualisierung fertig sind, klicken Sie auf **Instance-Aktualisierung Starten**.
## Aktivieren von Prüfpunkten (AWS CLI)
Um eine Instance-Aktualisierung mit aktivierten Checkpoints mithilfe von zu starten AWS CLI, benötigen Sie eine Konfigurationsdatei, die die folgenden Parameter definiert:
+ `CheckpointPercentages`: Gibt Schwellenwerte für den Prozentsatz der zu ersetzenden Instances an. Diese Schwellenwerte stellen die Checkpoints zur Verfügung. Wenn der Prozentsatz der ersetzten und aufgewärmten Instances einen der angegebenen Schwellenwerte erreicht, wartet der Vorgang eine bestimmte Dauer. Geben Sie die Wartezeit im `CheckpointDelay` in Sekunden an. Wenn der angegebene Zeitraum abgelaufen ist, wird die Instance-Aktualisierung fortgesetzt, bis sie den nächsten Checkpoint erreicht (falls zutreffend).
+ `CheckpointDelay`: Gibt die Dauer in Sekunden an, die nach Erreichen eines Prüfpunkts gewartet wird, bevor fortgefahren wird. Wählen Sie einen Zeitraum, der genügend Zeit für die Durchführung Ihrer Überprüfungen bietet.
Der letzt im `CheckpointPercentages`-Array gezeigte Wert ist der Prozentsatz der Auto-Scaling-Gruppe, der erfolgreich ersetzt werden muss. Der Vorgang wechselt zu, `Successful` nachdem dieser Prozentsatz der Gruppe erfolgreich ersetzt wurde und jede Instance als abgeschlossen gilt.
**So erstellen Sie mehrere Checkpoints**
Verwenden Sie den folgenden [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)Beispielbefehl, um mehrere Checkpoints zu erstellen. In diesem Beispiel wird eine Instance-Aktualisierung konfiguriert, die zunächst ein Prozent der Auto-Scaling–Gruppe aktualisiert. Nach zehn Minuten Wartezeit aktualisiert sie dann die nächsten 19 Prozent und wartet weitere zehn Minuten. Schließlich aktualisiert es den Rest der Gruppe, bevor der Vorgang abgeschlossen wird.
```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```
Inhalt von `config.json`:
```
{
"AutoScalingGroupName": "my-asg",
"Preferences": {
"InstanceWarmup": 60,
"MinHealthyPercentage": 80,
"CheckpointPercentages": [1,20,100],
"CheckpointDelay": 600
}
}
```
**So erstellen Sie einen einzelnen Checkpoint**
Verwenden Sie den folgenden [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)Beispielbefehl, um einen einzelnen Checkpoint zu erstellen. In diesem Beispiel wird eine Instance-Aktualisierung konfiguriert, die zunächst 20 Prozent der Auto-Scaling-Gruppe aktualisiert. Nach zehn Minuten Wartezeit aktualisiert sie den Rest der Gruppe, bevor der Vorgang abgeschlossen wird.
```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```
Inhalt von `config.json`:
```
{
"AutoScalingGroupName": "my-asg",
"Preferences": {
"InstanceWarmup": 60,
"MinHealthyPercentage": 80,
"CheckpointPercentages": [20,100],
"CheckpointDelay": 600
}
}
```
**So aktuslieren Sie die Auto-Scaling-Gruppe teilweise**
Verwenden Sie den folgenden [start-instance-refresh](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/start-instance-refresh.html)Beispielbefehl, um nur einen Teil Ihrer Auto Scaling Scaling-Gruppe zu ersetzen und dann vollständig zu beenden. In diesem Beispiel wird eine Instance-Aktualisierung konfiguriert, die zunächst ein Prozent der Auto-Scaling–Gruppe aktualisiert. Nach zehn Minuten Wartezeit aktualisiert sie die nächsten 19 Prozent, bevor der Vorgang abgeschlossen wird.
```
aws autoscaling start-instance-refresh --cli-input-json file://config.json
```
Inhalt von `config.json`:
```
{
"AutoScalingGroupName": "my-asg",
"Preferences": {
"InstanceWarmup": 60,
"MinHealthyPercentage": 80,
"CheckpointPercentages": [1,20],
"CheckpointDelay": 600
}
}
```