View a markdown version of this page

SupportInfo XML-Struktur - Amazon Linux 2023
Wie verwendet das Plugin diese DateiVollständiges MinimalbeispielReferenz auf das ElementReferenzielle Integrität

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.

SupportInfo XML-Struktur

Diese Seite dokumentiert das XML-Schema der Version 1.0, das zur Definition von Lebenszyklen, Zeitplänen und Klassifizierungen für die Paketunterstützung für Linux-Distributionen verwendet wird. Das Schema ist unabhängig von DNF und nicht spezifisch für eine einzelne Distribution. Sie können es direkt von jedem Tool aus verwenden. Das dnf supportinfo Plugin ist ein solcher Verbraucher.

  • Schemadefinition (XSD): https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd

  • Unterstützungsdaten (XML): https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Um dieses XML direkt zu analysieren, verwenden Sie die amazon-linux-supportinfo Open-Source-Bibliothek, die das auf dieser Seite beschriebene Schema implementiert, anstatt einen benutzerdefinierten Parser zu schreiben.

Wie verwendet das Plugin diese Datei

Aus dieser Datei meldet das Plugin:

  • Auf welcher Unterstützungsstufe sich ein Paket befindet (diese Werte füllen die --show Filteroptionen aus)

  • Wenn sich die Phasen des Lebenszyklus ändern (wird in der --pkg Ausgabe und in der Zeitleiste angezeigt)

  • Patch-Priorität und Schweregrad werden für jede Supportstufe abgedeckt

  • Woher das Paket stammt (Herkunft und Klassifizierung)

Vollständiges Minimalbeispiel

Dieses Beispiel zeigt die Mindeststruktur mit allen erforderlichen Abschnitten und einem Paket:

<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">
  <lifecycles>
    <lifecycle name="default_lc"
               display_name="AL2023 Standard Lifecycle"
               description="Standard support lifecycle for Amazon Linux 2023 packages">
      <phase name="full_support"
             support_level="default"
             start_milestone="AL2023_GA"
             display_name="Full Support"/>
      <phase name="end_of_support"
             support_level="eos"
             start_milestone="AL2023_EOS"
             display_name="End of Support"/>
    </lifecycle>
  </lifecycles>

  <support_milestones>
    <milestone name="AL2023_GA" date="2023-03-15"
               display_name="AL2023 General Availability"
               description="Amazon Linux 2023 general availability date"/>
    <milestone name="AL2023_EOS" date="2029-06-30"
               display_name="AL2023 End of Support"
               description="End of all support for Amazon Linux 2023"/>
  </support_milestones>

  <support_levels>
    <support_level name="default"
                   severities="Low,Medium,Important,Critical"
                   description="Full security and bug fix support for all severities"
                   display_name="Default Support" />
    <support_level name="eos"
                   severities=""
                   description="End of support - no further updates"
                   display_name="End of Support" />
  </support_levels>

  <packages>
    <package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
  </packages>

  <package_classes>
    <package_class name="default">
      <summary>Default class for Amazon Linux packages</summary>
      <text></text>
    </package_class>
  </package_classes>

  <package_origins>
    <package_origin name="al2023_core"
                    repo_id="amazonlinux"
                    dist="amzn2023"
                    vendor="amazonlinux"
                    display_name="Amazon Linux 2023 Core"
                    description="Core Amazon Linux 2023 repository" />
  </package_origins>

  <notes>
    <note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>
  </notes>
</package_support>

Referenz auf das Element

package_support (Stammelement)

Das Stammelement, das alle Support-Metadaten enthält.

Attribut Erforderlich Beschreibung
schema_version Ja Version des Schemaformats (derzeit1.0)
current_as Ja ISO-Zeitstempel, an dem die Unterstützungsdaten zuletzt generiert wurden 
<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

Der current_as Zeitstempel erscheint in der Ausgabe, um die Aktualität der Daten anzuzeigen.

lifecycle

Definiert eine Abfolge von Phasen, die ein Paket im Laufe der Zeit durchläuft.

Attribut Erforderlich Beschreibung
name Ja Eindeutige Kennung, auf die verwiesen wird package@lifecycle
note Nein Referenzen a note@name für zusätzlichen Kontext
display_name Nein Customer-facing Etikett
description Nein Human-readable Beschreibung 
<lifecycle name="redis6_lc" note="eol_redis6"
           display_name="Redis 6 Lifecycle"
           description="Support lifecycle for Redis 6 packages">
  <phase .../>
</lifecycle>

Das Plugin durchläuft die Phasen der Reihe nach, findet die aktuell aktive Phase und meldet die Unterstützungsstufe dieser Phase in der Ausgabe.

phase

Definiert eine Phase innerhalb eines Lebenszyklus. Jede Phase wird fortgesetzt, bis die nächste Phase beginnt (oder auf unbestimmte Zeit, wenn es sich um die letzte Phase handelt).

Attribut Erforderlich Beschreibung
name Ja Phasenkennung (innerhalb ihres Lebenszyklus eindeutig)
support_level Ja Referenzen a support_level@name
start_date Bedingt Festes ISO-Datum (YYYY-MM-DD). Benutze das oder start_milestone
start_milestone Bedingt Referenzen milestone@name a. Benutze das oder start_date
display_name Nein Customer-facing Etikett
Anmerkung

Geben Sie genau eines von start_date oder anstart_milestone, nicht beide.

