Konfigurationen für die Vorlagensynchronisierung - AWS Proton

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.

Konfigurationen für die Vorlagensynchronisierung

Erfahre, wie du ein Template so konfigurierst, dass es aus Template-Bundles AWS Proton synchronisiert werden kann, die sich in registrierten Git-Repositorys befinden, die du definierst. Wenn ein Commit in dein Repository gepusht wird, AWS Proton überprüft es, ob Änderungen an deinen Repository-Vorlagenpaketen vorgenommen wurden. Wenn es eine Änderung des Template-Bundles feststellt, wird eine neue Neben- oder Hauptversion seines Templates erstellt, sofern die Version noch nicht existiert. AWS Proton unterstützt GitHub derzeit GitHub Enterprise und BitBucket.

Einen Commit an ein synchronisiertes Template-Bundle weiterleiten

Wenn du einen Commit in einen Branch überträgst, der von einer deiner Vorlagen verfolgt wird, wird dein Repository AWS Proton geklont und bestimmt, welche Vorlagen synchronisiert werden müssen. Es durchsucht die Dateien in deinem Verzeichnis nach Verzeichnissen, die der Konvention von {template-name}/{major-version}/ entsprechen.

Nachdem AWS Proton festgestellt wurde, welche Vorlagen und Hauptversionen mit Ihrem Repository und Branch verknüpft sind, versucht es, all diese Vorlagen parallel zu synchronisieren.

Bei jeder Synchronisierung mit einer bestimmten Vorlage wird AWS Proton zunächst geprüft, ob sich der Inhalt des Vorlagenverzeichnisses seit der letzten erfolgreichen Synchronisierung geändert hat. Wenn sich der Inhalt nicht geändert hat, wird die Registrierung eines doppelten Bundles AWS Proton übersprungen. Dadurch wird sichergestellt, dass eine neue Nebenversion der Vorlage erstellt wird, wenn sich der Inhalt des Vorlagenpakets ändert. Wenn sich der Inhalt des Vorlagenpakets geändert hat, wird das Bundle bei registriert AWS Proton.

AWS Proton Überwacht nach der Registrierung des Vorlagenpakets den Registrierungsstatus, bis die Registrierung abgeschlossen ist.

Es kann jeweils nur eine Synchronisierung mit einer bestimmten Neben- und Hauptversion der Vorlage erfolgen. Alle Commits, die während einer laufenden Synchronisierung möglicherweise per Push übertragen wurden, werden gebündelt. Die gebündelten Commits werden synchronisiert, nachdem der vorherige Synchronisierungsversuch abgeschlossen ist.

Dienstvorlagen werden synchronisiert

AWS Proton kann sowohl Umgebungs- als auch Dienstvorlagen aus Ihrem Git-Repository synchronisieren. Um Ihre Service-Vorlagen zu synchronisieren, fügen Sie jedem Hauptversionsverzeichnis in Ihrem Vorlagenpaket eine zusätzliche Datei mit dem Namen .template-registration.yaml hinzu. Diese Datei enthält zusätzliche Informationen, die Sie AWS Proton benötigen, wenn sie nach einem Commit eine Service-Vorlagenversion für Sie erstellt: kompatible Umgebungen und unterstützte Komponentenquellen.

Der vollständige Pfad der Datei lautetservice-template-name/major-version/.template-registration.yaml. Weitere Informationen finden Sie unter Synchronisieren von Dienstvorlagen.

Überlegungen zur Konfiguration der Vorlagensynchronisierung

Lesen Sie die folgenden Überlegungen zur Verwendung von Vorlagensynchronisierungskonfigurationen.

  • Repositorys dürfen nicht größer als 250 MB sein.

  • Um die Vorlagensynchronisierung zu konfigurieren, verknüpfen Sie zunächst das Repository mit AWS Proton. Weitere Informationen finden Sie unter Erstelle einen Link zu deinem Repository.

  • Wenn aus einer synchronisierten Vorlage eine neue Vorlagenversion erstellt wird, befindet sie sich im DRAFT Status.

  • Eine neue Nebenversion einer Vorlage wird erstellt, wenn eine der folgenden Bedingungen zutrifft:

    • Der Inhalt des Vorlagenpakets unterscheidet sich von denen der letzten synchronisierten Vorlagennebenversion.

    • Die letzte zuvor synchronisierte Nebenversion der Vorlage wurde gelöscht.

  • Die Synchronisierung kann nicht angehalten werden.

  • Sowohl neue Neben- als auch Hauptversionen werden automatisch synchronisiert.

  • Neue Vorlagen der obersten Ebene können nicht durch Konfigurationen zur Vorlagensynchronisierung erstellt werden.

  • Mit einer Konfiguration zur Vorlagensynchronisierung können Sie nicht mit einer Vorlage aus mehreren Repositorys synchronisieren.

  • Sie können keine Tags anstelle von Branches verwenden.

  • Wenn Sie eine Dienstvorlage erstellen, geben Sie kompatible Umgebungsvorlagen an.

  • Sie können eine Umgebungsvorlage erstellen und sie als kompatible Umgebung für Ihre Dienstvorlage im selben Commit hinzufügen.

  • Synchronisierungen mit einer einzigen Hauptversion der Vorlage werden nacheinander ausgeführt. Wenn während einer Synchronisierung neue Commits erkannt werden, werden sie gebündelt und am Ende der aktiven Synchronisierung angewendet. Synchronisierungen mit verschiedenen Hauptversionen von Vorlagen erfolgen parallel.

  • Wenn Sie den Zweig ändern, aus dem Ihre Vorlagen synchronisiert werden, werden alle laufenden Synchronisierungen aus dem alten Zweig zuerst abgeschlossen. Dann beginnt die Synchronisierung mit dem neuen Zweig.

  • Wenn Sie das Repository ändern, von dem aus Ihre Vorlagen synchronisiert werden, schlagen alle laufenden Synchronisierungen aus dem alten Repository möglicherweise fehl oder werden vollständig ausgeführt. Das hängt davon ab, in welcher Phase der Synchronisierung sie sich befinden.

Weitere Informationen finden Sie in der Referenz zur AWS Proton Service-API.