Einen App Runner-Dienst erstellen

AWS App Runner automatisiert den Übergang von einem Container-Image oder einem Quellcode-Repository zu einem laufenden Webservice, der automatisch skaliert wird. Sie verweisen App Runner auf Ihr Quellbild oder Ihren Quellcode und geben dabei nur eine kleine Anzahl erforderlicher Einstellungen an. App Runner erstellt Ihre Anwendung bei Bedarf, stellt Rechenressourcen bereit und stellt Ihre Anwendung so bereit, dass sie darauf ausgeführt wird.

Wenn Sie einen Dienst erstellen, erstellt App Runner eine Dienstressource. In einigen Fällen müssen Sie möglicherweise eine Verbindungsressource bereitstellen. Wenn Sie die App Runner-Konsole verwenden, erstellt die Konsole implizit die Verbindungsressource. Weitere Informationen zu App Runner-Ressourcentypen finden Sie unterApp Runner-Ressourcen. Diese Ressourcentypen haben Kontingente, die jeweils Ihrem Konto zugeordnet sind AWS-Region. Weitere Informationen finden Sie unter App Runner-Ressourcenkontingente.

Das Verfahren zur Erstellung eines Dienstes unterscheidet sich je nach Quelltyp und Anbieter geringfügig. In diesem Thema werden verschiedene Verfahren zum Erstellen dieser Quelltypen behandelt, sodass Sie das für Ihre Situation geeignete Verfahren anwenden können. Informationen zum Starten einer grundlegenden Prozedur mit einem Codebeispiel finden Sie unterErste Schritte mit App Runner.

Voraussetzungen

Bevor Sie Ihren App Runner-Dienst erstellen, stellen Sie sicher, dass Sie die folgenden Aktionen ausführen:

• Führen Sie die Einrichtungsschritte unter ausEinrichtung für App Runner.

• Stellen Sie sicher, dass Ihre Anwendungsquelle bereit ist. Sie können entweder ein Code-Repository in GitHubBitbucket oder ein Container-Image in Amazon Elastic Container Registry (Amazon ECR) verwenden, um einen App Runner-Service zu erstellen.

Einen Service erstellen

In diesem Abschnitt wird der Erstellungsprozess für die beiden App Runner-Servicetypen beschrieben: basierend auf Quellcode und basierend auf einem Container-Image.

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.

Erstellen Sie einen Dienst aus einem Code-Repository

In den folgenden Abschnitten wird gezeigt, wie Sie einen App Runner-Dienst erstellen, wenn Ihre Quelle ein Code-Repository in GitHuboder Bitbucket ist. Wenn du ein Code-Repository verwendest, muss App Runner eine Verbindung zur Anbieterorganisation oder zum Konto herstellen. Daher müssen Sie beim Aufbau dieser Verbindung helfen. Weitere Informationen zu App Runner-Verbindungen finden Sie unterApp Runner-Verbindungen verwalten.

Wenn Sie den Dienst erstellen, erstellt App Runner ein Docker-Image, das Ihren Anwendungscode und Ihre Abhängigkeiten enthält. Anschließend wird ein Dienst gestartet, der eine Container-Instance dieses Images ausführt.

Einen Dienst mithilfe der App Runner-Konsole aus Code erstellen

Um einen App Runner-Dienst mit der Konsole zu erstellen

1. Konfigurieren Sie Ihren Quellcode.

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

   2. Wenn für noch AWS-Konto keine App Runner-Dienste verfügbar sind, wird die Startseite der Konsole angezeigt. Wählen Sie App Runner-Dienst erstellen aus.

      

      Wenn es AWS-Konto bereits Dienste gibt, wird die Seite Dienste mit einer Liste Ihrer Dienste angezeigt. Wählen Sie Create service.

      

   3. Wählen Sie auf der Seite Quelle und Bereitstellung im Abschnitt Quelle für Repository-Typ die Option Quellcode-Repository aus.

   4. Wählen Sie einen Anbietertyp aus. Wähle entweder GitHuboder Bitbucket.

   5. Wähle als Nächstes ein Konto oder eine Organisation für den Anbieter aus, den du zuvor verwendet hast, oder wähle Neu hinzufügen. Gehen Sie dann durch den Prozess, bei dem Sie Ihre Code-Repository-Anmeldeinformationen angeben und ein Konto oder eine Organisation auswählen, mit der Sie sich verbinden möchten.

   6. Wählen Sie für Repository das Repository aus, das Ihren Anwendungscode enthält.

   7. Wählen Sie für Branch den Branch aus, den Sie bereitstellen möchten.

   8. Geben Sie unter Quellverzeichnis das Verzeichnis im Quell-Repository ein, in dem Ihr Anwendungscode und Ihre Konfigurationsdateien gespeichert sind.

      Anmerkung

      Die Befehle build und start werden in dem von Ihnen angegebenen Quellverzeichnis ausgeführt. App Runner behandelt den Pfad ab Root als absoluten Pfad. Wenn Sie hier keinen Wert angeben, verwendet das Verzeichnis standardmäßig das Stammverzeichnis des Repositorys.

