

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 eines Amazon ECS-Service
<a name="update-service-console-v2"></a>

Nachdem Sie einen Service erstellt haben, müssen Sie möglicherweise die Serviceparameter aktualisieren, beispielsweise die Anzahl der Aufgaben.

Wenn Sie einen Service aktualisieren, der den Amazon-ECS-Schutzschalter verwendet, erstellt Amazon ECS eine Servicebereitstellung und eine Service-Revision. Diese Ressourcen ermöglichen es Ihnen, detaillierte Informationen zum Service-Verlauf einzusehen. Weitere Informationen finden Sie unter [Anzeigen des Service-Verlaufs mithilfe von Service-Bereitstellungen in Amazon ECS](service-deployment.md).

## Voraussetzungen
<a name="update-service-prerequisites"></a>

Überprüfen Sie vor dem Aktualisieren eines Services, welche Serviceparameter für Ihren Bereitstellungstyp geändert werden können. Eine vollständige Liste der Parameter, die Sie ändern können, finden Sie unter [Aktualisieren der Amazon-ECS-Serviceparameter](update-service-parameters.md).

## Verfahren
<a name="update-service-procedure"></a>

------
#### [ Console ]

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

1. Wählen Sie auf der **Cluster**-Seite den Cluster aus.

1. Aktivieren Sie auf der Seite mit den Cluster-Details im Abschnitt **Services** das Kontrollkästchen neben dem Service und wählen Sie dann **Aktualisieren** aus.

1. Wählen Sie **Force new deployment** (Neue Bereitstellung erzwingen) aus, damit Ihr Service eine neue Bereitstellung startet.

1. Wählen Sie für **Aufgabendefinition** die Aufgabendefinitionsfamilie und die Version aus.
**Wichtig**  
Die Konsole überprüft, ob die ausgewählte Aufgabendefinitionsfamilie und -revision mit der definierten Rechenkonfiguration kompatibel sind. Wenn Sie eine Warnung erhalten, überprüfen Sie sowohl die Kompatibilität Ihrer Aufgabendefinition als auch die ausgewählte Rechenkonfiguration.

1. Wenn Sie **Replica** (Replikat) gewählt haben, geben Sie bei **Desired tasks** (Gewünschte Aufgaben) die Anzahl der Aufgaben ein, die im Service gestartet und gepflegt werden sollen.

1. Wenn Sie **Replikat** auswählen, damit Amazon ECS die Verteilung der Aufgaben auf die Availability Zones überwacht und sie bei einem Ungleichgewicht neu verteilt, wählen Sie unter **Service-Neuausgleich der Availability Zone** die Option **Service-Neuausgleich der Availability Zone** aus.

1. Für **Min running tasks** (Min. laufende Aufgaben) geben Sie die untere Grenze für die Anzahl der Aufgaben im Service an, die während eines Einsatzes in diesem `RUNNING`-Zustand verbleiben müssen, und zwar als Prozentsatz der gewünschten Anzahl von Aufgaben (aufgerundet auf die nächste ganze Zahl). Weitere Informationen finden Sie unter [Bereitstellungs-Konfiguration](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service_definition_parameters.html#sd-deploymentconfiguration).

1. Geben Sie für **Max running tasks** (Max. laufende Aufgaben) die Obergrenze für die Anzahl der Aufgaben im Service ein, die sich während einer Bereitstellung im Status `RUNNING` oder `PENDING` befinden dürfen, und zwar als Prozentsatz der gewünschten Anzahl von Aufgaben (abgerundet auf die nächste Ganzzahl).

1. Um zu konfigurieren, wie Aufgaben für Ihren Service bereitgestellt werden, erweitern Sie die **Bereitstellungsoptionen** und konfigurieren Sie dann Ihre Optionen.

   1. Geben Sie als **Bereitstellungs-Controller-Typ** den Servicebereitstellungs-Controller an. Die Amazon-ECS-Konsole unterstützt die folgenden Controller-Typen: `ECS`.

   1. Wählen Sie unter **Bereitstellungsstrategie** die Strategie aus, die Amazon ECS für die Bereitstellung neuer Versionen des Service verwendet.

   1. Abhängig von der ausgewählten **Bereitstellungsstrategie** gehen Sie wie folgt vor:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/update-service-console-v2.html)

   1. Um Lambda-Funktionen für eine Lebenszyklusphase auszuführen, gehen Sie unter **Bereitstellungs-Lebenszyklus-Hooks** für jede einzelne Lambda-Funktion wie folgt vor:

      1. Wählen Sie **Hinzufügen** aus.

         Wiederholen Sie den Prozess für jede einzelne Funktion, die Sie ausführen möchten.

      1. Geben Sie für **Lambda-Funktion** den Funktionsnamen ein.

      1. Wählen Sie **unter Rolle** die Rolle aus, die Sie in den Voraussetzungen mit den blue/green entsprechenden Berechtigungen erstellt haben.

         Weitere Informationen finden Sie unter [Erforderliche Berechtigungen für Lambda-Funktionen in Amazon ECS-Bereitstellungen blue/green](blue-green-permissions.md).

      1. Wählen Sie für **Lebenszyklusphasen** die Phasen aus, in denen die Lambda-Funktion ausgeführt wird.

      1.  (Optional) Geben Sie für **Hook-Details** ein Schlüssel-Wert-Paar ein, das Informationen über den Hook bereitstellt.

