Webvorschauen für Pull-Requests - AWS Amplify Hosten
Webvorschauen aktivierenZugriff auf die Webvorschau mit Subdomains

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.

Webvorschauen für Pull-Requests

Webvorschauen bieten Teams für Entwicklung und Qualitätssicherung (QA) die Möglichkeit, eine Vorschau der Änderungen anhand von Pull Requests (PRs) anzuzeigen, bevor der Code in einen Produktions- oder Integrationszweig übertragen wird. Mithilfe von Pull-Requests können Sie andere über Änderungen informieren, die Sie an einen Branch in einem Repository übertragen haben. Nachdem ein Pull Request geöffnet wurde, kannst du die potenziellen Änderungen mit deinen Mitarbeitern besprechen und überprüfen und Folge-Commits hinzufügen, bevor deine Änderungen mit dem Basis-Branch zusammengeführt werden.

Bei einer Webvorschau wird jede Pull-Anfrage, die an dein Repository gestellt wird, an eine eindeutige Vorschau-URL gesendet, die sich völlig von der URL unterscheidet, die deine Hauptseite verwendet. Für Apps mit Backend-Umgebungen, die über die Amplify CLI oder Amplify Studio bereitgestellt werden, erstellt jede Pull-Anfrage (nur private Git-Repositorys) ein temporäres Backend, das gelöscht wird, wenn der PR geschlossen wird.

Wenn die Webvorschau für Ihre App aktiviert ist, wird jeder PR auf das Amplify-Kontingent von 50 Filialen pro App angerechnet. Um zu vermeiden, dass dieses Kontingent überschritten wird, stellen Sie sicher, dass Sie Ihre PRs schließen. Weitere Informationen zu Kontingenten finden Sie unter Amplify Kontingente für Hosting-Dienste.

Anmerkung

Derzeit ist die AWS_PULL_REQUEST_ID Umgebungsvariable nicht verfügbar, wenn Sie sie AWS CodeCommit als Repository-Anbieter verwenden.

Webvorschauen aktivieren

Für Apps, die in einem GitHub Repo gespeichert sind, verwenden Vorschauen die Amplify GitHub App für den Repo-Zugriff. Wenn Sie Webvorschauen in einer vorhandenen Amplify-App aktivieren, die Sie zuvor über ein GitHub Repository mit OAuth für den Zugriff bereitgestellt haben, müssen Sie zuerst die App migrieren, um die Amplify-App zu verwenden. GitHub Anweisungen zur Migration finden Sie unter. Migration einer vorhandenenOAuth App zur Amplify GitHub App

Wichtig

Aus Sicherheitsgründen können Sie Webvorschauen für alle Apps mit privaten Repositorys aktivieren, aber nicht für alle Apps mit öffentlichen Repositorys. Wenn Ihr Git-Repository öffentlich ist, können Sie Vorschauen nur für Apps einrichten, für die keine IAM-Servicerolle erforderlich ist.

Beispielsweise benötigen Apps mit Backends und Apps, die auf der WEB_COMPUTE Hosting-Plattform bereitgestellt werden, eine IAM-Servicerolle. Daher können Sie für diese Arten von Apps keine Webvorschauen aktivieren, wenn ihr Repository öffentlich ist.

Amplify erzwingt diese Einschränkung, um zu verhindern, dass Dritte beliebigen Code einreichen, der mit den IAM-Rollenberechtigungen Ihrer App ausgeführt werden würde.

Um Webvorschauen für Pull-Requests zu aktivieren

  1. Wählen Sie Hosting und dann Vorschauen aus.

    Anmerkung

    Vorschauen sind im Menü mit den App-Einstellungen nur sichtbar, wenn eine App für die kontinuierliche Bereitstellung eingerichtet und mit einem Git-Repository verbunden ist. Anweisungen zu dieser Art der Bereitstellung findest du unter Erste Schritte mit vorhandenem Code.

  2. Gehen Sie nur für GitHub Repositorys wie folgt vor, um die Amplify GitHub App in Ihrem Konto zu installieren und zu autorisieren:

    1. Wählen Sie im Fenster GitHub App installieren, um Vorschauen zu aktivieren die Option App installieren. GitHub

    2. Wählen Sie das GitHub Konto aus, in dem Sie die Amplify GitHub App konfigurieren möchten.

    3. Auf GitHub.com wird eine Seite geöffnet, auf der Sie die Repository-Berechtigungen für Ihr Konto konfigurieren können.

    4. Führen Sie eine der folgenden Aktionen aus:

      • Um die Installation auf alle Repositorys anzuwenden, wählen Sie Alle Repositorys.

      • Um die Installation auf die von Ihnen ausgewählten Repositorys zu beschränken, wählen Sie Nur ausgewählte Repositorys. Stellen Sie sicher, dass das Repo für die App, für die Sie Webvorschauen aktivieren, in die von Ihnen ausgewählten Repositorys aufgenommen wird.

    5. Wählen Sie Speichern.

  3. Nachdem Sie die Vorschauen für Ihr Repo aktiviert haben, kehren Sie zur Amplify-Konsole zurück, um Vorschauen für bestimmte Branches zu aktivieren. Wählen Sie auf der Vorschauseite einen Zweig aus der Liste aus und klicken Sie auf Einstellungen bearbeiten.

  4. Aktiviere auf der Seite „Vorschaueinstellungen verwalten“ die Option „Pull-Request-Vorschauen“. Wählen Sie dann Confirm (Bestätigen) aus.

  5. Führen Sie für Fullstack-Anwendungen einen der folgenden Schritte aus:

    • Wählen Sie „Neue Backend-Umgebung für jeden Pull-Request erstellen“. Mit dieser Option können Sie Änderungen testen, ohne die Produktion zu beeinträchtigen.

    • Wählen Sie Alle Pull-Requests für diesen Branch auf eine bestehende Umgebung verweisen aus.

  6. Wählen Sie Bestätigen aus.

Wenn Sie das nächste Mal eine Pull-Anfrage für die Filiale einreichen, erstellt Amplify Ihre PR und stellt sie auf einer Vorschau-URL bereit. Nachdem die Pull-Anfrage geschlossen wurde, wird die Vorschau-URL gelöscht und jede temporäre Backend-Umgebung, die mit der Pull-Anfrage verknüpft ist, wird gelöscht. Nur für GitHub Repositorys kannst du direkt über die Pull-Anfrage in deinem Konto auf eine Vorschau deiner GitHub URL zugreifen.

Zugriff auf die Webvorschau mit Subdomains

Webvorschauen für Pull-Requests sind über Subdomains für eine Amplify-App zugänglich, die mit einer von Amazon Route 53 verwalteten benutzerdefinierten Domain verbunden ist. Wenn der Pull-Request geschlossen wird, werden die mit dem Pull-Request verknüpften Branches und Subdomains automatisch gelöscht. Dies ist das Standardverhalten für Webvorschauen, nachdem Sie musterbasierte Feature-Branch-Bereitstellungen für Ihre App eingerichtet haben. Anweisungen zur Einrichtung automatischer Subdomains finden Sie unter. Automatische Subdomains für eine benutzerdefinierte Amazon Route 53-Domain einrichten