Cómo usa el complemento este archivo Ejemplo mínimo completo Referencia del elemento Integridad referencial

SupportInfo Estructura XML

En esta página se documenta el esquema XML de la versión 1.0 que se utiliza para definir los ciclos de vida, los plazos y las clasificaciones de soporte de los paquetes en las distribuciones de Linux. El esquema es independiente del DNF y no es específico de ninguna distribución individual. Puedes consumirlo directamente desde cualquier herramienta. El dnf supportinfo plugin es uno de esos consumidores.

Definición del esquema (XSD): https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd
Datos de soporte (XML): https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Para analizar este XML directamente, utilice la amazon-linux-supportinfo biblioteca de código abierto, que implementa el esquema descrito en esta página, en lugar de escribir un analizador personalizado.

Cómo usa el complemento este archivo

Desde este archivo, el complemento informa:

En qué nivel de soporte se encuentra un paquete (estos valores completan las opciones de --show filtro)
Cuando cambian las fases del ciclo de vida (se muestran en el --pkg resultado y en el cronograma)
Cobertura de prioridad y gravedad de los parches para cada nivel de soporte
De dónde proviene el paquete (origen y clasificación)

Ejemplo mínimo completo

Este ejemplo muestra la estructura mínima con todas las secciones necesarias y un paquete:


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

Referencia del elemento

`package_support` (elemento raíz)

El elemento raíz que contiene todos los metadatos de soporte.

Atributo	Obligatorio	Descripción
`schema_version`	Sí	Versión en formato de esquema (actualmente`1.0`)
`current_as`	Sí	Marca de tiempo ISO de la última vez que se generaron los datos de soporte


<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

La current_as marca de tiempo aparece en la salida para indicar la actualidad de los datos.

`ciclo de vida`

Define una secuencia de fases por las que pasa un paquete a lo largo del tiempo.

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador único al que hace referencia `package@lifecycle`
`note`	No	Hace referencia a a `note@name` para obtener un contexto adicional
`display_name`	No	Customer-facing etiqueta
`description`	No	Human-readable descripción


<lifecycle name="redis6_lc" note="eol_redis6"
           display_name="Redis 6 Lifecycle"
           description="Support lifecycle for Redis 6 packages">
  <phase .../>
</lifecycle>

El complemento recorre las fases en orden, encuentra la fase actualmente activa e informa del nivel de soporte de esa fase en los resultados.

`fase`

Define una etapa dentro de un ciclo de vida. Cada fase continúa hasta que comience la siguiente fase (o indefinidamente si es la última fase).

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador de fase (único en su ciclo de vida)
`support_level`	Sí	Hace referencia a `support_level@name`
`start_date`	Condicional	Fecha ISO fija (`YYYY-MM-DD`). Usa esto o `start_milestone`
`start_milestone`	Condicional	Referencias a`milestone@name`. Usa esto o `start_date`
`display_name`	No	Customer-facing etiqueta

nota

Especifique exactamente uno de start_date ostart_milestone, no ambos.


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

Cada fase está activa desde su fecha de inicio hasta que comience la siguiente fase. La última fase de un ciclo de vida permanece activa indefinidamente.

`hito`

Define un marcador de fecha reutilizable al que hacen referencia las fases del ciclo de vida.

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador único al que hace referencia `phase@start_milestone`
`date`	Sí	Fecha ISO (`YYYY-MM-DD`)
`display_name`	No	Customer-facing etiqueta
`description`	No	Human-readable descripción


<milestone name="AL2023_GA" date="2023-03-15"
           display_name="AL2023 General Availability"
           description="Amazon Linux 2023 general availability date"/>

Los hitos permiten que las fases compartan fechas. Cuando la fecha de un hito cambia, cada fase que hace referencia a ella se actualiza automáticamente.

`support_level`

Define un nivel de soporte y los niveles de severidad que cubre. Cada uno name se convierte en un valor --show de filtro válido.

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador único. Se utiliza como valor `--show` de filtro
`severities`	Sí	Comma-separated niveles de gravedad cubiertos (cadena vacía = sin parches)
`description`	Sí	Human-readable la descripción se muestra en la `--list-filters` salida
`display_name`	No	Customer-facing etiqueta


<support_level name="limited"
               severities="Important,Critical"
               description="Security fixes for Important and Critical severities only"
               display_name="Limited Support" />

En ejecución se dnf supportinfo --show limited enumeran todos los paquetes que se encuentran actualmente en este nivel de soporte. El --list-filters comando muestra las name y de cada niveldescription.

`paquete`

Asigna el nombre de un paquete RPM a su ciclo de vida, origen y clase.

Atributo	Obligatorio	Descripción
`name`	Sí	Nombre del paquete RPM
`lifecycle`	Sí	Hace referencia a `lifecycle@name`
`origin`	Sí	Referencias a `package_origin@name`
`package_class`	No	Referencias a `package_class@name`


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

nota

Un paquete puede aparecer varias veces con origin valores diferentes (por ejemplo, el mismo paquete en los repositorios principales y SPAL). La combinación de name + origin debe ser única.

Cada RPM instalado se compara con esta lista para determinar su ciclo de vida y su estado actual de soporte.

`package_class`

Clasifica los paquetes según su función en el sistema. El nombre y el resumen de la clase aparecen en la salida del plugin.

Attribute/Element	Obligatorio	Descripción
`@name`	Sí	Identificador único al que hace referencia `package@package_class`
`summary`(niño)	Sí	Breve descripción de la categoría
`text`(niño)	Sí	Descripción ampliada. El elemento debe estar presente, pero puede estar vacío


<package_class name="os_dependency">
  <summary>Packages supported only as dependencies of the operating system</summary>
  <text></text>
</package_class>

El nombre de la clase aparece en la salida para indicar la función de un paquete en el sistema.

`package_origin`

Identifica la fuente del repositorio de un paquete. El origin valor aparece en la dnf supportinfo --pkg salida.

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador único al que hace referencia `package@origin`
`repo_id`	Sí	ID del repositorio DNF
`dist`	Sí	Identificador de distribución
`vendor`	Sí	Vendedor de paquetes
`signing_key`	No	Identificador de clave de firma GPG
`display_name`	No	Customer-facing etiqueta
`description`	No	Human-readable descripción


<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_nameAparece como el campo «Origen» en la --pkg salida.

`note`

Proporciona texto de formato libre al que puede hacer referencia un ciclo de vida para obtener un contexto adicional.

Atributo	Obligatorio	Descripción
`name`	Sí	Identificador único al que hace referencia `lifecycle@note`

El contenido de texto del elemento contiene el mensaje de la nota.


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

Cuando el ciclo de vida de un paquete hace referencia a una nota, el texto de la nota aparece como «Nota del paquete» en la --pkg salida.

Integridad referencial

El esquema vincula los elementos mediante name referencias. Cada atributo de origen debe coincidir con el name de un elemento de destino existente:

Atributo de origen	Referencias
`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`

Además, la combinación de todos package@name los elementos package@origin debe ser única en todos los package elementos.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Migración de la versión 1 a la versión 2

Lenguajes de programación y tiempos de ejecución

SupportInfo Estructura XML

Temas

Cómo usa el complemento este archivo

Ejemplo mínimo completo

Referencia del elemento

package_support (elemento raíz)

ciclo de vida

fase

nota

hito

support_level

paquete

nota

package_class

package_origin

note

Integridad referencial

`package_support` (elemento raíz)

`ciclo de vida`

`fase`

`hito`

`support_level`

`paquete`

`package_class`

`package_origin`

`note`