View a markdown version of this page

Konfiguration eines App Runner-Dienstes - AWS App Runner
Konfigurieren Sie Ihren Dienst mithilfe der App Runner API oder AWS CLIKonfigurieren Sie Ihren Dienst mithilfe der App Runner-KonsoleKonfigurieren Sie Ihren Dienst mithilfe einer App Runner-Konfigurationsdatei

AWS App Runner ist nicht mehr offen für neue Kunden. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS App Runner Verfügbarkeit.

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.

Konfiguration eines App Runner-Dienstes

Wenn Sie einen AWS App Runner Dienst erstellen, legen Sie verschiedene Konfigurationswerte fest. Sie können einige dieser Konfigurationseinstellungen ändern, nachdem Sie den Dienst erstellt haben. Andere Einstellungen können nur beim Erstellen des Dienstes angewendet und 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.

Themen

Konfigurieren Sie Ihren Dienst mithilfe der App Runner API oder AWS CLI

Die API definiert, welche Einstellungen nach der Diensterstellung geändert werden können. In der folgenden Liste werden die relevanten Aktionen, Typen und Einschränkungen beschrieben.

  • UpdateServiceAktion — Kann nach der Erstellung aufgerufen werden, um einige Konfigurationseinstellungen zu aktualisieren.

    • Kann aktualisiert werden — Sie können die Einstellungen in den HealthCheckConfiguration Parametern SourceConfigurationInstanceConfiguration, 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 der separaten Konfigurationsressourcen aktualisieren, die dem Dienst zugeordnet sind:

      • AutoScalingConfigurationArn

      • VpcConnectorArn

    • Kann nicht aktualisiert werden — Sie können die in der CreateService Aktion verfügbaren EncryptionConfiguration Parameter ServiceName und nicht ändern. Sie können nicht mehr geändert werden, nachdem sie erstellt wurden. Die UpdateService Aktion beinhaltet diese Parameter nicht.

    • API im Vergleich zu Datei — Sie können den ConfigurationSource Parameter des CodeConfiguration Typs (der für Quellcode-Repositorys als Teil von verwendet wirdSourceConfiguration) auf Repository setzen. In diesem Fall ignoriert App Runner die Konfigurationseinstellungen in CodeConfigurationValues und liest diese Einstellungen aus einer Konfigurationsdatei in Ihrem Repository. Wenn Sie ConfigurationSource auf setzenAPI, ruft App Runner alle Konfigurationseinstellungen aus dem API-Aufruf ab und ignoriert die Konfigurationsdatei, auch wenn eine existiert.

  • TagResourceaction — Kann aufgerufen werden, nachdem Ihr Dienst erstellt wurde, um dem Dienst Tags hinzuzufügen oder Werte vorhandener Tags zu aktualisieren.

  • UntagResourceAktion — Kann aufgerufen werden, nachdem Ihr Dienst erstellt wurde, um Tags aus dem Dienst zu entfernen.

Anmerkung

Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauf folgenden Startvorgang des Dienstes eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen, oder später mit einem Dienstupdate. Weitere Informationen finden Sie Einmalige Latenz im Kapitel Networking with App Runner in diesem Handbuch.

Konfigurieren Sie Ihren Dienst mithilfe der App Runner-Konsole

Die Konsole verwendet die App Runner API, um Konfigurationsupdates anzuwenden. Die von der API auferlegten Aktualisierungsregeln, 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 entscheiden, werden zusätzliche Einstellungen in der Konsole ausgeblendet, und App Runner liest sie aus der Datei.

Um Ihren Dienst zu konfigurieren

  1. Öffnen Sie die App Runner-Konsole und wählen Sie in der Liste der Regionen Ihre aus AWS-Region.

  2. Wählen Sie im Navigationsbereich Dienste und dann Ihren App Runner-Dienst aus.

    Die Konsole zeigt das Service-Dashboard mit einer Serviceübersicht an.

    Die App Runner-Service-Dashboard-Seite mit der Aktivitätsliste

  3. Wählen Sie auf der Service-Dashboard-Seite die Registerkarte Konfiguration aus.

    Ergebnis: In der Konsole werden die aktuellen Konfigurationseinstellungen Ihres Dienstes in mehreren Abschnitten angezeigt: Quelle und Bereitstellung , Build konfigurieren und Dienst konfigurieren.

  4. Um die Einstellungen in einer beliebigen Kategorie zu aktualisieren, wählen Sie Bearbeiten.

  5. Nehmen Sie auf der Seite zum Bearbeiten der Konfiguration die gewünschten Änderungen vor und wählen Sie dann Änderungen speichern aus.

Anmerkung

Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauf folgenden Dienststartvorgang eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen, oder später mit einem Dienstupdate. Weitere Informationen finden Sie Einmalige Latenz 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.

Anmerkung

Wenn Sie einen VPC-Connector für ausgehenden Verkehr für einen Dienst erstellen, tritt beim darauf folgenden Startvorgang des Dienstes eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst festlegen, wenn Sie ihn erstellen, oder später mit einem Dienstupdate. Weitere Informationen finden Sie Einmalige Latenz im Kapitel Networking with App Runner in diesem Handbuch.