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
<a name="dnf-supportinfo-migrate-v1-v2"></a>

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.

**Topics**
+ [Descripción general de](#dnf-supportinfo-migrate-overview)
+ [Cambios importantes que requieren acción](#dnf-supportinfo-migrate-breaking-changes)
+ [¿Qué es lo que no cambia?](#dnf-supportinfo-migrate-unchanged)
+ [Período de transición](#dnf-supportinfo-migrate-transition-period)

## Descripción general de
<a name="dnf-supportinfo-migrate-overview"></a>

### Plazo
<a name="dnf-supportinfo-migrate-timeline"></a>


| 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
<a name="dnf-supportinfo-migrate-what-to-do"></a>

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ícelo`dnf supportinfo --show installed --showxml`.

## Cambios importantes que requieren acción
<a name="dnf-supportinfo-migrate-breaking-changes"></a>

### Si analiza la salida de la consola
<a name="dnf-supportinfo-migrate-console-output"></a>

#### Campos de detalle
<a name="dnf-supportinfo-migrate-detail-fields"></a>

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
<a name="dnf-supportinfo-migrate-table-columns"></a>

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`
<a name="dnf-supportinfo-migrate-xml-output"></a>

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 `marker``start_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
<a name="dnf-supportinfo-migrate-xml-file"></a>

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

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

   ```
   dnf supportinfo --show installed --showxml
   ```

### Si filtra con `--show`
<a name="dnf-supportinfo-migrate-show-filter"></a>

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_support``eos`,, etc.).

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

```
dnf supportinfo --list-filters
```

## ¿Qué es lo que no cambia?
<a name="dnf-supportinfo-migrate-unchanged"></a>

Una vez instalada la dnf-plugin-support-info versión 2, lo siguiente sigue siendo el mismo independientemente de la `legacy` configuración:
+ **`--showjson`salida. ** La salida JSON es idéntica independientemente de si `legacy` es `0` o`1`, 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 corres`dnf 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
<a name="dnf-supportinfo-migrate-transition-period"></a>

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.

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

1. 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.
+ `--showxml`produce el nuevo formato basado en fases.
+ `--show`los 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.