AWS App Runner wird ab dem 30. April 2026 nicht mehr für Neukunden geöffnet sein. Wenn Sie App Runner verwenden möchten, melden Sie sich vor diesem Datum an. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter [Änderung der AWS App Runner Verfügbarkeit](https://docs.aws.amazon.com/apprunner/latest/dg/apprunner-availability-change.html).
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.
# Einen App Runner-Dienst konfigurieren
Wenn Sie [einen AWS App Runner Dienst erstellen](manage-create.md), legen Sie verschiedene Konfigurationswerte fest. Sie können einige dieser Konfigurationseinstellungen ändern, nachdem Sie den Dienst erstellt haben. Andere Einstellungen können nur bei der Erstellung des Dienstes angewendet werden und können danach nicht mehr geändert werden. In diesem Thema wird die Konfiguration Ihres Dienstes mithilfe der App Runner-API, der App Runner-Konsole und einer App Runner-Konfigurationsdatei beschrieben.
**Topics**
+ [Konfigurieren Sie Ihren Dienst mithilfe der App Runner API oder AWS CLI](#manage-configure.api)
+ [Konfigurieren Sie Ihren Dienst mit der App Runner-Konsole](#manage-configure.console)
+ [Konfigurieren Sie Ihren Dienst mithilfe einer App Runner-Konfigurationsdatei](#manage-configure.file)
+ [Observability für Ihren Service konfigurieren](manage-configure-observability.md)
+ [Konfiguration von Diensteinstellungen mithilfe gemeinsam nutzbarer Ressourcen](manage-configure-resources.md)
+ [Konfiguration von Zustandsprüfungen für Ihren Dienst](manage-configure-healthcheck.md)
## Konfigurieren Sie Ihren Dienst mithilfe der App Runner API oder AWS CLI
Die API definiert, welche Einstellungen nach der Erstellung des Dienstes geändert werden können. In der folgenden Liste werden die relevanten Aktionen, Typen und Einschränkungen beschrieben.
+ [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)Aktion — Kann nach der Erstellung aufgerufen werden, um einige Konfigurationseinstellungen zu aktualisieren.
+ *Kann aktualisiert werden* — Sie können die Einstellungen in den `HealthCheckConfiguration` Parametern `SourceConfiguration``InstanceConfiguration`, und aktualisieren. In `SourceConfiguration` können Sie Ihren Quelltyp jedoch nicht von Code zu Bild oder umgekehrt ändern. Sie müssen denselben Repository-Parameter angeben, den Sie bei der Erstellung des Dienstes angegeben haben. Es ist entweder oder. `CodeRepository` `ImageRepository`
Sie können auch die folgenden ARNs separaten Konfigurationsressourcen aktualisieren, die mit dem Dienst verknüpft sind:
+ `AutoScalingConfigurationArn`
+ `VpcConnectorArn`
+ *Kann nicht aktualisiert werden* — Sie können die `EncryptionConfiguration` Parameter `ServiceName` und, die in der [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)Aktion verfügbar sind, nicht ändern. Sie können nicht geändert werden, nachdem sie erstellt wurden. Die [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)Aktion beinhaltet diese Parameter nicht.
+ *API oder Datei* — Sie können den `ConfigurationSource` Parameter des [CodeConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CodeConfiguration.html)Typs (der für Quellcode-Repositorys als Teil von verwendet wird`SourceConfiguration`) auf `Repository` setzen. In diesem Fall ignoriert App Runner die Konfigurationseinstellungen in `CodeConfigurationValues` und liest diese Einstellungen aus einer [Konfigurationsdatei](config-file.md) in Ihrem Repository. Wenn Sie diese Option festlegen `ConfigurationSource``API`, ruft App Runner alle Konfigurationseinstellungen aus dem API-Aufruf ab und ignoriert die Konfigurationsdatei, auch wenn eine vorhanden ist.
+ [TagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_TagResource.html)action — Kann aufgerufen werden, nachdem Ihr Service erstellt wurde, um Tags zum Service hinzuzufügen oder Werte vorhandener Tags zu aktualisieren.
+ [UntagResource](https://docs.aws.amazon.com/apprunner/latest/api/API_UntagResource.html)action — Kann aufgerufen werden, nachdem Ihr Service erstellt wurde, um Tags aus dem Service zu entfernen.
**Anmerkung**
Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauffolgenden Dienststartvorgang eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen oder danach mit einem Service-Update. Weitere Informationen finden Sie [Einmalige Latenz](network-vpc.md#network-vpc.VPC-connector.latency) im Kapitel *Networking with App Runner* in diesem Handbuch.
## Konfigurieren Sie Ihren Dienst mit der App Runner-Konsole
Die Konsole verwendet die App Runner-API, um Konfigurationsupdates anzuwenden. Die Aktualisierungsregeln, die die API auferlegt, wie im vorherigen Abschnitt definiert, bestimmen, was Sie mit der Konsole konfigurieren können. Einige Einstellungen, die bei der Erstellung des Dienstes verfügbar waren, können später nicht geändert werden. Wenn Sie sich für die Verwendung einer [Konfigurationsdatei](config-file.md) entscheiden, werden zusätzliche Einstellungen außerdem in der Konsole ausgeblendet, und App Runner liest sie aus der Datei.
**Um Ihren Dienst zu konfigurieren**
1. Öffnen Sie die [App Runner-Konsole](https://console.aws.amazon.com/apprunner) und wählen Sie in der Liste der **Regionen** Ihre aus AWS-Region.
1. Wählen Sie im Navigationsbereich **Dienste** und dann Ihren App Runner-Dienst aus.
In der Konsole wird das Service-Dashboard mit einer **Serviceübersicht** angezeigt.
![\[App Runner Service-Dashboard-Seite mit einer Aktivitätsliste\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/console-dashboard.png)
1. Wählen Sie auf der Service-Dashboard-Seite die Registerkarte **Konfiguration** aus.
Ergebnis: Die Konsole zeigt die aktuellen Konfigurationseinstellungen Ihres Dienstes in mehreren Abschnitten an: **Quelle und Bereitstellung**, **Build konfigurieren** und **Dienst konfigurieren**.
1. Um die Einstellungen in einer beliebigen Kategorie zu aktualisieren, wählen Sie **Bearbeiten**.
1. Nehmen Sie auf der Seite zur Bearbeitung der Konfiguration die gewünschten Änderungen vor und wählen Sie dann **Änderungen speichern**.
**Anmerkung**
Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauffolgenden Dienststartvorgang eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen oder danach mit einem Service-Update. Weitere Informationen finden Sie [Einmalige Latenz](network-vpc.md#network-vpc.VPC-connector.latency) im Kapitel *Networking with App Runner* in diesem Handbuch.
## Konfigurieren Sie Ihren Dienst mithilfe einer App Runner-Konfigurationsdatei
Wenn Sie einen App Runner-Dienst erstellen oder aktualisieren, können Sie App Runner anweisen, einige Konfigurationseinstellungen aus einer Konfigurationsdatei zu lesen, die Sie als Teil Ihres Quell-Repositorys bereitstellen. Auf diese Weise können Sie die Einstellungen, die sich auf Ihren Quellcode beziehen, zusammen mit dem Code selbst unter der Quellcodeverwaltung verwalten. Die Konfigurationsdatei enthält auch bestimmte erweiterte Einstellungen, die Sie nicht über die Konsole oder die API festlegen können. Weitere Informationen finden Sie unter [App Runner-Dienstoptionen mithilfe einer Konfigurationsdatei einrichten](config-file.md).
**Anmerkung**
Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauffolgenden Dienststartvorgang eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen oder danach mit einem Service-Update. Weitere Informationen finden Sie [Einmalige Latenz](network-vpc.md#network-vpc.VPC-connector.latency) im Kapitel *Networking with App Runner* in diesem Handbuch.
# Observability für Ihren Service konfigurieren
AWS App Runner lässt sich in mehrere AWS Dienste integrieren, um Ihnen eine umfangreiche Suite von Observability-Tools für Ihren App Runner-Service zur Verfügung zu stellen. Weitere Informationen finden Sie unter [Observability für Ihren App Runner-Dienst](monitor.md).
App Runner unterstützt die Aktivierung einiger Observability-Funktionen und die Konfiguration ihres Verhaltens mithilfe einer gemeinsam nutzbaren Ressource namens. *ObservabilityConfiguration* Sie können eine Ressource zur Konfiguration von Observability bereitstellen, wenn Sie einen Dienst erstellen oder aktualisieren. Die App Runner-Konsole erstellt eine für Sie, wenn Sie einen neuen App Runner-Dienst erstellen. Die Bereitstellung einer Observability-Konfiguration ist optional. Wenn Sie keine angeben, bietet App Runner eine Standardkonfiguration für Observability.
Sie können eine einzige Observability-Konfiguration für mehrere App Runner-Dienste gemeinsam nutzen, um sicherzustellen, dass sie dasselbe Observability-Verhalten aufweisen. Weitere Informationen finden Sie unter [Konfiguration von Diensteinstellungen mithilfe gemeinsam nutzbarer Ressourcen](manage-configure-resources.md).
Sie können die folgenden Observability-Funktionen mithilfe von Observability-Konfigurationen konfigurieren:
+ *Trace-Konfiguration* — Einstellungen für die Ablaufverfolgung von Anfragen, die Ihre Anwendung bedient, und für die von ihr ausgeführten Downstream-Aufrufe. Weitere Informationen zum Tracing finden Sie unter [Tracing für Ihre App Runner-Anwendung mit X-Ray](monitor-xray.md).
## Beobachtbarkeit verwalten
Verwalten Sie die Beobachtbarkeit für Ihre App Runner-Dienste mit einer der folgenden Methoden:
------
#### [ App Runner console ]
Wenn Sie [einen Dienst mit der App Runner-Konsole erstellen](manage-create.md) oder [seine Konfiguration später aktualisieren](manage-configure.md), können Sie Observability-Funktionen für Ihren Service konfigurieren. Suchen Sie auf der Konsolenseite nach dem Abschnitt **zur Observability-Konfiguration**.
![\[Konfigurationsseite der App Runner-Konsole mit Observability-Optionen\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/manage-configure-observability.png)
------
#### [ App Runner API or AWS CLI ]
Wenn Sie die API-Aktionen [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)oder [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)App Runner aufrufen, können Sie das `ObservabilityConfiguration` Parameter-Objekt verwenden, um Observability-Funktionen zu aktivieren und eine Observability-Konfigurationsressource für Ihren Service anzugeben.
Verwenden Sie die folgenden App Runner-API-Aktionen, um Ihre Observability-Konfigurationsressourcen zu verwalten.
+ [CreateObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateObservabilityConfiguration.html)— Erstellt eine neue Observability-Konfiguration oder eine Revision einer bestehenden.
+ [ListObservabilityConfigurations](https://docs.aws.amazon.com/apprunner/latest/api/API_ListObservabilityConfigurations.html)— Gibt eine Liste der Observability-Konfigurationen zurück, die mit Ihrer verknüpft sind AWS-Konto, mit zusammenfassenden Informationen.
+ [DescribeObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DescribeObservabilityConfiguration.html)— Gibt eine vollständige Beschreibung einer Observability-Konfiguration zurück.
+ [DeleteObservabilityConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_DeleteObservabilityConfiguration.html)— Löscht eine Observability-Konfiguration. Sie können eine bestimmte Revision oder die letzte aktive Revision löschen. Möglicherweise müssen Sie nicht benötigte Observability-Konfigurationen löschen, wenn Sie das Kontingent für die Observability-Konfiguration für Ihre erreichen. AWS-Konto
------
# Konfiguration von Diensteinstellungen mithilfe gemeinsam nutzbarer Ressourcen
Bei einigen Funktionen ist es sinnvoll, die Konfiguration für alle AWS App Runner Dienste gemeinsam zu nutzen. Beispielsweise möchten Sie möglicherweise, dass eine Reihe von Diensten dasselbe Auto Scaling-Verhalten aufweisen. Oder Sie möchten vielleicht identische Observability-Einstellungen für alle Ihre Dienste. Mit App Runner können Sie Einstellungen gemeinsam nutzen, indem Sie separate gemeinsam nutzbare Ressourcen verwenden. Sie erstellen eine Ressource, die eine Reihe von Konfigurationseinstellungen für eine Funktion definiert, und geben dann den Amazon-Ressourcennamen (ARN) dieser Konfigurationsressource an einen oder mehrere App Runner-Dienste weiter.
App Runner implementiert gemeinsam nutzbare Konfigurationsressourcen für die folgenden Funktionen:
+ [Auto-Scaling](manage-autoscaling.md)
+ [Beobachtbarkeit](manage-configure-observability.md)
+ [VPC-Zugriff](network-vpc.md)
Die Dokumentseite für jede dieser Funktionen enthält Informationen zu den verfügbaren Einstellungen und den Verwaltungsverfahren.
Funktionen, die separate Konfigurationsressourcen verwenden, haben einige Konstruktionsmerkmale und Überlegungen gemeinsam.
+ **Revisionen** — Bei einigen Konfigurationsressourcen können Änderungen vorgenommen werden. Auto Scaling und Observability sind Beispiele für zwei Konfigurationsressourcen, die Revisionen verwenden. *In diesen Fällen hat jede Konfiguration einen *Namen* und eine numerische Revision.* Mehrere Versionen einer Konfiguration haben denselben Namen und unterschiedliche Revisionsnummern. Sie können unterschiedliche Konfigurationsnamen für verschiedene Szenarien verwenden. Für jeden Namen können Sie mehrere Versionen hinzufügen, um die Einstellungen für ein bestimmtes Szenario zu optimieren.
Die erste Konfiguration, die Sie mit einem Namen erstellen, erhält die Revisionsnummer 1. Nachfolgende Konfigurationen mit demselben Namen erhalten fortlaufende Revisionsnummern (beginnend mit 2). Sie können Ihren App Runner-Dienst einer bestimmten Konfigurationsrevision oder der neuesten Version der Konfiguration zuordnen.
+ **Gemeinsam genutzt** — Sie können eine einzelne Konfigurationsressource für mehrere App Runner-Dienste gemeinsam nutzen. Dies ist nützlich, wenn Sie identische Konfigurationen für diese Dienste beibehalten möchten. Insbesondere, wenn Ihre Ressourcen Revisionen unterstützen, können Sie mehrere Dienste so konfigurieren, dass sie die neueste Version einer Konfiguration verwenden. Sie können dies tun, indem Sie nur den Namen der Konfiguration angeben, aber keine Revision. Jeder der Dienste, die Sie auf diese Weise konfiguriert haben, erhält Konfigurationsupdates, wenn Sie den Dienst aktualisieren. Weitere Informationen zu Konfigurationsänderungen finden Sie unter[Einen App Runner-Dienst konfigurieren](manage-configure.md).
+ **Ressourcenverwaltung** — Sie können App Runner verwenden, um Konfigurationen zu erstellen und zu löschen. Sie können eine Konfiguration nicht direkt aktualisieren. Stattdessen können Sie für Ressourcen, die Revisionen unterstützen, eine neue Version eines vorhandenen Konfigurationsnamens erstellen, um die Konfiguration effektiv zu aktualisieren.
**Anmerkung**
Für die auto Skalierung können Sie Konfigurationen und *mehrere* Revisionen sowohl mit der App Runner-Konsole als auch mit der App Runner-API erstellen. Sowohl die App Runner-Konsole als auch die App Runner-API können auch Konfigurationen und Revisionen löschen. Weitere Details finden Sie unter [Verwaltung der automatischen Skalierung von App Runner](manage-autoscaling.md).
Für andere Konfigurationstypen, wie Observability-Konfigurationen, können Sie mit der App Runner-Konsole nur eine Konfiguration mit einer *einzigen* Revision erstellen. Um weitere Revisionen zu erstellen und Konfigurationen zu löschen, müssen Sie die App Runner-API verwenden.
+ **Ressourcenkontingent** — Es gibt festgelegte Kontingente für die Anzahl der eindeutigen Konfigurationsnamen und Revisionen, die Sie jeweils für Ihre Konfigurationsressourcen haben können. AWS-Region Wenn Sie diese Kontingente erreichen, müssen Sie entweder einen Konfigurationsnamen oder zumindest einige seiner Versionen löschen, bevor Sie weitere erstellen können. Für Revisionen von Auto Scaling-Konfigurationen können Sie die App Runner-Konsole oder die App Runner-API verwenden, um sie zu löschen. Weitere Details finden Sie unter [Verwaltung der automatischen Skalierung von App Runner](manage-autoscaling.md). Sie müssen die App Runner-API verwenden, um andere Ressourcen zu löschen. Weitere Informationen zu Kontingenten finden Sie unter [App Runner-Ressourcenkontingente](architecture.md#architecture.quotas).
+ **Keine Ressourcenkosten** — Es fallen keine zusätzlichen Kosten für die Erstellung einer Konfigurationsressource an. Möglicherweise fallen Kosten für die Funktion selbst an (wenn Sie X-Ray Tracing aktivieren, werden Ihnen beispielsweise die normalen AWS X-Ray Kosten in Rechnung gestellt), aber nicht für die App Runner-Konfigurationsressource, die die Funktion für Ihren App Runner-Dienst konfiguriert.
# Konfiguration von Zustandsprüfungen für Ihren Dienst
AWS App Runner überwacht den Zustand Ihres Dienstes, indem es Integritätsprüfungen durchführt. Das Standardprotokoll für die Integritätsprüfung ist TCP. App Runner pingt die Ihrem Dienst zugewiesene Domain an. Sie können das Health Check-Protokoll alternativ auf HTTP setzen. App Runner sendet HTTP-Anfragen zur Integritätsprüfung an Ihre Webanwendung.
Sie können einige Einstellungen für Integritätsprüfungen konfigurieren. In der folgenden Tabelle werden die Einstellungen für die Integritätsprüfung und ihre Standardwerte beschrieben.
| **Einstellung** | **Beschreibung** | **Standard** |
| --- | --- | --- |
| Protocol (Protokoll) | Das IP-Protokoll, das App Runner zur Durchführung von Zustandsprüfungen für Ihren Service verwendet. Wenn Sie das Protokoll auf einstellen`TCP`, pingt App Runner die Ihrem Dienst zugewiesene Standarddomäne an den Port, den Ihre Anwendung abhört. Wenn Sie das Protokoll auf einstellen`HTTP`, sendet App Runner Integritätsprüfungsanfragen an den konfigurierten Pfad. | `TCP` |
| Pfad | Die URL, an die App Runner HTTP-Integritätsprüfungsanfragen sendet. Gilt nur für HTTP-Prüfungen. | `/` |
| Intervall | Das Intervall in Sekunden zwischen den Zustandsprüfungen. | `5` |
| Zeitüberschreitung | Die Zeit in Sekunden, die auf eine Antwort auf eine Zustandsprüfung gewartet wird, bevor diese als fehlgeschlagen gewertet wird. | `2` |
| Gesunder Schwellenwert | Die Anzahl der aufeinanderfolgenden Prüfungen, die erfolgreich sein müssen, bevor App Runner entscheidet, dass der Service einwandfrei ist. | `1` |
| Ungesunder Schwellenwert | Die Anzahl der aufeinanderfolgenden Prüfungen, die fehlschlagen müssen, bevor App Runner entscheidet, dass der Service-Zustand nicht ordnungsgemäß ist. | `5` |
## Konfigurieren Sie Integritätsprüfungen
Konfigurieren Sie Integritätsprüfungen für Ihren App Runner-Dienst mit einer der folgenden Methoden:
------
#### [ App Runner console ]
Wenn Sie Ihren App Runner-Dienst mit der App Runner-Konsole erstellen oder wenn Sie seine Konfiguration später aktualisieren, können Sie die Einstellungen für die Integritätsprüfung konfigurieren. Vollständige Konsolenprozeduren finden Sie unter [Einen App Runner-Dienst erstellen](manage-create.md) und[Einen App Runner-Dienst konfigurieren](manage-configure.md). Suchen Sie in beiden Fällen auf der Konsolenseite nach dem Abschnitt **Health Check-Konfiguration**.
![\[Konfigurationsseite der App Runner-Konsole mit Optionen zur Integritätsprüfung\]](http://docs.aws.amazon.com/de_de/apprunner/latest/dg/images/console-health-check.png)
------
#### [ App Runner API or AWS CLI ]
Wenn Sie die [CreateService](https://docs.aws.amazon.com/apprunner/latest/api/API_CreateService.html)oder [UpdateService](https://docs.aws.amazon.com/apprunner/latest/api/API_UpdateService.html)API-Aktionen aufrufen, können Sie den `HealthCheckConfiguration` Parameter verwenden, um Einstellungen für die Integritätsprüfung festzulegen.
Informationen zur Struktur des Parameters finden Sie [HealthCheckConfiguration](https://docs.aws.amazon.com/apprunner/latest/api/API_HealthCheckConfiguration.html)in der *AWS App Runner API-Referenz*.
------