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:

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 können Sie bei der Auswahl des Basisimages oder der Komponenten für Ihr Rezept Platzhalter (x) verwenden, um 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:

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:

Ressourcen, die Versionsreferenzen zurückgeben

Versionsverweise werden von Create und Get APIs für alle versionierten Image Builder Builder-Ressourcen zurückgegeben:

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.