Erstellen Sie mit Git Sync einen Stack aus dem Repository-Quellcode

In diesem Thema wird erklärt, wie Sie mit Git Sync einen Stack erstellen, der mit AWS CloudFormation einem Git-Repository synchronisiert wird.

Wichtig

Bevor Sie fortfahren, müssen Sie alle im vorherigen Abschnitt genannten Voraussetzungen erfüllen.

Erstellen Sie einen Stack aus dem Quellcode des Repositorys

1. Melden Sie sich bei https://console.aws.amazon.com/cloudformation an AWS Management Console und öffnen Sie die AWS CloudFormation Konsole.

2. Wählen Sie in der Navigationsleiste oben auf dem Bildschirm die aus, in der der Stack erstellt werden AWS-Region soll.

3. Wählen Sie auf der Seite „Stapel“ die Option „Stapel erstellen“ und dann „Mit neuen Ressourcen (Standard)“ aus.

4. Gehen Sie auf der Seite Create stack (Stack erstellen) wie folgt vor:

   1. Wählen Sie unter Voraussetzung — Vorlage vorbereiten die Option Vorhandene Vorlage auswählen aus.

   2. Wählen Sie für Vorlage angeben die Option Sync from Git und dann Weiter aus.

5. Geben Sie auf der Seite „Stack-Details angeben“ unter Stack-Name einen Namen für Ihren Stack ein. Stack-Namen können Buchstaben (A–Z und a–z), Ziffern (0–9) und Bindestriche (-) enthalten.

6. Für die Stack-Bereitstellungsdatei, Erstellung der Bereitstellungsdatei:

   • Wenn Sie keine Stack-Deployment-Datei erstellt und zu Ihrem Repository hinzugefügt haben, wählen Sie Create the file using the following parameters und platzieren Sie sie in meinem Repository.

   • Wenn Sie eine Stack-Bereitstellungsdatei in Ihrem Repository haben, wählen Sie Ich stelle meine eigene Datei in meinem Repository bereit.

7. Wählen Sie für Repository mit Vorlagendefinitionen die Option Ein verknüpftes Git-Repository auswählen, um ein Git-Repository auszuwählen, mit dem bereits verknüpft ist CloudFormation, oder Ein Git-Repository verknüpfen, um ein neues zu verknüpfen. Wenn Sie Link a Git repository wählen, gehen Sie wie folgt vor:

   1. Wählen Sie unter Repository-Anbieter auswählen eine der folgenden Optionen aus:

      • GitHub

      • GitHub Unternehmensserver

      • GitLab

      • Bitbucket

      • GitLab selbst verwaltet

   2. Wählen Sie für Verbindung eine Verbindung aus der Liste aus. Wenn in der Verbindungsliste keine Optionen angezeigt werden, wählen Sie Neue Verbindung hinzufügen, um zur Verbindungskonsole zu wechseln und eine Verbindung zu Ihrem Repository herzustellen.

8. Wählen Sie in der Repository-Liste das Git-Repository aus, das Ihre Stack-Vorlagendatei enthält.

9. Wähle in der Liste Verzweigung die Verzweigung aus, die Git Sync überwachen soll.

   Anmerkung

   Git Sync überwacht nur den ausgewählten Branch auf Änderungen an den CloudFormation Vorlagen- und Stack-Bereitstellungsdateien. Alle Änderungen, die Sie auf Ihren Stack anwenden möchten, müssen für diese Verzweigung übernommen werden.

10. Geben Sie für den Pfad der Bereitstellungsdatei den vollständigen Pfad einschließlich des Namens der Stack-Bereitstellungsdatei aus dem Stammverzeichnis Ihrer Repository-Verzweigung an.

    Wenn die Datei für dich generiert CloudFormation wird, wird die Datei hier in deinem Repository festgeschrieben. Wenn Sie die Datei bereitstellen, ist dies der Speicherort der Datei in Ihrem Repository.

11. Fügen Sie eine IAMRolle hinzu. Die IAM Rolle beinhaltet Berechtigungen, die für CloudFormation die Synchronisierung des Stacks aus Ihrem Git-Repository erforderlich sind. Du kannst Neue IAM Rolle wählen, um eine neue Rolle zu generieren, oder Bestehende IAM Rolle wählen, um eine bestehende Rolle aus deiner auszuwählen AWS-Konto. Wenn Sie sich dafür entscheiden, eine neue Rolle zu generieren, sind die erforderlichen Berechtigungen in der Rolle enthalten.

