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.

So funktioniert Git Sync mit CloudFormation

In diesem Thema wird beschrieben, wie Git Sync funktioniert, und es werden die wichtigsten Konzepte vorgestellt, die für die Arbeit mit Git erforderlich sind.

So funktioniert Git Sync

Um Git Sync zu verwenden, müssen Sie zunächst einen Git-Anbieter CloudFormation mit der Nutzung des CodeConnectionsDienstes verbinden. In den Verfahren in diesem Handbuch wird die Verbindung über die CodeConnections Konsole hergestellt. Alternativ können Sie die Verbindung mit dem herstellen AWS CLI. Sie können einen der folgenden Git-Anbieter verwenden:

Als Nächstes erstellen Sie eine CloudFormation Vorlage, die Ihren Stack definiert, und fügen ihn Ihrem Repository hinzu. Diese Vorlagendatei wird überwacht. CloudFormation aktualisiert den Stack automatisch, wenn Änderungen daran vorgenommen werden.

In der CloudFormation Konsole erstellst du einen neuen Stack und wählst Sync from Git, um anzugeben, dass CloudFormation du Git Sync verwenden möchtest. Sie geben das Repository und den Branch an, den Sie überwachen CloudFormation möchten, und geben die CloudFormation Vorlage in Ihrem Repository an, die den Stack definiert.

Während der Konfiguration können Sie entweder Ihre eigene Stack-Bereitstellungsdatei aus Ihrem Repository bereitstellen oder Git Sync eine für Sie generieren lassen. Die Stack-Bereitstellungsdatei enthält Parameter und Werte, die die Ressourcen in Ihrem Stack konfigurieren. Diese Stack-Bereitstellungsdatei wird überwacht. CloudFormation aktualisiert den Stack automatisch, wenn Änderungen daran vorgenommen werden.

Git Sync erstellt eine Pull-Anfrage in deinem Repository, um deinen Stack mit der CloudFormation Vorlagendatei und der Stack-Deployment-Datei zu synchronisieren. Wenn Git Sync die Stack-Bereitstellungsdatei für Sie generiert, wird sie von Git Sync an Ihr Repository gesendet.

Anschließend fügst du die Pull-Anfrage mit deinem Repository zusammen, sodass CloudFormation der Stack bereitgestellt, mit deinen Bereitstellungsparametern konfiguriert wird und dein Repository auf Änderungen überwacht wird.

Ab diesem Zeitpunkt werden die Änderungen automatisch erkannt, wann immer Sie Änderungen an Ihrer Vorlagendatei oder Stack-Bereitstellungsdatei vornehmen und diese in Ihr Repository übernehmen. CloudFormation Wenn dein Team Pull-Requests verwendet, können deine Teammitglieder die Änderungen überprüfen und genehmigen, bevor sie bereitgestellt werden. Sobald die Pull-Anfrage akzeptiert wurde, CloudFormation werden Ihre Änderungen bereitgestellt.

Du kannst den Status deiner Git-Sync-Konfiguration für den Stack überwachen und dir in der CloudFormation Konsole eine Historie der auf den Stack angewendeten Commits ansehen. Die Konsole bietet auch Tools zur Neukonfiguration der Git-Synchronisierung und zur Behebung von Problemen.

Kommentare zu Pull-Anforderungen

Du kannst festlegen, dass eine Zusammenfassung der Codeänderungen in Pull-Requests über den CodeConnections Service CloudFormation erstellt wird, indem du in der Konsole die Option Kommentar bei Pull-Requests aktivieren aktivierst. Durch die Bereitstellung einer Zusammenfassung der Änderungen in Pull Requests können Teammitglieder die Auswirkungen der vorgeschlagenen Änderungen leicht überprüfen und verstehen, bevor sie den Pull Request zusammenführen. Weitere Informationen finden Sie unter Ermöglicht CloudFormation das Posten einer Zusammenfassung der Stack-Änderungen in Pull-Requests.

Stack-Bereitstellungsdatei

Eine Stack-Bereitstellungsdatei ist eine JavaScript Object Notation (JSON) oder eine Datei im YAML Standardformat, die Parameter und Werte zur Verwaltung Ihres CloudFormation Stacks enthält. Sie wird auf Änderungen überwacht. Wenn Änderungen an der Datei in das Repository übernommen werden, wird der zugehörige Stack automatisch aktualisiert.

Die Stack-Bereitstellungsdatei enthält ein Schlüssel-Wert-Paar und zwei Wörterbücher:

Sie können Ihre eigene Stack-Bereitstellungsdatei bereitstellen oder Git Sync eine für Sie erstellen lassen und automatisch eine Pull-Anforderung an Ihr Repository senden. Sie können die Parameter und Tags verwalten, indem Sie die Stack-Bereitstellungsdatei bearbeiten und die Änderungen an das Repository übergeben.

Im Folgenden finden Sie ein Beispiel einer Git-Sync-Stack-Bereitstellungsdatei:

template-file-path: ./fargate-srvc/my-stack-template.yaml

parameters: 
    image: public.ecr.aws/lts/nginx:latest
    task_size: x-small
    max_capacity: 5
    port: 8080
    env: production
tags:
    cost-center: '123456'
    org: 'AWS'

CloudFormation Vorlagendatei

Eine Vorlagendatei enthält eine Deklaration der AWS Ressourcen, aus denen ein CloudFormation Stapel besteht. Mit Git Sync wird die Vorlagendatei in Ihrem Git-Repository gespeichert und von der Stack-Bereitstellungsdatei referenziert. Sie können den Stack verwalten, indem Sie die Vorlagendatei bearbeiten und Änderungen an das Repository übertragen.

Weitere Informationen finden Sie unter Mit CloudFormation Vorlagen arbeiten.

Vorlagendefinitions-Repository

Das Template-Definition-Repository ist das Git-Repository, mit dem CloudFormation über Git Sync verknüpft ist. Das Repository wird auf Änderungen an der CloudFormation Vorlagen- und Stack-Bereitstellungsdatei überwacht. Wenn Sie Änderungen an der Datei vornehmen, wird der zugehörige Stack automatisch aktualisiert.