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.

# Aktualisierung des Amazon ECS-Container-Agenten auf einem Amazon ECS-optimized AMI
<a name="agent-update-ecs-ami"></a>

Wenn Sie einen Amazon verwenden ECS-optimized AMI, Sie haben mehrere Optionen, um die neueste Version des Amazon ECS-Container-Agenten zu erhalten (in der Reihenfolge der Empfehlungen angezeigt):
+ Beenden Sie die Container-Instance und starten Sie die neueste Version von Amazon ECS-optimized Amazon Linux 2 AMI (entweder manuell oder durch Aktualisierung Ihrer Auto Scaling-Startkonfiguration mit dem neuesten AMI). So erhalten Sie eine neue Container-Instance mit den aktuellen getesteten und validierten Versionen von Amazon Linux, Docker, `ecs-init` und Amazon-ECS-Container-Agent. Weitere Informationen finden Sie unter [Amazonas ECS-optimized Linux-AMIs](ecs-optimized_AMI.md).
+ Verbinden Sie sich über SSH mit der Instance und aktualisieren Sie das `ecs-init`-Paket (sowie seine Abhängigkeiten) auf die neueste Version. Dieser Vorgang liefert die aktuellsten getesteten und validierten Versionen von Docker und `ecs-init`, die in den Amazon Linux-Repositories verfügbar sind, sowie die neueste Version des Amazon-ECS-Container-Agenten. Weitere Informationen finden Sie unter [Um das zu aktualisieren `ecs-init` Paket auf einem Amazon ECS-optimized AMI](#procedure_update_ecs-init).
+ Aktualisieren Sie den Container-Agenten mit dem `UpdateContainerAgent` API-Betrieb, entweder über die Konsole oder mit AWS CLI oder AWS SDKs. Weitere Informationen finden Sie unter [Aktualisieren des Amazon-ECS-Container-Agenten mit der `UpdateContainerAgent`-API-Operation](#agent-update-api).

**Anmerkung**  
Agent-Updates gelten nicht für Windows-Container-Instances. Wir empfehlen, dass Sie die neuen Container-Instances starten, um die Agent-Version in Ihren Windows-Clustern zu aktualisieren.<a name="procedure_update_ecs-init"></a>

**Um das zu aktualisieren `ecs-init` Paket auf einem Amazon ECS-optimized AMI**

1. Melden Sie sich bei Ihrer Container-Instance über SSH an.

1. Aktualisieren Sie das `ecs-init`-Paket mit dem folgenden Befehl.

   ```
   sudo yum update -y ecs-init
   ```
**Anmerkung**  
Das `ecs-init`-Paket und der Amazon-ECS-Container-Agent werden sofort aktualisiert. Neuere Versionen von Docker werden jedoch nicht geladen, bis der Docker-Daemon neu gestartet wird. Machen Sie einen Neustart, indem Sie entweder die Instance neu starten oder die folgenden Befehle auf Ihrer Instance ausführen:  
Amazonas ECS-optimized Amazon Linux 2-AMI:  

     ```
     sudo systemctl restart docker
     ```
Amazonas ECS-optimized Amazon Linux-AMI:  

     ```
     sudo service docker restart && sudo start ecs
     ```

## Aktualisieren des Amazon-ECS-Container-Agenten mit der `UpdateContainerAgent`-API-Operation
<a name="agent-update-api"></a>

**Wichtig**  
Das `UpdateContainerAgent` Die API wird nur auf Linux-Varianten von Amazon unterstützt ECS-optimized AMI, mit Ausnahme von Amazon ECS-optimized Amazon Linux 2 (arm64) AMI. Für Container-Instances, die Amazon verwenden ECS-optimized Amazon Linux 2 (arm64) AMI, aktualisieren Sie das `ecs-init` Paket, um den Agenten zu aktualisieren. Informationen zu Container-Instances, die auf anderen Betriebssystemen laufen, finden Sie unter [Manuelles Aktualisieren des Amazon ECS-Container-Agenten (für Nicht-Amazon ECS-Optimized AMIs)](manually_update_agent.md). Sollten Sie Windows-Container-Instances nutzen, empfehlen wir, dass Sie die neuen Container-Instances starten, um die Agent-Version in Ihren Windows-Clustern zu aktualisieren.

Das `UpdateContainerAgent` Der API-Prozess beginnt, wenn Sie ein Agenten-Update anfordern, entweder über die Konsole oder mit AWS CLI oder AWS SDKs. Amazon ECS prüft, ob Ihre derzeitige Agent-Version der neuesten verfügbaren Agent-Version entspricht und ob eine Aktualisierung verfügbar ist. Wenn keine Aktualisierung verfügbar ist, beispielsweise, wenn der Agent bereits mit der neuesten Version läuft, wird eine `NoUpdateAvailableException` zurückgegeben.

Der Aktualisierungsprozess läuft wie folgt ab:

`PENDING`  
Ein Agent-Aktualisierung ist verfügbar und der Aktualisierungsprozess wurde gestartet.

`STAGING`  
Der Agent hat mit dem Herunterladen der Agent-Aktualisierung begonnen. Wenn der Agent die Aktualisierung nicht herunterladen kann oder wenn der Inhalt der Aktualisierung falsch oder korrupt ist, sendet der Agent eine Benachrichtigung des Fehlers und die Aktualisierung geht in den `FAILED`-Status über.

`STAGED`  
Das Herunterladen des Agent ist abgeschlossen und die Agent-Inhalte wurden bestätigt.

`UPDATING`  
Der `ecs-init`-Service wird mit der neuen Agenten-Version neu gestartet. Wenn der Agent nicht neu starten kann, geht die Aktualisierung in den `FAILED`-Status über. Andernfalls zeigt der Agent Amazon ECS an, dass die Aktualisierung nicht abgeschlossen wurde.

**Anmerkung**  
Agent-Updates gelten nicht für Windows-Container-Instances. Wir empfehlen, dass Sie die neuen Container-Instances starten, um die Agent-Version in Ihren Windows-Clustern zu aktualisieren.

**Um den Amazon ECS-Container-Agenten auf einem Amazon zu aktualisieren ECS-optimized AMI in der Konsole**

1. Öffnen Sie die Konsole unter [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Wählen Sie auf der Navigationsleiste die Region aus, in der Ihre externe Instance registriert ist.

1. Wählen Sie im Navigationsbereich **Clusters** und dann den Cluster aus.

1. Auf der **Cluster: {{name}}** Seite, wählen Sie die **Infrastruktur** Tab.

1. Wählen Sie unter **Container-Instances** die zu aktualisierenden Instances aus, und wählen Sie dann **Aktionen**, **Agent aktualisieren**.