12. Kommentare bei Pull-Requests aktivieren oder deaktivieren:

    • Um Informationen nach der Änderung in Pull-Requests für Stack-Updates festzulegen, lassen Sie den Schalter Kommentar bei Pull-Request aktivieren aktiviert. CloudFormation

    • Wenn Sie diesen Schalter ausschalten, CloudFormation werden die Unterschiede zwischen der aktuellen Stack-Konfiguration und den vorgeschlagenen Änderungen an Pull-Requests nicht beschrieben, wenn die Repo-Dateien aktualisiert werden.

13. Geben Sie für den Pfad der Vorlagendatei den vollständigen Pfad aus dem Stammverzeichnis Ihres Repositorys für die Stack-Vorlagendatei an.

14. (Optional) Um die Stack-Parameter anzugeben, wählen Sie Parameter hinzufügen, geben Sie einen Schlüssel und einen Wert für jeden Parameter ein und wählen Sie dann Weiter. Weitere Informationen finden Sie unter Stack-Bereitstellungsdatei.

    Gehen Sie beispielsweise wie folgt vor, um einen port=8080 Parameter in Ihrer Stack-Bereitstellungsdatei anzugeben:

    1. Wählen Sie Parameter hinzufügen aus.

    2. Geben Sie für Key (Schlüssel) port ein.

    3. Geben Sie für Wert 8080 ein.

15. (Optional) Um Stack-Tags anzugeben, wählen Sie Neues Tag hinzufügen aus, geben Sie einen Tag-Schlüssel und einen Tag-Wert für jedes Tag ein und wählen Sie dann Weiter. Weitere Informationen finden Sie unter Stack-Bereitstellungsdatei.

16. Wählen Sie Weiter, um mit der Konfiguration der Stack-Optionen fortzufahren. Informationen zum Konfigurieren von Stack-Optionen finden Sie unter Konfigurieren Sie die Stack-Optionen.

    Wenn Sie die Konfiguration abgeschlossen haben, wählen Sie Weiter, um mit der Überprüfung und Bereitstellung fortzufahren.

17. Überprüfen Sie Ihre Stack-Einstellungen und bestätigen Sie Folgendes:

    • Die Stack-Vorlage ist korrekt konfiguriert und auf Von Git synchronisieren gesetzt.

    • Die Bereitstellungsdatei ist korrekt konfiguriert.

    • Das Repository mit der Vorlagendefinition ist korrekt konfiguriert, insbesondere, das richtige Repository und der richtige Verzweigungsname wurden ausgewählt.

    • Die Vorschau der Bereitstellungsdatei ist korrekt und enthält die erwarteten Parameter und Werte.

18. Wählen Sie Absenden, um den Stack zu erstellen.

    Nachdem du Submit ausgewählt hast, wird automatisch eine Pull-Anfrage in deinem Git-Repository erstellt. Du musst diesen Pull-Request mit deinem Git-Repository zusammenführen, um deinen Stack zu erstellen. CloudFormation Überwacht dein Git-Repository nach der Erstellung des Stacks auf Änderungen.

Aktualisiere deinen Stack aus deinem Git-Repository

Um den Stack zu aktualisieren, nimm Änderungen direkt an deiner Vorlagendatei oder Stack-Bereitstellungsdatei in deinem Git-Repository vor. Nachdem Sie Ihre Änderungen in den überwachten Branch übernommen haben, CloudFormation wird der Stack automatisch aktualisiert. Wenn du Pull-Requests verwendest, wird automatisch eine Pull-Anfrage in deinem Git-Repository erstellt, bevor der Stack aktualisiert wird. Du musst diese Pull-Anfrage mit deinem Git-Repository zusammenführen, um deinen Stack zu aktualisieren.

In der CloudFormation Konsole kannst du den Stack auswählen und den Tab Git Sync wählen, um Informationen zum Status des Stacks und zu Synchronisierungsereignissen anzuzeigen. Weitere Informationen finden Sie unter Status-Dashboard für Git-Synchronisierung.