Einen App Runner-Dienst konfigurieren - AWS App Runner

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, 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.

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.

  • 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 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 CreateServiceAktion verfügbar sind, nicht ändern. Sie können nicht geändert werden, nachdem sie erstellt wurden. Die UpdateServiceAktion beinhaltet diese Parameter nicht.

    • API oder Datei — Sie können den ConfigurationSource Parameter des CodeConfigurationTyps (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 diese Option festlegen ConfigurationSourceAPI, ruft App Runner alle Konfigurationseinstellungen aus dem API-Aufruf ab und ignoriert die Konfigurationsdatei, auch wenn eine vorhanden ist.

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

  • UntagResourceaction — 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 Dienststart eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst bei der Erstellung oder später mit einem Service-Update festlegen. Weitere Informationen finden Sie Einmalige Latenz 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 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 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.

    In der Konsole wird das Service-Dashboard mit einer Serviceübersicht angezeigt.

    App Runner Service-Dashboard-Seite mit einer Aktivitätsliste
  3. 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.

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

  5. 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 Dienststart eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst bei der Erstellung oder später mit einem Service-Update festlegen. 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 darauffolgenden Dienststart eine einmalige Latenz auf. Sie können diese Konfiguration für einen neuen Dienst bei der Erstellung oder später mit einem Service-Update festlegen. Weitere Informationen finden Sie Einmalige Latenz im Kapitel Networking with App Runner in diesem Handbuch.