1. Um zu konfigurieren, wie Amazon ECS Bereitstellungsfehler erkennt und behandelt, erweitern Sie **Deployment failure detection** (Erkennung von Bereitstellungsfehlern) und wählen Sie dann Ihre Optionen. 

   1. Um eine Bereitstellung anzuhalten, wenn die Aufgaben nicht gestartet werden können, wählen Sie **Use the Amazon ECS deployment circuit breaker** (Verwenden des Amazon-ECS-Bereitstellungsschutzschalters).

      Wenn Sie möchten, dass die Software die Bereitstellung automatisch auf den letzten abgeschlossenen Bereitstellungsstatus zurücksetzt, wenn der Bereitstellungs-Schutzschalter die Bereitstellung auf einen fehlgeschlagenen Status setzt, wählen Sie **Rollback bei Fehler** aus.

   1. Um eine Bereitstellung auf der Grundlage von Anwendungsmetriken zu beenden, wählen Sie ** CloudWatch Alarm (en) verwenden** aus. Wählen Sie dann unter **CloudWatch Alarmname** die Alarme aus. Um einen neuen Alarm zu erstellen, gehen Sie zur CloudWatch Konsole.

      Damit die Software die Bereitstellung automatisch auf den Status der letzten abgeschlossenen Bereitstellung zurücksetzt, wenn ein CloudWatch Alarm die Bereitstellung in einen fehlgeschlagenen Zustand versetzt, wählen Sie **Rollback bei Fehlern** aus.

1. Um die Rechenoptionen zu ändern, erweitern Sie **Rechenkonfiguration** und gehen Sie wie folgt vor: 

   1. Wählen Sie für Services on AWS Fargate für **Plattformversion** die neue Version aus.

   1. Bei Services, die eine Kapazitätsanbieter-Strategie verwenden, verfahren Sie bei der **Kapazitätsanbieter-Strategie** wie folgt:
      + Um einen zusätzlichen Kapazitätsanbieter hinzuzufügen, wählen Sie **Weitere hinzufügen** aus. Wählen Sie dann für **Kapazitätsanbieter** den Kapazitätsanbieter aus.
      + Um einen Kapazitätsanbieter zu entfernen, wählen Sie rechts neben dem Kapazitätsanbieter die Option **Entfernen** aus.

      Ein Service, der einen Auto-Scaling-Gruppen-Kapazitätsanbieter verwendet, kann nicht aktualisiert werden, um einen Fargate-Kapazitätsanbieter zu verwenden. Ein Service, der einen Fargate-Kapazitätsanbieter verwendet, kann nicht aktualisiert werden, um einen Auto-Scaling-Gruppen-Kapazitätsanbieter zu verwenden.

