Bereitstellung einer neuen Anwendungsversion in App Runner - 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.

Bereitstellung einer neuen Anwendungsversion in App Runner

Wenn Sie einen Dienst erstellen in AWS App Runner, konfigurieren Sie eine Anwendungsquelle — ein Container-Image oder ein Quell-Repository. App Runner stellt Ressourcen für die Ausführung Ihres Dienstes bereit und stellt Ihre Anwendung für sie bereit.

In diesem Thema werden Möglichkeiten beschrieben, wie Sie Ihre Anwendungsquelle erneut für Ihren App Runner-Dienst bereitstellen können, wenn eine neue Version verfügbar ist. Dies kann eine neue Image-Version im Image-Repository oder ein neuer Commit im Code-Repository sein. App Runner bietet zwei Methoden für die Bereitstellung in einem Dienst: automatisch und manuell.

Bereitstellungsmethoden

App Runner bietet die folgenden Methoden, mit denen Sie steuern können, wie Anwendungsbereitstellungen initiiert werden.

Automatische Bereitstellung

Verwenden Sie die automatische Bereitstellung, wenn Sie ein kontinuierliches Integrations- und Bereitstellungsverhalten (CI/CD) für Ihren Service wünschen. App Runner überwacht Ihr Image- oder Code-Repository auf Änderungen.

Image-Repository — Immer wenn Sie eine neue Image-Version in Ihr Image-Repository oder einen neuen Commit in Ihr Code-Repository übertragen, stellt App Runner diese automatisch in Ihrem Dienst bereit, ohne dass Sie weitere Maßnahmen ergreifen müssen.

Code-Repository — Immer wenn Sie einen neuen Commit in Ihr Code-Repository übertragen, der Änderungen im Quellverzeichnis vornimmt, stellt App Runner Ihr gesamtes Repository bereit. Da nur Änderungen im Quellverzeichnis eine automatische Bereitstellung auslösen, ist es wichtig zu verstehen, wie sich der Speicherort des Quellverzeichnisses auf den Umfang einer automatisierten Bereitstellung auswirkt.

  • Verzeichnis der obersten Ebene (Repository-Stammverzeichnis) — Dies ist der Standardwert, der für das Quellverzeichnis festgelegt wird, wenn Sie einen Service erstellen. Wenn Ihr Quellverzeichnis auf diesen Wert gesetzt ist, bedeutet dies, dass sich das gesamte Repository im Quellverzeichnis befindet. In diesem Fall lösen also alle Commits, die Sie in das Quell-Repository übertragen, ein Deployment aus.

  • Jeder Verzeichnispfad, der nicht das Repository-Stammverzeichnis ist (kein Standard) — Da nur Änderungen, die innerhalb des Quellverzeichnisses übertragen werden, ein automatisches Deployment auslösen, lösen alle Änderungen, die an Ihr Repository übertragen werden und sich nicht im Quellverzeichnis befinden, kein automatisches Deployment aus. Daher müssen Sie eine manuelle Bereitstellung verwenden, um Änderungen bereitzustellen, die Sie außerhalb des Quellverzeichnisses übertragen.

Anmerkung

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

Manuelle Bereitstellung

Verwenden Sie die manuelle Bereitstellung, wenn Sie jede Bereitstellung für Ihren Service explizit initiieren möchten. Sie initiieren eine Bereitstellung, wenn das Repository, das Sie für Ihren Service konfiguriert haben, über eine neue Version verfügt, die Sie bereitstellen möchten. Weitere Informationen finden Sie unter Manuelle Bereitstellung.

Anmerkung

Wenn Sie eine manuelle Bereitstellung ausführen, stellt App Runner die Quelle aus dem vollständigen Repository bereit.

