Erstellen von App-Runner-Services

Sie können einen App Runner-Dienst in Toolkit for VS Code erstellen, indem Sie den AWS Explorer und die Befehlspalette von VS Code verwenden. Nachdem Sie sich entschieden haben, einen Dienst in einer bestimmten AWS Region zu erstellen, führen Sie die nummerierten Schritte in der Befehlspalette durch den Prozess der Konfiguration der Dienstinstanz, auf der Ihre Anwendung ausgeführt wird.

Stellen Sie vor dem Erstellen eines App-Runner-Services sicher, dass Sie die Voraussetzungen erfüllen. Dazu gehören die Bereitstellung der entsprechenden IAM Berechtigungen und die Bestätigung des spezifischen Quell-Repositorys, das Sie bereitstellen möchten.

So erstellen Sie einen App-Runner-Service

1. Öffnen Sie den AWS Explorer, falls er nicht bereits geöffnet ist.

2. Klicken Sie mit der rechten Maustaste auf den Knoten App Runner und wählen Sie Create Service (Service erstellen) aus.

   Die Befehlspalette wird angezeigt.

3. Wählen Sie für Wählen Sie einen Quellcode-Speicherortyp die Option ECRoder Repository.

   Wenn Sie möchten ECR, geben Sie ein Container-Image in einem Repository an, das von Amazon Elastic Container Registry verwaltet wird. Wenn Sie Repository wählen, geben Sie ein Quellcode-Repository an, das von einem unterstützten Repository-Anbieter verwaltet wird. Derzeit wird App Runner GitHubals Quellcode-Repository-Anbieter unterstützt.

Bereitstellung von ECR

1. Wählen Sie für Wählen Sie ein Bild-Repository aus oder geben Sie das Bild-Repository ein, das URL von Ihrer ECR privaten Amazon-Registrierung oder der Amazon ECR Public Gallery verwaltet wird, oder geben Sie es ein.

   Anmerkung

   Wenn Sie ein Repository aus der Amazon ECR Public Gallery angeben, stellen Sie sicher, dass automatische Bereitstellungen deaktiviert sind, da App Runner automatische Bereitstellungen für ein Image in einem ECR öffentlichen Repository nicht unterstützt.

   Automatische Bereitstellungen sind standardmäßig ausgeschaltet. Dies wird angezeigt, wenn das Symbol in der Kopfzeile der Befehlspalette von einer diagonalen Linie durchzogen ist. Wenn Sie sich für das Einschalten automatischer Bereitstellungen entschieden haben, werden Sie in einer Meldung darüber informiert, dass diese Option zusätzliche Kosten verursachen kann.

2. Wenn im Schritt „Befehlspalette“ die Meldung Keine Tags gefunden angezeigt wird, müssen Sie einen Schritt zurückgehen und ein Repository auswählen, das ein mit Tags versehenes Container-Image enthält.

3. Wenn Sie eine ECR private Amazon-Registrierung verwenden, benötigen Sie die ECR Zugriffsrolle AppRunnerECRAccessRole, die App Runner den Zugriff auf Amazon Elastic Container Registry (AmazonECR) -Images in Ihrem Konto ermöglicht. Wählen Sie das „+“ -Symbol in der Kopfzeile der Befehlspalette, um diese Rolle automatisch zu erstellen. (Eine Zugriffsrolle ist nicht erforderlich, wenn Ihr Bild in Amazon ECR Public gespeichert ist, wo Bilder öffentlich verfügbar sind.)

4. Geben Sie für Port den IP-Port ein, der vom Service verwendet wird (z. B. Port 8000).

5. Für Configure environment variables (Umgebungsvariablen konfigurieren) können Sie eine Datei angeben, die Umgebungsvariablen enthält, die zum Anpassen des Verhaltens in Ihrer Service-Instance verwendet werden. Oder Sie können diesen Schritt überspringen.

6. Geben Sie für Name your service (Ihren Service benennen) einen eindeutigen Namen ohne Leerzeichen ein und drücken Sie Enter (Eingabe).

