View a markdown version of this page

SupportInfo Structure XML - Amazon Linux 2023

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

SupportInfo Structure XML

Cette page décrit le schéma XML v1.0 utilisé pour définir les cycles de vie, les délais et les classifications de support des packages pour les distributions Linux. Le schéma est indépendant du DNF et n'est spécifique à aucune distribution. Vous pouvez le consommer directement depuis n'importe quel outil. Le dnf supportinfo plugin est l'un de ces consommateurs.

  • Définition du schéma (XSD) : https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd

  • Données de support (XML) : https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Pour analyser directement ce code XML, utilisez la amazon-linux-supportinfo bibliothèque open source, qui implémente le schéma décrit sur cette page, au lieu d'écrire un analyseur personnalisé.

Comment le plugin utilise ce fichier

À partir de ce fichier, le plugin indique :

  • Le niveau de support auquel se trouve un package (ces valeurs renseignent les options de --show filtre)

  • Quand les phases du cycle de vie changent (affiché dans la --pkg sortie et dans la chronologie)

  • Priorité des correctifs et couverture de gravité pour chaque niveau de support

  • D'où provient le colis (origine et classification)

Exemple minimal complet

Cet exemple montre la structure minimale avec toutes les sections requises et un package :

<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>

Référence de l'élément

package_support (élément racine)

L'élément racine qui contient toutes les métadonnées de support.

Attribut Obligatoire Description
schema_version Oui Version du format de schéma (actuellement1.0)
current_as Oui Horodatage ISO de la dernière génération des données de support
<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

L'current_ashorodatage apparaît en sortie pour indiquer la fraîcheur des données.

lifecycle

Définit une séquence de phases que traverse un package au fil du temps.

Attribut Obligatoire Description
name Oui Identifiant unique référencé par package@lifecycle
note Non Références a note@name pour plus de contexte
display_name Non Customer-facing étiquette
description Non Human-readable description
<lifecycle name="redis6_lc" note="eol_redis6" display_name="Redis 6 Lifecycle" description="Support lifecycle for Redis 6 packages"> <phase .../> </lifecycle>

Le plugin parcourt les phases dans l'ordre, trouve celle qui est actuellement active et indique le niveau de support de cette phase en sortie.

phase

Définit une étape d'un cycle de vie. Chaque phase se poursuit jusqu'au début de la phase suivante (ou indéfiniment s'il s'agit de la dernière phase).

Attribut Obligatoire Description
name Oui Identifiant de phase (unique au cours de son cycle de vie)
support_level Oui Références a support_level@name
start_date Conditionnel Date ISO fixe (YYYY-MM-DD). Utilisez-le ou start_milestone
start_milestone Conditionnel Références milestone@name a. Utilisez-le ou start_date
display_name Non Customer-facing étiquette
Note

Spécifiez exactement l'un des deux start_date ou start_milestone pas les deux.

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

Chaque phase est active depuis sa date de début jusqu'au début de la phase suivante. La dernière phase d'un cycle de vie reste active indéfiniment.

Étape importante

Définit un marqueur de date réutilisable auquel les phases du cycle de vie font référence.

Attribut Obligatoire Description
name Oui Identifiant unique référencé par phase@start_milestone
date Oui Date ISO (YYYY-MM-DD)
display_name Non Customer-facing étiquette
description Non Human-readable description
<milestone name="AL2023_GA" date="2023-03-15" display_name="AL2023 General Availability" description="Amazon Linux 2023 general availability date"/>

Les jalons permettent aux phases de partager des dates. Lorsqu'une date d'étape change, chaque phase qui y fait référence est automatiquement mise à jour.

niveau_support

Définit un niveau de support et les niveaux de gravité qu'il couvre. Chacune name devient une valeur de --show filtre valide.

Attribut Obligatoire Description
name Oui Identifiant unique. Utilisée comme valeur de --show filtre
severities Oui Comma-separated niveaux de gravité couverts (chaîne vide = aucun correctif)
description Oui Human-readable description affichée dans la --list-filters sortie
display_name Non Customer-facing étiquette
<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 répertorie tous les packages actuellement à ce niveau de support. La --list-filters commande affiche les valeurs name et de chaque niveaudescription.

package

Associe le nom d'un package RPM à son cycle de vie, à son origine et à sa classe.

Attribut Obligatoire Description
name Oui Nom du package RPM
lifecycle Oui Références a lifecycle@name
origin Oui Références a package_origin@name
package_class Non Références a package_class@name
<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
Note

Un package peut apparaître plusieurs fois avec des origin valeurs différentes (par exemple, le même package dans les dépôts core et SPAL). La combinaison de name + origin doit être unique.

Chaque RPM installé est comparé à cette liste pour déterminer son cycle de vie et son état de support actuel.

classe_de_package

Classe les packages en fonction de leur rôle dans le système. Le nom et le résumé de la classe apparaissent dans la sortie du plugin.

Attribute/Element Obligatoire Description
@name Oui Identifiant unique référencé par package@package_class
summary(enfant) Oui Brève description de la catégorie
text(enfant) Oui Description étendue. L'élément doit être présent mais peut être vide
<package_class name="os_dependency"> <summary>Packages supported only as dependencies of the operating system</summary> <text></text> </package_class>

Le nom de classe apparaît en sortie pour indiquer le rôle d'un package sur le système.

origine_du colis

Identifie la source du référentiel d'un package. La origin valeur apparaît en dnf supportinfo --pkg sortie.

Attribut Obligatoire Description
name Oui Identifiant unique référencé par package@origin
repo_id Oui ID du référentiel DNF
dist Oui Identifiant de distribution
vendor Oui Fournisseur de colis
signing_key Non Identifiant de clé de signature GPG
display_name Non Customer-facing étiquette
description Non Human-readable description
<package_origin name="al2023_core" repo_id="amazonlinux" dist="amzn2023" vendor="amazonlinux" display_name="Amazon Linux 2023 Core" description="Core Amazon Linux 2023 repository" />

Le champ « Origine » display_name apparaît en --pkg sortie.

note

Fournit un texte libre auquel un cycle de vie peut faire référence pour fournir un contexte supplémentaire.

Attribut Obligatoire Description
name Oui Identifiant unique référencé par lifecycle@note

Le contenu textuel de l'élément contient le message de note.

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

Lorsque le cycle de vie d'un package fait référence à une note, le texte de la note apparaît sous la forme « Note du package » dans la --pkg sortie.

Intégrité référentielle

Le schéma relie les éléments entre eux par le biais de name références. Chaque attribut source doit correspondre à celui name d'un élément cible existant :

Attribut source Références
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

De plus, la combinaison de package@name et package@origin doit être unique pour tous les package éléments.