1. (Optional) Um Service-Auto-Scaling zu konfigurieren, erweitern Sie **Service-Auto-Scaling** und geben Sie dann die folgenden Parameter an. Um prädiktives Auto Scaling zu verwenden, das vergangene Ladedaten aus Datenverkehrsflüssen betrachtet, konfigurieren Sie dies, nachdem Sie den Service erstellt haben. Weitere Informationen finden Sie unter [Verwenden Sie historische Muster, um Amazon ECS-Services mit vorausschauender Skalierung zu skalieren](predictive-auto-scaling.md).

   1. Um das Auto Scaling der Services zu verwenden, wählen Sie **Auto Scaling des Services**.

   1. Geben Sie unter **Mindestanzahl an Aufgaben**, die Untergrenze der Anzahl der Aufgaben an, die das Service-Auto-Scaling verwenden kann. Die gewünschte Anzahl wird diese Anzahl nicht unterschreiten.

   1. Geben Sie unter **Höchstanzahl an Aufgaben** die Obergrenze der Anzahl der Aufgaben an, die das Service-Auto-Scaling verwenden kann. Die gewünschte Anzahl wird diese Anzahl nicht überschreiten.

   1. Wählen Sie den Richtlinien-Typ aus. Wählen Sie unter **Skalierungsrichtlinientyp** eine der folgenden Optionen aus.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/update-service-console-v2.html)

1. (Optional) Um Service Connect zu verwenden, wählen Sie **Turn on Service Connect** (Service Connect aktivieren) aus, und geben Sie dann Folgendes an:

   1. Geben Sie unter **Service Connect configuration** (Service-Connect-Konfiguration) den Client-Modus an.
      + Wenn Ihr Service eine Netzwerk-Client-Anwendung ausführt, die nur eine Verbindung zu anderen Services im Namespace herstellen muss, wählen Sie **Nur Client-Seite** aus.
      + Wenn Ihr Service eine Netzwerk- oder Webservice-Anwendung ausführt und Endpunkte für diesen Service bereitstellen muss und eine Verbindung zu anderen Services im Namespace herstellt, wählen Sie **Client and server** (Client und Server) aus.

   1. Um einen Namespace zu verwenden, der nicht der Standard-Cluster-Namespace ist, wählen Sie für **Namespace** den Service-Namespace aus. Dabei kann es sich um einen Namespace handeln, der separat in demselben AWS-Region in Ihrem Konto erstellt wurde, AWS-Konto oder um einen Namespace in derselben Region, der mithilfe AWS Resource Access Manager von () mit Ihrem Konto geteilt wird.AWS RAM*Weitere Informationen zur gemeinsamen Nutzung von AWS Cloud Map Namespaces finden Sie unter [Kontenübergreifende AWS Cloud Map](https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html) gemeinsame Nutzung von Namespaces im Entwicklerhandbuch AWS Cloud Map *

   1. (Optional) Geben Sie eine Protokollkonfiguration an. Wählen Sie **Protokollsammlung verwenden** aus. Die Standardoption sendet Container-Logs an Logs. CloudWatch Die anderen Protokolltreiberoptionen werden mit konfiguriert AWS FireLens. Weitere Informationen finden Sie unter [Amazon ECS-Protokolle an einen AWS Service senden oder AWS Partner](using_firelens.md).

      Im Folgenden wird jedes Container-Protokollziel ausführlicher beschrieben.
      + **Amazon CloudWatch** — Konfigurieren Sie die Aufgabe, um Container-Logs an CloudWatch Logs zu senden. Es werden die standardmäßigen Protokolltreiberoptionen bereitgestellt, mit denen in Ihrem Namen eine CloudWatch Protokollgruppe erstellt wird. Um einen anderen Protokollgruppen-Namen anzugeben, ändern Sie die Werte der Treiberoption.
      + **Amazon Data Firehose** – Konfigurieren Sie die Aufgabe, dass Container-Protokolle an Firehose gesendet werden. Die Standardoptionen für den Protokolltreiber werden bereitgestellt, wodurch die Protokolle an einen Bereitstellungsdatenstrom von Firehose gesendet werden. Um einen anderen Namen für den Bereitstellungsdatenstrom anzugeben, ändern Sie die Werte der Treiberoption.
      + **Amazon Kinesis Data Streams** – Konfigurieren Sie die Aufgabe, dass Container-Protokolle an Kinesis Data Streams gesendet werden. Die Standardoptionen für den Protokolltreiber werden bereitgestellt, wodurch Protokolle an einen Datenstrom von Kinesis Data Streams gesendet werden. Um einen anderen Datenstrom-Namen anzugeben, ändern Sie die Werte der Treiberoption.
      + **Amazon OpenSearch Service** — Konfigurieren Sie die Aufgabe, um Container-Logs an eine OpenSearch Service-Domain zu senden. Die Optionen für den Protokolltreiber müssen bereitgestellt werden. 
      + **Amazon S3** – Konfigurieren Sie die Aufgabe, dass Container-Protokolle an einen Amazon-S3-Bucket gesendet werden. Die Standardoptionen für den Protokolltreiber werden bereitgestellt, Sie müssen jedoch einen gültigen Amazon-S3-Bucket-Namen angeben.

   1. Gehen Sie wie folgt vor, um Zugriffsprotokolle zu aktivieren:

      1. Erweitern Sie die **Konfiguration des Zugriffsprotokolls**. Wählen Sie als **Format** entweder **JSON** oder`TEXT`.

      1. Um Abfrageparameter in Zugriffsprotokolle aufzunehmen, wählen Sie **Abfrageparameter einbeziehen** aus.