7. Wählen Sie unter „Instance-Konfiguration auswählen“ eine Kombination aus CPU Einheiten und Speicher in GB für Ihre Service-Instance aus.

   Wenn Ihr Service erstellt wird, ändert sich sein Status von Creating (Wird erstellt) in Running (Wird ausgeführt).

8. Nachdem Ihr Service gestartet wurde, klicken Sie mit der rechten Maustaste darauf und wählen Sie „Dienst kopieren URL“.

9. Um auf Ihre bereitgestellte Anwendung zuzugreifen, fügen Sie die kopierte Datei URL in die Adressleiste Ihres Webbrowsers ein.

Bereitstellen von einem Remote-Repository

1. Wählen Sie unter Verbindung auswählen eine Verbindung aus, die einen GitHub Link enthält AWS. Die Verbindungen, die zur Auswahl stehen, sind auf der GitHub Verbindungsseite der App Runner-Konsole aufgeführt.

2. Wählen Sie für Wählen Sie ein GitHub Remote-Repository aus, oder geben Sie einen URL für das Remote-Repository ein.

   Remote-Repositorys, die bereits mit der Quellcodeverwaltung von Visual Studio Code konfiguriert sind (SCM), stehen zur Auswahl. Sie können auch einen Link zum Repository einfügen, wenn er nicht aufgeführt ist.

3. Wählen Sie für Select a branch (Eine Verzweigung auswählen), welche Git-Verzweigung Ihres Quellcodes Sie bereitstellen möchten.

4. Geben Sie für Choose configuration source (Konfigurationsquelle auswählen) an, wie Sie die Laufzeitkonfiguration definieren möchten.

   Wenn Sie Use configuration file (Konfigurationsdatei verwenden) angeben, wird Ihre Service-Instance durch Einstellungen konfiguriert, die durch die apprunner.yaml-Konfigurationsdatei definiert sind. Diese Datei befindet sich im Stammverzeichnis des Repositorys Ihrer Anwendung.

   Wenn Sie Alle Einstellungen hier konfigurieren wählen, verwenden Sie die Befehlspalette, um Folgendes anzugeben:

   • Runtime (Laufzeit): Wählen Sie Python 3 oder Nodejs 12 aus.

   • Build command (Entwicklungsbefehl): Geben Sie den Befehl ein, um Ihre Anwendung in der Laufzeitumgebung Ihrer Service-Instance zu erstellen.

   • Start command (Startbefehl): Geben Sie den Befehl ein, um Ihre Anwendung in der Laufzeitumgebung Ihrer Service-Instance zu starten.

5. Geben Sie für Port den IP-Port ein, der vom Service verwendet wird (z. B. Port 8000).

6. Für Configure environment variables (Umgebungsvariablen konfigurieren) können Sie eine Datei angeben, die Umgebungsvariablen enthält, die zum Anpassen des Verhaltens in Ihrer Service-Instance verwendet werden. Oder Sie können diesen Schritt überspringen.

7. Geben Sie für Name your service (Ihren Service benennen) einen eindeutigen Namen ohne Leerzeichen ein und drücken Sie Enter (Eingabe).

8. Wählen Sie unter „Instanzkonfiguration auswählen“ eine Kombination aus CPU Einheiten und Arbeitsspeicher in GB für Ihre Dienstinstanz aus.

   Wenn Ihr Service erstellt wird, ändert sich sein Status von Creating (Wird erstellt) in Running (Wird ausgeführt).

9. Nachdem Ihr Service gestartet wurde, klicken Sie mit der rechten Maustaste darauf und wählen Sie „Dienst kopieren URL“.

10. Um auf Ihre bereitgestellte Anwendung zuzugreifen, fügen Sie die kopierte Datei URL in die Adressleiste Ihres Webbrowsers ein.

Anmerkung

Wenn Ihr Versuch zum Erstellen eines App-Runner-Service fehlschlägt, zeigt der Service im AWS -Explorer den Status Create failed (Erstellen fehlgeschlagen) an. Tipps zur Fehlerbehebung finden Sie unter Wenn die Service-Erstellung fehlschlägt im Entwicklerhandbuch zu App Runner.