View a markdown version of this page

Migrar desde dnf-plugin-support-info v1 a v2 - Amazon Linux 2023
Descripción general deCambios importantes que requieren acción¿Qué es lo que no cambia?Período de transición

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Migrar desde dnf-plugin-support-info v1 a v2

El dnf-plugin-support-info paquete tiene una nueva versión principal (v2) con un formato de salida rediseñado. Esta guía le ayuda a actualizar cualquier script o herramienta que analice dnf supportinfo los resultados.

Durante el período de transición, el complemento de la versión 2 viene incluido/etc/dnf/plugins/supportinfo.conf, lo que conserva los resultados compatibles con legacy = 1 la versión 1. Una vez que hayas actualizado tus scripts, configúralos legacy = 0 para que cambien a la salida de la versión 2.

Descripción general de

Plazo

Event Timing
El complemento v2 (dnf-plugin-support-info 2.0) está disponible Ahora
El complemento viene con legacy = 1 (salida compatible con la versión 1) Versión inicial de la versión 2
Cambios predeterminados a legacy = 0 Una futura publicación trimestral de AL2023
El formato v1 ya no se mantiene Tras el período de transición

Lo que tienes que hacer

Si tiene scripts que analizan la salida de la consola o la salida XML o leen el archivo XML del disco, actualícelos para que controlen los nuevos nombres de campo, estructura y rutas de archivo. Si los usa--showjson, sus scripts no necesitan cambios, ya que la salida JSON es idéntica entre la versión 1 y la 2. Si lee el archivo XML directamente desde el disco, cambie a descargar el XML desde el disco configurado baseurl o utilícelodnf supportinfo --show installed --showxml.

Cambios importantes que requieren acción

Si analiza la salida de la consola

Campos de detalle

El complemento cambió las etiquetas de campo que muestra al consultar un paquete específico:

etiqueta v1 etiqueta v2 Notas
Estado de soporte Estado actual Renombrado
Períodos de soporte Cronograma de soporte Se cambió el nombre, se movió al final de la salida
Declaración de soporte (eliminado) Ya no se muestra
Link Link Sin cambios (se muestra cuando está disponible)
Otra información Otra información Sin cambios (se muestra cuando está disponible)
(no está presente) Prioridad de parches Campo nuevo
(no está presente) Descripción del nivel de soporte Campo nuevo
(no está presente) Gravedades cubiertas Campo nuevo
(no está presente) Origen Campo nuevo

La columna de etiquetas de campo ahora tiene 28 caracteres de ancho (antes 20).

v1: dnf supportinfo --pkg apr

Name                 : apr
Version              : 1.7.5-1.amzn2023.0.4
State                : available
Support Status       : supported
Support Periods      : from 2023-03-15      : supported
                     : from 2029-06-30      : unsupported
Support Statement    : Amazon Linux 2023 end-of-life
Link                 : https://aws.amazon.com/amazon-linux-ami/faqs/
Other Info           : This is the support statement for AL2023. The end-of-life
                     : of Amazon Linux 2023 is June 2029. From this point, the
                     : Amazon Linux 2023 packages will no longer receive any
                     : updates from AWS.

v2: dnf supportinfo --pkg apr

Name                         : apr
Version                      : 1.7.5-1.amzn2023.0.4
State                        : available
Current Status               : Supported
Patch Priority               : Full Support
Support Level Description    : Full security and bug fix support for all severities
Covered Severities           : Low, Medium, Important, Critical
Origin                       : Amazon Linux 2023 Core
Support Timeline             : from 2023-03-15     : supported
                             : from 2029-06-30     : unsupported

Columnas de la tabla

La tabla de resumen ha cambiado de 6 columnas a 7. La tabla v2 también muestra una fila de encabezado (la versión 1 no):

columna v1 columna v2 Cambio
Name Package Renombrado
Versión Versión Sin cambios
Estado Estado Sin cambios
Estado del soporte Estado actual Renombrado
(no está presente) Nivel de soporte Nueva columna
Fecha (por ejemplo2029-06-30) Hasta (siguiente fase) (por ejemplo2029-06-30 (end_of_support)) Se cambió el nombre, se cambió el formato
Nota Nota Sin cambios
importante

La columna de fecha ahora incluye el nombre de la siguiente fase entre paréntesis. Si analizas este campo, actualiza tu lógica de expresiones regulares o delimitadores.

v1: dnf supportinfo --show installed

iproute              6.10.0-319.amzn2023.0.1    installed    supported    2029-06-30    Kernel6.18 has security support until June 2029
kernel6.12           6.12.90-120.164.amzn2023   installed    supported    2029-06-30    Kernel6.12 has security support until June 2029

v2: dnf supportinfo --show installed

Package                          Version                            State        Support Level    Current Status         Until (Next Phase)           Note
alternatives                     1.15-2.amzn2023.0.2                installed    Full Support     Supported              2029-06-30 (unsupported)
amazon-linux-repo-cdn            2023.12.20260611-0.amzn2023        installed    Full Support     Supported              2029-06-30 (unsupported)
redis6                           6.2.20-2.amzn2023.0.1              installed    End of Support   End of Life                                         Upstream end-of-life for Redis 6 (redis6) is 2026-01-31

Si analiza la salida --showxml

La --showxml salida de la versión 2 utiliza una estructura XML diferente a la de la versión 1. El <package_support> elemento raíz es el mismo, pero los elementos secundarios, los atributos y la jerarquía han cambiado.

