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. Dies umfasst die Bereitstellung der relevanten 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 Select a source code location type (Quellcode-Speicherorttyp auswählen) die Option ECR oder Repository aus.

   Wenn Sie ECR wählen, 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.

Bereitstellen von ECR

1. Wählen Sie für Select or enter an image repository (Image-Repository auswählen oder eingeben) die URL des Image-Repositorys aus, das von Ihrer privaten Amazon-ECR-Registrierung oder der Amazon ECR Public Gallery verwaltet wird, oder geben Sie sie ein.

   Anmerkung

   Wenn Sie ein Repository aus der Amazon ECR Public Gallery angeben, stellen Sie sicher, dass automatische Bereitstellungen deaktiviert sind, da App Runner keine automatischen Bereitstellungen für ein Image in einem öffentlichen ECR-Repository 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 private Amazon ECR-Registrierung verwenden, benötigen Sie die ECR-Zugriffsrolle ECR, AppRunner die App Runner den Zugriff auf Amazon Elastic Container Registry (Amazon ECR) -Images in Ihrem Konto ermöglicht. AccessRole Wählen Sie das „+“ -Symbol in der Kopfzeile der Befehlspalette, um diese Rolle automatisch zu erstellen. (Eine Zugriffsrolle ist nicht erforderlich, wenn Ihr Image in Amazon ECR Public gespeichert wird, wo Images ö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 für Select instance configuration (Instance-Konfiguration auswählen) eine Kombination aus CPU-Einheiten und Arbeitsspeicher 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 Copy Service URL (Service-URL kopieren).

9. Fügen Sie für den Zugriff auf die bereitgestellte Anwendung die kopierte URL in die Adressleiste Ihres Webbrowsers ein.

Bereitstellen von einem Remote-Repository

1. Wählen Sie unter Verbindung auswählen eine Verbindung aus, GitHub zu der eine Verknüpfung besteht AWS. Die Verbindungen, die zur Auswahl stehen, sind auf der GitHub Verbindungsseite der App Runner-Konsole aufgeführt.

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

   Remote-Repositorys, die bereits mit dem Source Control Management (SCM) von Visual Studio Code konfiguriert sind, 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 für Select instance configuration (Instance-Konfiguration auswählen) eine Kombination aus CPU-Einheiten und Arbeitsspeicher 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).

9. Nachdem Ihr Service gestartet wurde, klicken Sie mit der rechten Maustaste darauf und wählen Sie Copy Service URL (Service-URL kopieren).

10. Fügen Sie für den Zugriff auf die bereitgestellte Anwendung die kopierte 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.