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.
# Uso de información de soporte dnf Complemento
El dnf-plugin-support-info paquete proporciona el `dnf supportinfo` comando para AL2023. Utilice este comando para consultar la información sobre el ciclo de vida y el soporte de los paquetes: averigüe si un paquete es compatible actualmente, qué niveles de gravedad reciben los parches y cuándo cambia el estado del soporte.
Para obtener un resumen de todas las declaraciones de soporte de los paquetes, consulte las declaraciones de soporte del [ AL2023 ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html) en las notas de la versión del * AL2023. *
**importante**
El plugin de la versión 2 viene incluido. `legacy = 1` `/etc/dnf/plugins/supportinfo.conf` En este modo, la salida usa los nombres de campo y el formato de la versión 1. En una futura versión trimestral de AL2023, el valor predeterminado cambiará a`legacy = 0`, pasando al formato de salida v2 documentado en esta página. Para empezar a usar la salida de la versión 2 ahora, `legacy = 0` defina su configuración. Para obtener más información sobre los cambios, consulte[Migrar desde dnf-plugin-support-info v1 a v2](dnf-supportinfo-migrate-v1-v2.md).
**Topics**
+ [Requisitos previos](#dnf-supportinfo-prerequisites)
+ [Introducción](#dnf-supportinfo-getting-started)
+ [Paquetes de consulta](#dnf-supportinfo-query-packages)
+ [Filtrar paquetes](#dnf-supportinfo-filter-packages)
+ [Salida estructurada](#dnf-supportinfo-structured-output)
+ [Gestione la caché](#dnf-supportinfo-manage-cache)
+ [Non-root Uso](#dnf-supportinfo-non-root)
+ [Referencia de la configuración](#dnf-supportinfo-configuration-reference)
+ [Referencia de campos de salida](#dnf-supportinfo-output-fields)
+ [Esquema](#dnf-supportinfo-schema)
+ [Migración desde Legacy Plugin](#dnf-supportinfo-migration-from-legacy)
+ [Resolución de problemas](#dnf-supportinfo-troubleshooting)
+ [Recursos adicionales](#dnf-supportinfo-additional-resources)
## Requisitos previos
+ Instancia AL2023
+ El dnf-plugin-support-info paquete (disponible en los repositorios AL2023 predeterminados)
+ No se requieren privilegios de root (excepto `--sync` en el modo [ heredado) ](#dnf-supportinfo-migration-from-legacy)
## Introducción
1. Instale el complemento.
```
sudo dnf install dnf-plugin-support-info
```
1. Consulte un paquete para verificar la instalación.
```
dnf supportinfo --pkg glibc
```
El resultado muestra el estado de soporte y el cronograma del paquete:
```
Name : glibc
Version : 2.34-231.amzn2023.0.4
State : installed
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
```
## Paquetes de consulta
`--pkg`Incluya uno o más nombres de paquetes para mostrar su información de soporte.
```
dnf supportinfo --pkg {{PACKAGE}} [{{PACKAGE}} ...]
```
### Para consultar un paquete específico
En el siguiente `dnf supportinfo` ejemplo, se consulta un paquete que ha llegado al final de su ciclo de vida:
```
dnf supportinfo --pkg php8.1
```
```
Name : php8.1
Version : 8.1.34-1.amzn2023.0.1
State : available
Current Status : End of Life
Patch Priority : End of Support
Support Level Description : End of support - no further updates
Origin : Amazon Linux 2023 Core
Support Timeline : from 2023-03-15 : supported
: from 2025-12-31 : unsupported
Package Note : Upstream end-of-life for PHP 8.1 (php8.1) is 2025-12-31
```
### Para consultar varios paquetes
```
dnf supportinfo --pkg glibc bash openssl
```
## Filtrar paquetes
La `--show` marca filtra los paquetes por estado, nivel de soporte o ambos.
```
dnf supportinfo --show {{FILTER}} [{{FILTER}} ...]
```
### Tipos de filtros
| Categoría | Valores | origen |
| --- | --- | --- |
| Filtros de estado (fijos) | installed, available, unavailable, all | Integrado en el complemento |
| Filtros de nivel de soporte (dinámicos) | Varía. Por ejemplofull\_support, eos | Se carga desde las entradas del XML de información de soporte |
**nota**
Los filtros de nivel de soporte son dinámicos. Provienen directamente de los datos XML de información de soporte definidos por el proveedor del sistema operativo. Los valores disponibles dependen de lo que AL2023 defina actualmente. Ejecute `--list-filters` para ver el conjunto actual de valores de filtro válidos. Para obtener información sobre cómo se declaran estos niveles, consulte[SupportInfo Estructura XML](dnf-supportinfo-xml-structure.md).
### Lógica de filtro
+ Los filtros de varios estados se combinan con OR: `--show installed available` coincide con los paquetes que están instalados o disponibles.
+ Los filtros de varios niveles de soporte se combinan con OR: `--show full_support eos` busca paquetes del nivel de `eos` soporte `full_support` OR.
+ Cuando se combinan ambos tipos, se combinan con AND: `--show installed eos` busca paquetes instalados y en el nivel de `eos` soporte.
**nota**
Si existe un nombre de filtro tanto en las categorías de estado como en las de nivel de soporte, el complemento coincide con ambas. Usa la sintaxis de prefijo para eliminar la ambigüedad: o. `state:{{NAME}}` `support:{{NAME}}`
### Para enumerar los filtros disponibles
Ejecute `--list-filters` para ver todos los valores de filtro válidos agrupados por categoría:
```
dnf supportinfo --list-filters
```
Ejemplo de código de salida:
```
State filters:
all - All packages (installed, available, and unavailable)
available - Packages available in repositories but not installed
installed - Packages currently installed on the system
unavailable - Packages in support info but not in any repository
Support level filters:
eos - End of support - no further updates
full_support - Full security and bug fix support for all severities
```
### Para filtrar los paquetes instalados
```
dnf supportinfo --show installed
```
El resultado muestra cada paquete en una tabla con su nivel de soporte y estado actual:
```
Package Version State Support Level Current Status Until (Next Phase) Note
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
bash 5.2.15-1.amzn2023.0.2 installed Full Support Supported 2029-06-30 (unsupported)
glibc 2.34-231.amzn2023.0.1 installed Full Support Supported 2029-06-30 (unsupported)
...
```
### Para filtrar los paquetes instalados en un nivel de soporte específico
```
dnf supportinfo --show installed eos
```
### Para usar la sintaxis de prefijos para la desambiguación
```
dnf supportinfo --show state:installed support:full_support
```
## Salida estructurada
Para la creación de scripts y la automatización, `--showjson` y `--showxml` para producir resultados legibles por máquina.
### Para obtener la salida JSON
```
dnf supportinfo --pkg nodejs20 --showjson
```
El resultado contiene la fase actual, el origen y el cronograma completo del paquete, con detalles del nivel de soporte:
```
{
"name": "nodejs20",
"version": "20.20.2-1.amzn2023.0.2",
"state": "available",
"current_phase": "unsupported",
"origin": "Amazon Linux 2023 Core",
"phases": [
{
"name": "supported",
"start_date": "2023-10-24",
"patch_priority": "Full Support",
"support_level_description": "Full security and bug fix support for all severities",
"covered_severities": "Low, Medium, Important, Critical"
},
{
"name": "unsupported",
"start_date": "2026-04-30",
"patch_priority": "End of Support",
"support_level_description": "End of support - no further updates"
}
],
"note": "Upstream end-of-life for Node.js 20 (nodejs20) is 2026-04-30"
}
```
### Para obtener la salida XML
```
dnf supportinfo --pkg nodejs20 --showxml
```
El resultado es un documento XML con una `` raíz que contiene un `` elemento por ciclo de vida, cada uno con sus fases, fechas de inicio y detalles del nivel de soporte. Para obtener la referencia completa del esquema, consulte[SupportInfo Estructura XML](dnf-supportinfo-xml-structure.md).
## Gestione la caché
El complemento almacena en caché la información de soporte XML de forma local para reducir las solicitudes de red.
### Comportamiento del caché
Cuando caduque la caché:
1. El complemento comprueba si el archivo remoto ha cambiado (mediante HTTP ETag).
1. Si no se modifica, amplía la caché sin volver a descargarla.
1. Si se modifica, descarga el archivo actualizado.
1. En caso de errores de red, vuelve al archivo en caché, si existe alguno.
### Para sincronizar la memoria caché
Descargue y almacene en caché los datos de información de soporte más recientes:
```
dnf supportinfo --sync
```
Utilícela para trabajos de automatización y cron que necesitan datos de soporte actualizados sin ejecutar una consulta completa.
### Para borrar la memoria caché
```
dnf supportinfo --clean-cache
```
## Non-root Uso
Todos los comandos funcionan sin privilegios de root. Cuando se ejecuta como usuario root, la caché se almacena en`/var/cache/dnf/support-info/`. Cuando se ejecuta como usuario no root, la memoria caché va a`/var/tmp/dnf-{{username}}-*/support-info/`. Esto sigue la convención estándar de DNF para los directorios temporales por usuario.
**nota**
Si habilita el modo [ heredado](#dnf-supportinfo-migration-from-legacy), ejecútelo `sudo dnf supportinfo --sync` una vez para crear el archivo heredado. Después de eso, las consultas que no son raíz funcionan con normalidad.
## Referencia de la configuración
El complemento lee la configuración desde`/etc/dnf/plugins/supportinfo.conf`. El siguiente ejemplo muestra la configuración recomendada con el modo heredado desactivado:
```
[main]
# Required: URL to support info XML (DNF variables like $awsregion are resolved)
baseurl = https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml
# Optional: XSD schema for validation
templateurl = https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd
# Optional: Cache duration in seconds (default: 1800 = 30 minutes)
metadata_expire = 1800
# Legacy mode (default: 1). Set to 0 to use v2 format.
legacy = 0
```
| Opción | Description (Descripción) | Predeterminado |
| --- | --- | --- |
| baseurl | URL del archivo XML de información de soporte. Admite variables DNF como$awsregion. | Obligatorio |
| templateurl | URL del esquema XSD para su validación. | Ninguno |
| metadata\_expire | Duración de la caché en segundos. -1Utilízalo para infinito, 0 para comprobarlo siempre. | 1800 |
| legacy | Habilite la salida compatible con la versión 1. Establézcalo en 1 o. 0 Consulta [ Migración desde un complemento antiguo](#dnf-supportinfo-migration-from-legacy). | 1 |
## Referencia de campos de salida
| Campo | Description (Descripción) |
| --- | --- |
| Name | Nombre del paquete |
| Versión | Versión instalada o disponible |
| Estado | installed, available o unavailable |
| Estado actual | Fase actual del ciclo de vida, como Supported o End of Life |
| Prioridad de parches | Nombre del nivel de soporte |
| Descripción del nivel de soporte | Human-readable descripción del nivel de soporte |
| Gravedades cubiertas | Niveles de gravedad de seguridad que reciben los parches |
| Origen | Repositorio que proporciona el paquete |
| Cronograma de soporte | Lista cronológica de las fases del ciclo de vida con fechas |
| Nota sobre el paquete | Contexto adicional, como las fechas iniciales de finalización de la vida útil |
## Esquema
El formato de los datos de la información de soporte se define mediante un esquema XSD. Utilice este esquema para validar las herramientas personalizadas que consumen directamente el XML de información de soporte:
```
https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd
```
## Migración desde Legacy Plugin
Si anteriormente utilizaste una versión anterior del dnf-plugin-support-info paquete, el nuevo complemento v2 viene incluido de forma `legacy = 1` predeterminada para mantener la compatibilidad con versiones anteriores. En una futura versión trimestral de AL2023, los cambios predeterminados `legacy = 0` y la salida cambian al formato v2 documentado en esta página.
Si tiene scripts o herramientas que analizan la salida de los complementos o leen directamente el archivo XML antiguo, consulte la lista completa de diferencias, before/after ejemplos y una lista de verificación paso a paso [Migrar desde dnf-plugin-support-info v1 a v2](dnf-supportinfo-migrate-v1-v2.md) para la migración.
Para mantener el comportamiento heredado tras la transición, `legacy = 1` configúralo. `/etc/dnf/plugins/supportinfo.conf` Se trata de una medida temporal. El modo Legacy requiere privilegios de usuario root `--sync` y se eliminará en una versión futura.
## Resolución de problemas
### Datos de caché obsoletos
**Síntoma: los resultados de la ** consulta muestran información de soporte desactualizada.
**Solución: ** sincronice la memoria caché manualmente:
```
dnf supportinfo --sync
```
Si el problema persiste, borra y vuelve a sincronizar:
```
dnf supportinfo --clean-cache
dnf supportinfo --sync
```
### No se ha encontrado el archivo antiguo
**Síntoma: ** los scripts que se leen `/usr/lib/python*/site-packages/dnf-plugins/support_info.xml` fallan y dicen «no se encontró el archivo».
**Solución: ** el complemento crea el archivo heredado solo cuando lo configuras `legacy = 1` y lo ejecutas al `--sync` menos una vez:
```
sudo dnf supportinfo --sync
```
Si`legacy = 0`, el archivo ya no se conserva. Migre sus scripts para utilizarlos `--showjson` o `--showxml` generarlos en su lugar. Para conocer los pasos de migración, consulte[Migrar desde dnf-plugin-support-info v1 a v2](dnf-supportinfo-migrate-v1-v2.md).
## Recursos adicionales
+ [Declaraciones de apoyo al AL2023 (legibles por humanos) ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html)
+ [El complemento de información de soporte de DNF está en GitHub ](https://github.com/amazonlinux/dnf-plugin-support-info)
+ [La biblioteca de análisis amazon-linux-supportinfo está en GitHub ](https://github.com/amazonlinux/amazon-linux-supportinfo)