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 die Git-Synchronisierung mit CloudFormation

Dieses Thema beschreibt die Funktionsweise von Git sync und stellt die wichtigsten Konzepte vor, die für die Arbeit mit Git sync erforderlich sind.

So funktioniert die Git-Synchronisierung

Um die Git-Synchronisierung zu verwenden, müssen Sie zunächst einen Git-Anbieter mit CloudFormation verbinden, indem Sie den Dienst CodeConnections verwenden. In den Verfahren dieses Handbuchs wird die Verbindung über die CodeConnections-Konsole erstellt. Alternativ können Sie die Verbindung auch mit dem AWS CLIerstellen. Sie können einen der folgenden Git-Anbieter verwenden:

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

In der CloudFormation-Konsole erstellen Sie einen neuen Stack und wählen Sync from Git um CloudFormation anzuweisen, die Git-Synchronisierung zu verwenden. Sie geben das Repository und die Verzweigung an, ddas/die CloudFormation überwachen soll, 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-Anforderung in Ihrem Repository, um Ihren Stack mit der CloudFormation-Vorlagendatei und der Stack-Bereitstellungsdatei zu synchronisieren. Wenn Git Sync die Stack-Bereitstellungsdatei für Sie generiert, wird sie von Git Sync an Ihr Repository gesendet.

Anschließend führen Sie die Pull-Anfrage mit Ihrem Repository zusammen, so dass CloudFormation den Stack bereitstellt, ihn mit Ihren Bereitstellungsparametern konfiguriert und Ihr Repository auf Änderungen überwacht.

Von da an erkennt CloudFormation die Änderungen automatisch, wenn Sie Änderungen an Ihrer Vorlagendatei oder Stack-Bereitstellungsdatei vornehmen und diese in Ihr Repository übertragen. Wenn Ihr Team Pull Requests verwendet, können Ihre Teammitglieder die Änderungen überprüfen und genehmigen, bevor sie bereitgestellt werden. Sobald die Pull-Anfrage akzeptiert wurde, stellt CloudFormation Ihre Änderungen bereit.

Sie können den Status Ihrer Git-Synchronisierungskonfiguration für den Stack überwachen und eine Historie der auf den Stack angewendeten Commits in der CloudFormation-Konsole sehen. Die Konsole bietet auch Tools zur Neukonfiguration der Git-Synchronisierung und zur Behebung von Problemen.

Kommentare zu Pull-Anforderungen

Sie können festlegen, dass CloudFormation über den CodeConnections-Dienst eine Zusammenfassung der Codeänderungen in Pull Requests erstellt, indem Sie in der Konsole die Option Enable comment on pull request aktivieren. Die Bereitstellung einer Zusammenfassung der Änderungen in Pull Requests bedeutet, dass die Teammitglieder die Auswirkungen der vorgeschlagenen Änderungen leicht überprüfen und verstehen können, bevor sie den Pull Request zusammenführen. Weitere Informationen finden Sie unter Aktivieren Sie CloudFormation, um eine Zusammenfassung der Stack-Änderungen in Pull Requests zu veröffentlichen..

Stack-Bereitstellungsdatei

Eine Stack-Bereitstellungsdatei ist eine JavaScript-Objekt-Notation (JSON)- oder YAML-Standarddatei, die Parameter und Werte enthält, die Ihren CloudFormation-Stack verwalten. 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 Vorlage ist eine Deklaration der AWS-Ressourcen, die einen Cloud-Formation-Stack bilden. 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 Vorlagendefinition-Repository ist das Git-Repository, das über Git Sync mit CloudFormation verknüpft ist. Das Repository wird auf Änderungen an der CloudFormation-Vorlage und der Stack-Bereitstellungsdatei überwacht. Wenn Sie Änderungen an der Datei vornehmen, wird der zugehörige Stack automatisch aktualisiert.