**Anmerkung**  
Um Zugriffsprotokolle zu deaktivieren, wählen Sie **unter Format** die Option **Keine** aus.

1. Wenn Ihre Aufgabe ein Daten-Volume verwendet, das mit der Konfiguration bei der Bereitstellung kompatibel ist, können Sie das Volume konfigurieren, indem Sie **Volume** erweitern.

   Der Volume-Name und der Volume-Typ werden konfiguriert, wenn Sie eine Revision der Aufgabendefinition erstellen, und können nicht geändert werden, wenn Sie einen Service aktualisieren. Um den Namen und den Typ des Volumes zu aktualisieren, müssen Sie eine neue Revision der Aufgabendefinition erstellen und den Service mithilfe der neuen Revision aktualisieren.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/AmazonECS/latest/developerguide/update-service-console-v2.html)

1. (Optional) Um Ihren Service leichter identifizieren zu können, erweitern Sie die **Tags** (Tags) und konfigurieren Sie dann Ihre Tags.
   + [Tag hinzufügen] Wählen Sie **Tag hinzufügen**, und führen Sie die folgenden Schritte aus:
     + Geben Sie bei **Key (Schlüssel)** den Schlüsselnamen ein.
     + Geben Sie bei **Value (Wert)** den Wert des Schlüssels ein.
   + [Tag entfernen] Wählen Sie neben dem Tag die Option **Remove tag (Tag löschen)** aus.

1. Wählen Sie **Aktualisieren** aus.

------
#### [ AWS CLI ]
+ Führen Sie `update-service`. Informationen zur Ausführung des Befehls finden Sie unter [update-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/update-service.html) in der Referenz. AWS Command Line Interface 

  Im folgenden `update-service`-Beispiel wird die gewünschte Aufgabenanzahl des Services `my-http-service` auf 2 aktualisiert.

  Ersetzen Sie die *user-input* durch Ihre Werte.

  ```
  aws ecs update-service \
      --cluster MyCluster \
      --service my-http-service \
      --desired-count 2
  ```

------

## Nächste Schritte
<a name="update-service-next-steps"></a>

Verfolgen Sie Ihre Bereitstellung und zeigen Sie Ihren Service-Verlauf für Services an, die der Amazon-ECS-Schutzschalter unterbricht. Weitere Informationen finden Sie unter [Anzeigen des Service-Verlaufs mithilfe von Service-Bereitstellungen in Amazon ECS](service-deployment.md).