<phase name="limited_support"
       support_level="limited"
       start_milestone="AL2023_6months"
       display_name="Limited Support"/>

Jede Phase ist von ihrem Startdatum bis zum Beginn der nächsten Phase aktiv. Die letzte Phase eines Lebenszyklus bleibt auf unbestimmte Zeit aktiv.

Meilenstein

Definiert eine wiederverwendbare Datumsmarkierung, auf die die Lebenszyklusphasen verweisen.

Attribut Erforderlich Beschreibung
name Ja Eindeutige Kennung, auf die verwiesen wird phase@start_milestone
date Ja ISO-Datum (YYYY-MM-DD)
display_name Nein Customer-facing Etikett
description Nein Human-readable Beschreibung 
<milestone name="AL2023_GA" date="2023-03-15"
           display_name="AL2023 General Availability"
           description="Amazon Linux 2023 general availability date"/>

Meilensteine ermöglichen es Phasen, Termine zu teilen. Wenn sich ein Meilensteindatum ändert, wird jede Phase, die darauf verweist, automatisch aktualisiert.

support_level

Definiert eine Support-Stufe und den Schweregrad, den sie abdeckt. Jeder name wird zu einem gültigen --show Filterwert.

Attribut Erforderlich Beschreibung
name Ja Eindeutiger Bezeichner. Wird als --show Filterwert verwendet
severities Ja Comma-separated Abgedeckte Schweregrade (leere Zeichenfolge = keine Patches)
description Ja Human-readable Beschreibung wird in der --list-filters Ausgabe angezeigt
display_name Nein Customer-facing Etikett 
<support_level name="limited"
               severities="Important,Critical"
               description="Security fixes for Important and Critical severities only"
               display_name="Limited Support" />

Running dnf supportinfo --show limited listet alle Pakete auf, die sich derzeit auf dieser Unterstützungsstufe befinden. Der --list-filters Befehl zeigt das name und für jede Ebene andescription.

package

Ordnet den Namen eines RPM-Pakets seinem Lebenszyklus, seinem Ursprung und seiner Klasse zu.

Attribut Erforderlich Beschreibung
name Ja Name des RPM-Pakets
lifecycle Ja Referenzen a lifecycle@name
origin Ja Referenzen a package_origin@name
package_class Nein Referenzen a package_class@name 
<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
Anmerkung

Ein Paket kann mehrfach mit unterschiedlichen origin Werten vorkommen (z. B. dasselbe Paket in Core- und SPAL-Repos). Die Kombination von name + origin muss eindeutig sein.

Jedes installierte RPM wird anhand dieser Liste abgeglichen, um seinen Lebenszyklus und den aktuellen Support-Status zu ermitteln.

Paketklasse

Kategorisiert Pakete nach ihrer Rolle im System. Der Klassenname und die Zusammenfassung werden in der Plugin-Ausgabe angezeigt.

Attribute/Element Erforderlich Beschreibung
@name Ja Eindeutige Kennung, auf die verwiesen wird package@package_class
summary(Kind) Ja Kurze Beschreibung der Kategorie
text(Kind) Ja Erweiterte Beschreibung. Das Element muss vorhanden sein, kann aber leer sein 
<package_class name="os_dependency">
  <summary>Packages supported only as dependencies of the operating system</summary>
  <text></text>
</package_class>

Der Klassenname erscheint in der Ausgabe, um die Rolle eines Pakets auf dem System anzuzeigen.

Paket_Ursprung

Identifiziert die Repository-Quelle eines Pakets. Der origin Wert wird in der dnf supportinfo --pkg Ausgabe angezeigt.

Attribut Erforderlich Beschreibung
name Ja Eindeutige Kennung, auf die verwiesen wird package@origin
repo_id Ja DNF-Repository-ID
dist Ja Verteilungs-ID
vendor Ja Anbieter des Pakets
signing_key Nein Kennung des GPG-Signaturschlüssels
display_name Nein Customer-facing Etikett
description Nein Human-readable Beschreibung 
<package_origin name="al2023_core"
                repo_id="amazonlinux"
                dist="amzn2023"
                vendor="amazonlinux"
                display_name="Amazon Linux 2023 Core"
                description="Core Amazon Linux 2023 repository" />

Das display_name wird in der --pkg Ausgabe als Feld „Herkunft“ angezeigt.

note

Stellt Freiformtext bereit, auf den ein Lebenszyklus verweisen kann, um zusätzlichen Kontext zu erhalten.

Attribut Erforderlich Beschreibung
name Ja Eindeutige Kennung, auf die verwiesen wird lifecycle@note

Der Textinhalt des Elements enthält die Notiznachricht.

<note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>

Wenn der Lebenszyklus eines Pakets auf eine Notiz verweist, erscheint der Notiztext in der --pkg Ausgabe als „Paketnotiz“.

Referenzielle Integrität

Das Schema verbindet Elemente durch name Verweise miteinander. Jedes Quellattribut muss mit dem name eines vorhandenen Zielelements übereinstimmen:

Quellattribut Referenzen
package@lifecycle lifecycle@name
package@origin package_origin@name
package@package_class package_class@name
phase@support_level support_level@name
phase@start_milestone milestone@name
lifecycle@note note@name

Darüber hinaus package@origin muss die Kombination von package@name und für alle package Elemente eindeutig sein.