View a markdown version of this page

Uso de información de soporte dnf Complemento - Amazon Linux 2023

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 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á alegacy = 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, consulteMigrar desde dnf-plugin-support-info v1 a v2.

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)

Introducción

  1. Instale el complemento.

    sudo dnf install dnf-plugin-support-info
  2. 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

--pkgIncluya 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 <support_level> 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, consulteSupportInfo Estructura XML.

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 <package_support> raíz que contiene un <statement> 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, consulteSupportInfo Estructura XML.

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

  2. Si no se modifica, amplía la caché sin volver a descargarla.

  3. Si se modifica, descarga el archivo actualizado.

  4. 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, 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. 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 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

Silegacy = 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, consulteMigrar desde dnf-plugin-support-info v1 a v2.

Recursos adicionales