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.
Semantische Versionierung in Image Builder
Image Builder verwendet semantische Versionierung, um Ressourcen zu organisieren und sicherzustellen, dass sie eindeutig sind. IDs Die semantische Version hat vier Knoten:
<major>. <minor>. <patch>/<build>
Sie können Werte für die ersten drei zuweisen und nach allen filtern.
Semantische Versionierung ist im Amazon-Ressourcennamen (ARN) jedes Objekts enthalten, und zwar auf der Ebene, die für dieses Objekt gilt, wie folgt:
-
Versionless ARNs und Name ARNs enthalten in keinem der Knoten spezifische Werte. Die Knoten werden entweder komplett weggelassen oder als Platzhalter angegeben, zum Beispiel: x.x.x.
-
<major>Version ARNs hat nur die ersten drei Knoten:. <minor>. <patch>
-
Build-Versionen ARNs haben alle vier Knoten und verweisen auf einen bestimmten Build für eine bestimmte Version eines Objekts.
Zuweisung: Den ersten drei Knoten können Sie einen beliebigen positiven Ganzzahlwert oder Null mit einer Obergrenze von 2^30-1 oder 1073741823 für jeden Knoten zuweisen. Image Builder weist die Build-Nummer automatisch dem vierten Knoten zu.
Muster: Sie können jedes numerische Muster verwenden, das den Zuweisungsanforderungen für die Knoten entspricht, die Sie zuweisen können. Sie können beispielsweise ein Muster für die Softwareversion wie 1.0.0 oder ein Datum wie 2021.01.01 wählen.
Auswahl: Bei der semantischen Versionierung haben Sie die Flexibilität, Platzhalter (x) zu verwenden, um bei der Auswahl des Basisimages oder der Komponenten für Ihr Rezept die neuesten Versionen oder Knoten anzugeben. Wenn Sie in einem Knoten einen Platzhalter verwenden, müssen alle Knoten rechts vom ersten Platzhalter ebenfalls Platzhalter sein.
Beispiel: Bei den folgenden aktuellen Versionen: 2.2.4, 1.7.8 und 1.6.8 führt die Versionsauswahl mithilfe von Platzhaltern zu den folgenden Ergebnissen:
-
x.x.x= 2.2.4 -
1.x.x= 1,7.8 -
1.6.x= 1,6.8 -
x.2.xist nicht gültig und erzeugt einen Fehler -
1.x.8ist nicht gültig und erzeugt einen Fehler
Versionierung mit Platzhaltern in Lebenszyklusrichtlinien
Sie können Platzhaltermuster für semantische Versionen bei der Rezeptauswahl für Lebenszyklusrichtlinien verwenden, um mehrere Versionen eines Rezepts mit einer einzigen Richtlinie als Ziel zu verwenden. Dies vereinfacht das Lebenszyklusmanagement, da es nicht mehr erforderlich ist, separate Richtlinien für jede Rezeptversion zu erstellen.
Die folgenden Platzhaltermuster werden für Rezeptversionen von Lebenszyklus-Richtlinien unterstützt:
-
x.x.x— Entspricht allen Versionen des Rezepts. -
1.x.x— Entspricht allen Neben- und Patch-Versionen innerhalb der Hauptversion 1. -
1.0.x— Entspricht allen Patch-Versionen in Version 1.0.
Wenn eine Lebenszyklusrichtlinie mit Platzhaltermustern ausgeführt wird, löst Image Builder die Platzhalter zur Ausführungszeit in alle passenden Rezeptversionen auf. Dadurch wird eine unveränderliche Liste von Versionen für diese Ausführung erstellt. Neue Rezeptversionen, die nach Beginn der Richtlinienausführung erstellt wurden, werden automatisch in die nächste geplante Ausführung aufgenommen.
Weitere Informationen zum Erstellen von Lebenszyklusrichtlinien mit Platzhalter-Versionierung finden Sie unter. Lebenszyklusrichtlinien erstellen
Verwenden von Versionsreferenzen
Versionsverweise sind ready-to-use ARN-Zeichenfolgen, die Platzhaltermuster enthalten, die auf der semantischen Version der Ressource basieren, die Sie erstellt oder abgerufen haben. Anstatt benutzerdefinierten Code zum Analysieren ARNs und Einfügen von Platzhaltern zu schreiben, erledigt Image Builder diese Arbeit für Sie.
Wenn Sie Image Builder-Ressourcen erstellen oder abrufen, stellt Image Builder automatisch ARNs mit Platzhaltern vorkonstruierte Versionsmuster im latestVersionReferences Objekt bereit. Dadurch entfällt die Notwendigkeit, Ressourcen manuell zu analysieren und zu rekonstruieren, ARNs wenn Sie mithilfe von Platzhalter-Versionsmustern auf Ressourcen verweisen möchten.
Wenn Sie beispielsweise eine Komponente mit Version erstellen1.2.3, gibt Image Builder Folgendes zurück:
{ "componentBuildVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3/1", "latestVersionReferences": { "latestVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/x.x.x", "latestMajorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.x.x", "latestMinorVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.x", "latestPatchVersionArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.2.3" } }
Verfügbare Versionsreferenzmuster
Das latestVersionReferences Objekt enthält vier ARN-Muster:
-
latestVersionArn (x.x.x) — Löst immer auf die absolut neueste Version auf.
-
atestMajorVersionArn (1.x.x) — Löst die Auflösung auf die neuesten Neben- und Patch-Versionen innerhalb einer Hauptversion.
-
latestMinorVersionArn (1.2.x) — Stellt die neueste Patch-Version innerhalb einer bestimmten Nebenversion bereit.
-
latestPatchVersionArn (1.2.3) — Verweist auf eine bestimmte semantische Version und löst für Ressourcen, die mehrere Build-Versionen unterstützen, auf die neueste Build-Version auf.
Ressourcen, die Versionsreferenzen zurückgeben
Versionsverweise werden von Create und Get APIs für alle versionierten Image Builder Builder-Ressourcen zurückgegeben:
-
Komponenten -
CreateComponent,GetComponent -
Bildrezepte -
CreateImageRecipe,GetImageRecipe -
Rezepte für Behälter -
CreateContainerRecipe,GetContainerRecipe -
Bilder -
CreateImage,GetImage -
Arbeitsabläufe -
CreateWorkflow,GetWorkflow
Hinweis: Für von Image Builder verwaltete Workflows latestVersionArn (x.x.x) wird nur zurückgegeben, da Image Builder verlangt, dass Sie immer die neueste Version der von Image Builder verwalteten Workflows verwenden.