v1: dnf supportinfo --pkg apr --showxml

<?xml version="1.0" ?>
<package_support current_as="2026-06-18">
  <statements>
    <statement id="eol" marker="supported" start_date="2023-03-15" end_date="2029-06-30">
      <summary>Amazon Linux 2023 end-of-life</summary>
      <text>This is the support statement for AL2023. The end-of-life of Amazon
Linux 2023 is June 2029. From this point, the Amazon Linux 2023 packages will
no longer receive any updates from AWS.</text>
      <link>https://aws.amazon.com/amazon-linux-ami/faqs/</link>
      <packages>
        <package name="apr" nevra="1.7.5-1.amzn2023.0.4"/>
      </packages>
    </statement>
  </statements>
</package_support>

v2: dnf supportinfo --pkg apr --showxml

<?xml version='1.0' encoding='utf-8'?>
<package_support current_as="2026-06-18">
  <statements>
    <statement id="eol_lc" current_phase="supported">
      <phases>
        <phase name="supported" start_date="2023-03-15">
          <patch_priority>Full Support</patch_priority>
          <support_level_description>Full security and bug fix support for all severities</support_level_description>
          <covered_severities>Low, Medium, Important, Critical</covered_severities>
        </phase>
        <phase name="unsupported" start_date="2029-06-30">
          <patch_priority>End of Support</patch_priority>
          <support_level_description>End of support - no further updates</support_level_description>
        </phase>
      </phases>
      <packages>
        <package name="apr" nevra="1.7.5-1.amzn2023.0.4" state="available" origin="Amazon Linux 2023 Core"/>
      </packages>
    </statement>
  </statements>
</package_support>

Diferencias estructurales clave:

  • v1 usa markerstart_date, tiene end_date atributos en <statement> with<summary>,<text>, <link> niños

  • La v2 usa current_phase atributos y <phases> elementos anidados con detalles de nivel de soporte

  • La v2 omite <covered_severities> por completo cuando está vacía (en lugar de un elemento vacío)

  • Los elementos del paquete v2 incluyen state y atributos origin

  • La versión 2 no incluye <summary><text>, ni <link> elementos

Si lee el archivo XML directamente desde el disco

El complemento v1 incluyó su archivo de datos en:

/usr/lib/python*/site-packages/dnf-plugins/support_info.xml
aviso

Este archivo ya no se actualiza una vez que entra en legacy = 0 vigor. No confíe en esta ruta para obtener los datos actuales.

El complemento v2 almacena en caché los datos /var/cache/dnf/support-info/ cuando se ejecuta como usuario root. Cuando se ejecuta como usuario no root/var/tmp/dnf-username-*/support-info/, utiliza directorios temporales por usuario siguiendo la convención estándar de DNF. Los archivos de estos directorios utilizan nombres de archivo con direcciones de contenido y no son estables. No los analice directamente.

Alternativas recomendadas:

  1. Descargue el XML directamente desde la URL configurada:

    https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

  2. Utilice la CLI para obtener resultados estructurados para los paquetes instalados:

    dnf supportinfo --show installed --showxml

Si filtra con --show

Los valores aceptados por el --show filtro han cambiado:

valores del filtro v1 valores de filtro v2
supported full_support
unsupported eos

Los filtros v1 son nombres de fase (supported,unsupported). Los filtros v2 son nombres de niveles de soporte (full_supporteos,, etc.).

Ejecute --list-filters para descubrir los valores de filtro disponibles en su sistema:

dnf supportinfo --list-filters

¿Qué es lo que no cambia?

Una vez instalada la dnf-plugin-support-info versión 2, lo siguiente sigue siendo el mismo independientemente de la legacy configuración:

  • --showjsonsalida. La salida JSON es idéntica independientemente de si legacy es 0 o1, porque el complemento se normaliza a la estructura interna de la versión 2 antes de formatear.

  • Argumentos de CLI. Todas las banderas (--pkg--show,--showxml,--showjson,--clean-cache,--list-filters,--sync) funcionan en ambos modos.

  • Nombre del comando. Aún corresdnf supportinfo.

nota

Los --sync indicadores--showjson, --clean-cache--list-filters, y son nuevos en la versión 2 y no están disponibles en la versión 1.

Período de transición

El complemento v2 se suministra con legacy = 1 in/etc/dnf/plugins/supportinfo.conf. Durante este período:

  1. El complemento descarga los datos de la versión 2 desde la URL configurada.

  2. Los valores de salida de consola, salida XML y filtro siguen comportándose como en la versión 1.

  3. El archivo XML con formato v1 permanece disponible en la ruta anterior, por lo que los scripts existentes siguen funcionando.

En una futura versión trimestral de AL2023, el valor predeterminado cambiará a. legacy = 0 En ese momento:

  • La salida de la consola usa los nombres de campo y la estructura de la versión 2.

  • --showxmlproduce el nuevo formato basado en fases.

  • --showlos valores de los filtros cambian para admitir los nombres de los niveles.

  • El archivo XML de la versión 1 de la ruta anterior ya no se actualiza.

Para mantener temporalmente la salida compatible con la versión 1, legacy = 1 defina: /etc/dnf/plugins/supportinfo.conf

[main]
legacy = 1
importante

La legacy = 1 opción es un puente temporal. Planifique migrar sus herramientas a la salida de la versión 2 en lugar de confiar en esta configuración de forma indefinida.