2. Konfigurieren Sie Ihre Bereitstellungen.

   1. Wählen Sie im Abschnitt Bereitstellungseinstellungen die Option Manuell oder Automatisch aus.

      Weitere Informationen zu Bereitstellungsmethoden finden Sie unterBereitstellungsmethoden.

   2. Wählen Sie Weiter aus.

   

3. Konfigurieren Sie den Anwendungsbuild.

   1. Wählen Sie auf der Seite „Build konfigurieren“ unter Konfigurationsdatei die Option Alle Einstellungen hier konfigurieren aus, wenn Ihr Repository keine App Runner-Konfigurationsdatei enthält, oder wählen Sie in diesem Fall eine Konfigurationsdatei verwenden aus.

      Anmerkung

      Eine App Runner-Konfigurationsdatei ist eine Möglichkeit, Ihre Build-Konfiguration als Teil Ihrer Anwendungsquelle beizubehalten. Wenn Sie eine angeben, liest App Runner einige Werte aus der Datei und lässt Sie sie nicht in der Konsole festlegen.

   2. Geben Sie die folgenden Build-Einstellungen an:

      • Laufzeit — Wählen Sie eine bestimmte verwaltete Laufzeit für Ihre Anwendung aus.

      • Befehl erstellen — Geben Sie einen Befehl ein, der Ihre Anwendung aus dem Quellcode erstellt. Dabei kann es sich um ein sprachspezifisches Tool oder ein mit Ihrem Code bereitgestelltes Skript handeln.

      • Startbefehl — Geben Sie den Befehl ein, mit dem Ihr Webservice gestartet wird.

      • Port — Geben Sie den IP-Port ein, den Ihr Webservice abhört.

   3. Wählen Sie Weiter aus.

   

4. Konfigurieren Sie Ihren Dienst.

   1. Geben Sie auf der Seite Dienst konfigurieren im Abschnitt Diensteinstellungen einen Dienstnamen ein.

      Anmerkung

      Alle anderen Diensteinstellungen sind entweder optional oder haben von der Konsole bereitgestellte Standardwerte.

   2. Sie können optional weitere Einstellungen ändern oder hinzufügen, um Ihre Anwendungsanforderungen zu erfüllen.

   3. Wählen Sie Weiter aus.

   

5. Überprüfen Sie auf der Seite Überprüfen und erstellen alle von Ihnen eingegebenen Details und wählen Sie dann Erstellen und bereitstellen aus.

   Ergebnis: Wenn der Service erfolgreich erstellt wurde, zeigt die Konsole das Service-Dashboard mit einer Serviceübersicht über den neuen Service an.

   

6. Stellen Sie sicher, dass Ihr Dienst ausgeführt wird.

   1. Warten Sie auf der Service-Dashboard-Seite, bis der Dienststatus Running lautet.

   2. Wählen Sie den Standarddomänenwert. Es ist die URL zur Website Ihres Dienstes.

   3. Verwenden Sie Ihre Website und stellen Sie sicher, dass sie ordnungsgemäß funktioniert.

Einen Dienst aus Code mithilfe der App Runner API erstellen oder AWS CLI

Um einen Dienst mit der App Runner API oder zu erstellen AWS CLI, rufen Sie die CreateService API-Aktion auf. Weitere Informationen und ein Beispiel finden Sie unter CreateService. Wenn du zum ersten Mal einen Service mit einer bestimmten Organisation oder einem Konto für ein Quellcode-Repository (GitHub oder Bitbucket) erstellst, rufe CreateConnectionzunächst an. Dadurch wird eine Verbindung zwischen App Runner und der Organisation oder dem Konto des Repository-Anbieters hergestellt. Weitere Informationen zu App Runner-Verbindungen finden Sie unterApp Runner-Verbindungen verwalten.

Wenn der Aufruf eine erfolgreiche Antwort zurückgibt und ein Service-Objekt angezeigt wird"Status": "CREATING", beginnt Ihr Service mit der Erstellung.

Ein Beispiel für einen Aufruf finden Sie unter Erstellen eines Quellcode-Repository-Service in der AWS App Runner API-Referenz

Einen Service aus einem Amazon ECR-Image erstellen

In den folgenden Abschnitten wird gezeigt, wie Sie einen App Runner-Service erstellen, wenn Ihre Quelle ein in Amazon ECR gespeichertes Container-Image ist. Amazon ECR ist ein AWS-Service. Um einen Service auf der Grundlage eines Amazon ECR-Images zu erstellen, stellen Sie App Runner daher eine Zugriffsrolle mit den erforderlichen Amazon ECR-Aktionsberechtigungen zur Verfügung.

Anmerkung

