View a markdown version of this page

SupportInfo Struttura XML - Amazon Linux 2023

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

SupportInfo Struttura XML

Questa pagina documenta lo schema XML v1.0 utilizzato per definire i cicli di vita, le tempistiche e le classificazioni del supporto dei pacchetti per le distribuzioni Linux. Lo schema è indipendente da DNF e non è specifico per una singola distribuzione. Puoi consumarlo direttamente da qualsiasi strumento. Il dnf supportinfo plugin è uno di questi consumatori.

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

  • Dati di supporto (XML): https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Per analizzare direttamente questo XML, utilizzate la amazon-linux-supportinfo libreria open source, che implementa lo schema descritto in questa pagina, invece di scrivere un parser personalizzato.

In che modo il plugin utilizza questo file

Da questo file, il plugin riporta:

  • A che livello di supporto si trova un pacchetto (questi valori popolano le opzioni di --show filtro)

  • Quando le fasi del ciclo di vita cambiano (visualizzate nell'--pkgoutput e nella timeline)

  • Copertura della priorità e della gravità delle patch per ogni livello di supporto

  • Da dove proviene il pacco (origine e classificazione)

Esempio minimo completo

Questo esempio mostra la struttura minima con tutte le sezioni obbligatorie e un pacchetto:

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

Riferimento all'elemento

package_support (elemento principale)

L'elemento principale che contiene tutti i metadati di supporto.

Attributo Richiesto Descrizione
schema_version Versione del formato dello schema (attualmente) 1.0
current_as Timestamp ISO dell'ultima generazione dei dati di supporto
<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

Il current_as timestamp appare nell'output per indicare la freschezza dei dati.

ciclo di vita

Definisce una sequenza di fasi che un pacchetto attraversa nel tempo.

Attributo Richiesto Descrizione
name Identificatore univoco a cui fa riferimento package@lifecycle
note No Fa riferimento a note@name per un contesto aggiuntivo
display_name No Customer-facing etichetta
description No Human-readable descrizione
<lifecycle name="redis6_lc" note="eol_redis6" display_name="Redis 6 Lifecycle" description="Support lifecycle for Redis 6 packages"> <phase .../> </lifecycle>

Il plugin segue le fasi in ordine, trova quella attualmente attiva e riporta il livello di supporto di quella fase nell'output.

fase

Definisce una fase all'interno di un ciclo di vita. Ogni fase continua fino all'inizio della fase successiva (o a tempo indeterminato se è l'ultima fase).

Attributo Richiesto Descrizione
name Identificatore di fase (unico nel suo ciclo di vita)
support_level Riferimenti a support_level@name
start_date Condizionale Data ISO fissa (YYYY-MM-DD). Usa questo o start_milestone
start_milestone Condizionale Riferimenti amilestone@name. Usa questo o start_date
display_name No Customer-facing etichetta
Nota

Specificate esattamente uno dei due start_date o start_milestone non entrambi.

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

Ogni fase è attiva dalla data di inizio fino all'inizio della fase successiva. L'ultima fase di un ciclo di vita rimane attiva a tempo indeterminato.

pietra miliare

Definisce un indicatore di data riutilizzabile a cui fanno riferimento le fasi del ciclo di vita.

Attributo Richiesto Descrizione
name Identificatore univoco a cui fa riferimento phase@start_milestone
date Data ISO () YYYY-MM-DD
display_name No Customer-facing etichetta
description No Human-readable descrizione
<milestone name="AL2023_GA" date="2023-03-15" display_name="AL2023 General Availability" description="Amazon Linux 2023 general availability date"/>

Le pietre miliari consentono alle fasi di condividere le date. Quando la data di una pietra miliare cambia, ogni fase che la fa riferimento si aggiorna automaticamente.

support_level

Definisce un livello di supporto e le criticità da esso coperte. Ciascuno name diventa un valore di --show filtro valido.

Attributo Richiesto Descrizione
name Identificatore univoco. Usato come valore del --show filtro
severities Comma-separated livelli di gravità coperti (stringa vuota = nessuna patch)
description Human-readable descrizione mostrata nell'output --list-filters
display_name No Customer-facing etichetta
<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 elenca tutti i pacchetti attualmente a questo livello di supporto. Il --list-filters comando visualizza name e di ogni livellodescription.

package

Associa il nome di un pacchetto RPM al relativo ciclo di vita, origine e classe.

Attributo Richiesto Descrizione
name Nome del pacchetto RPM
lifecycle Riferimenti a lifecycle@name
origin Riferimenti a package_origin@name
package_class No Riferimenti a package_class@name
<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
Nota

Un pacchetto può apparire più volte con origin valori diversi (ad esempio, lo stesso pacchetto nei repository core e SPAL). La combinazione di name + origin deve essere univoca.

Ogni RPM installato viene confrontato con questo elenco per determinarne il ciclo di vita e lo stato attuale del supporto.

package_class

Classifica i pacchetti in base al loro ruolo nel sistema. Il nome e il riepilogo della classe vengono visualizzati nell'output del plugin.

Attribute/Element Richiesto Descrizione
@name Identificatore univoco a cui fa riferimento package@package_class
summary(bambino) Breve descrizione della categoria
text(bambino) Descrizione estesa. L'elemento deve essere presente ma può essere vuoto
<package_class name="os_dependency"> <summary>Packages supported only as dependencies of the operating system</summary> <text></text> </package_class>

Il nome della classe appare nell'output per indicare il ruolo di un pacchetto nel sistema.

package_origin

Identifica l'origine del repository di un pacchetto. Il origin valore appare nell'dnf supportinfo --pkgoutput.

Attributo Richiesto Descrizione
name Identificatore univoco a cui fa riferimento package@origin
repo_id ID del repository DNF
dist Identificatore di distribuzione
vendor Fornitore del pacchetto
signing_key No Identificatore della chiave di firma GPG
display_name No Customer-facing etichetta
description No Human-readable descrizione
<package_origin name="al2023_core" repo_id="amazonlinux" dist="amzn2023" vendor="amazonlinux" display_name="Amazon Linux 2023 Core" description="Core Amazon Linux 2023 repository" />

display_nameViene visualizzato come campo «Origine» nell'--pkgoutput.

note

Fornisce testo in formato libero a cui un ciclo di vita può fare riferimento per un contesto aggiuntivo.

Attributo Richiesto Descrizione
name Identificatore univoco a cui fa riferimento lifecycle@note

Il contenuto testuale dell'elemento contiene il messaggio della nota.

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

Quando il ciclo di vita di un pacchetto fa riferimento a una nota, il testo della nota appare come «Nota sul pacchetto» nell'--pkgoutput.

Integrità referenziale

Lo schema collega gli elementi tra loro tramite name riferimenti. Ogni attributo di origine deve corrispondere a quello name di un elemento di destinazione esistente:

Attributo di origine Riferimenti
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

Inoltre, la combinazione di package@name e package@origin deve essere univoca per tutti package gli elementi.