Sie können die Bereitstellungsmethode für Ihren Service auf folgende Weise konfigurieren:

  • Konsole — Wählen Sie für einen neuen Dienst, den Sie erstellen, oder für einen vorhandenen Dienst auf der Konfigurationsseite für Quelle und Bereitstellung im Abschnitt Bereitstellungseinstellungen die Option Manuell oder Automatisch aus.

    Konfiguration der App Runner-Bereitstellungsmethode
  • APIoder AWS CLI— Legen Sie in einem Aufruf der UpdateServiceAktion CreateServiceoder das AutoDeploymentsEnabled Element des SourceConfigurationParameters auf „Manuelles Deployment“ oder True „Automatisches Deployment“ fest. False

Vergleich von automatischen und manuellen Bereitstellungen

Sowohl automatische als auch manuelle Bereitstellungen führen zu demselben Ergebnis: Beide Methoden stellen das gesamte Repository bereit.

Der Unterschied zwischen den beiden Methoden ist der Auslösemechanismus:

  • Manuelle Bereitstellungen werden durch eine Bereitstellung von der Konsole aus ausgelöst, einen Aufruf an AWS CLI, oder ein Anruf beim App RunnerAPI. Im folgenden Manuelle Bereitstellung Abschnitt werden die Verfahren für diese Verfahren beschrieben.

  • Automatische Bereitstellungen werden durch eine Änderung im Inhalt des Quellverzeichnisses ausgelöst.

Manuelle Bereitstellung

Bei der manuellen Bereitstellung müssen Sie jede Bereitstellung für Ihren Service explizit initiieren. Wenn Sie eine neue Version Ihres Anwendungs-Images oder -Codes zur Bereitstellung bereit haben, können Sie in den folgenden Abschnitten nachlesen, wie Sie eine Bereitstellung mit der Konsole und dem durchführenAPI.

Anmerkung

Wenn Sie eine manuelle Bereitstellung ausführen, stellt App Runner den Quellcode aus dem vollständigen Repository bereit.

Stellen Sie eine Version Ihrer Anwendung mit einer der folgenden Methoden bereit:

App Runner console
Um die Bereitstellung mit der App Runner-Konsole durchzuführen
  1. Öffnen Sie die App Runner-Konsole und wählen Sie in der Liste der Regionen Ihre 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 Aktivitätsliste
  3. Wählen Sie Bereitstellen.

    Ergebnis: Die Bereitstellung der neuen Version beginnt. Auf der Service-Dashboard-Seite ändert sich der Dienststatus in Betrieb.

  4. Warten Sie, bis die Bereitstellung beendet ist. Auf der Service-Dashboard-Seite sollte sich der Dienststatus wieder in Wird ausgeführt ändern.

  5. Um zu überprüfen, ob die Bereitstellung erfolgreich ist, wählen Sie auf der Service-Dashboard-Seite den Wert Standarddomain aus — das ist URL die Website Ihres Dienstes. Untersuchen Sie Ihre Webanwendung oder interagieren Sie mit ihr und überprüfen Sie Ihre Versionsänderung.

    Anmerkung

    Um die Sicherheit Ihrer App Runner-Anwendungen zu erhöhen, ist die Domain*.awsapprunner.com in der Liste der öffentlichen Suffixe () registriert. PSL Aus Sicherheitsgründen empfehlen wir Ihnen, Cookies mit einem __Host- Präfix zu verwenden, falls Sie jemals sensible Cookies im Standard-Domainnamen für Ihre App Runner-Anwendungen einrichten müssen. Diese Vorgehensweise hilft Ihnen dabei, Ihre Domain vor Cross-Site-Request-Forgery-Versuchen zu schützen ()CSRF. Weitere Informationen finden Sie auf der Set-Cookie-Seite im Mozilla Developer Network.

App Runner API or AWS CLI

Zur Bereitstellung mit dem App Runner oder API AWS CLI, rufe die StartDeploymentAPIAktion auf. Der einzige Parameter, der übergeben werden muss, ist Ihr ServiceARN. Sie haben den Quellpfad Ihrer Anwendung bereits konfiguriert, als Sie den Dienst erstellt haben, und App Runner kann die neue Version finden. Ihre Bereitstellung beginnt, wenn der Anruf eine erfolgreiche Antwort zurückgibt.