In Amazon ECR Public gespeicherte Bilder sind öffentlich verfügbar. Wenn Ihr Bild also in Amazon ECR Public gespeichert ist, ist keine Zugriffsrolle erforderlich.

Wenn Ihr Service erstellt wird, startet App Runner einen Service, der eine Container-Instance des von Ihnen bereitgestellten Images ausführt. In diesem Fall gibt es keine Erstellungsphase.

Weitere Informationen finden Sie unter App Runner-Dienst, der auf einem Quellbild basiert.

Mit der App Runner-Konsole einen Dienst aus einem Image erstellen

Um einen App Runner-Dienst mit der Konsole zu erstellen

1. Konfigurieren Sie Ihren Quellcode.

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

   2. Wenn für noch AWS-Konto keine App Runner-Dienste verfügbar sind, wird die Startseite der Konsole angezeigt. Wählen Sie App Runner-Dienst erstellen aus.

      

      Wenn es AWS-Konto bereits Dienste gibt, wird die Seite Dienste mit einer Liste Ihrer Dienste angezeigt. Wählen Sie Create service.

      

   3. Wählen Sie auf der Seite Quelle und Bereitstellung im Abschnitt Quelle für Repository-Typ die Option Container-Registrierung aus.

   4. Wählen Sie unter Anbieter den Anbieter aus, bei dem Ihr Image gespeichert ist:

      • Amazon ECR — Ein privates Bild, das in Amazon ECR gespeichert ist.

      • Amazon ECR Public — Ein öffentlich lesbares Bild, das in Amazon ECR Public gespeichert ist.

   5. Wählen Sie für Container-Image-URI die Option Browse aus.

   6. Wählen Sie im Dialogfeld Amazon ECR-Container-Image auswählen für Image-Repository das Repository aus, das Ihr Image enthält.

   7. Wählen Sie unter Image-Tag das spezifische Image-Tag aus, das Sie bereitstellen möchten (z. B. das neueste), und wählen Sie dann Weiter.

   

2. Konfigurieren Sie Ihre Bereitstellungen.

   1. Wählen Sie im Abschnitt Bereitstellungseinstellungen die Option Manuell oder Automatisch aus.

      Anmerkung

      App Runner unterstützt keine automatische Bereitstellung für öffentliche Amazon ECR-Images und für Bilder in einem Amazon ECR-Repository, das zu einem anderen AWS Konto gehört als dem, in dem sich Ihr Service befindet.

      Weitere Informationen zu Bereitstellungsmethoden finden Sie unter. Bereitstellungsmethoden

   2. [Amazon ECR-Anbieter] Wählen Sie für die ECR-Zugriffsrolle eine bestehende Servicerolle in Ihrem Konto aus oder erstellen Sie eine neue Rolle. Wenn Sie die manuelle Bereitstellung verwenden, können Sie sich auch dafür entscheiden, die IAM-Benutzerrolle zum Zeitpunkt der Bereitstellung zu verwenden.

   3. Wählen Sie Weiter aus.

   

3. Konfigurieren Sie Ihren Dienst.

   1. Geben Sie auf der Seite Dienst konfigurieren im Abschnitt Diensteinstellungen einen Dienstnamen und den IP-Port ein, den Ihre Service-Website abhört.

      Anmerkung

      Alle anderen Diensteinstellungen sind entweder optional oder haben von der Konsole bereitgestellte Standardeinstellungen.

   2. (Optional) Ändern oder fügen Sie weitere Einstellungen hinzu, um sie an die Anforderungen Ihrer Anwendung anzupassen.

   3. Wählen Sie Weiter aus.

   

4. Überprüfen Sie auf der Seite Überprüfen und erstellen alle von Ihnen eingegebenen Details und wählen Sie dann Erstellen und bereitstellen aus.

   Ergebnis: Wenn der Service erfolgreich erstellt wurde, zeigt die Konsole das Service-Dashboard mit einer Serviceübersicht über den neuen Service an.

   

5. Stellen Sie sicher, dass Ihr Dienst ausgeführt wird.

   1. Warten Sie auf der Service-Dashboard-Seite, bis der Dienststatus Running lautet.

   2. Wählen Sie den Standarddomänenwert. Es ist die URL zur Website Ihres Dienstes.

   3. Verwenden Sie Ihre Website und stellen Sie sicher, dass sie ordnungsgemäß funktioniert.

Mit der App Runner API einen Dienst aus einem Image erstellen oder AWS CLI

Um einen Dienst mit der App Runner API oder zu erstellen AWS CLI, rufen Sie die CreateServiceAPI-Aktion auf.

Ihre Diensterstellung beginnt, wenn der Aufruf eine erfolgreiche Antwort zurückgibt und ein Service-Objekt angezeigt wird"Status": "CREATING".

Ein Beispiel für einen Aufruf finden Sie unter Create a source image repository service in der AWS App Runner API-Referenz