View a markdown version of this page

Utilisation de informations d'assistance DNF Plugin - Amazon Linux 2023
Conditions préalablesDémarragePackages de requêtesPackages de filtresSortie structuréeGérer le cacheNon-root UtilisationRéférence de configurationRéférence des champs de sortieSchemaMigration depuis le plug-in LegacyRésolution des problèmesRessources supplémentaires

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de informations d'assistance DNF Plugin

Le dnf-plugin-support-info package fournit la dnf supportinfo commande pour AL2023. Utilisez cette commande pour rechercher des informations sur le cycle de vie et le support des packages : découvrez si un package est actuellement pris en charge, quels niveaux de gravité reçoivent des correctifs et quand l'état du support change.

Pour une vue récapitulative de toutes les déclarations de support des packages, consultez les déclarations de support AL2023 dans les notes de version d'AL2023.

Important

Le plugin v2 est livré avec legacy = 1/etc/dnf/plugins/supportinfo.conf. Dans ce mode, la sortie utilise les noms et le format des champs v1. Dans une prochaine version trimestrielle d'AL2023, la valeur par défaut legacy = 0 sera remplacée par le format de sortie v2 décrit sur cette page. Pour commencer à utiliser la sortie v2 dès maintenant, configurez legacy = 0 votre configuration. Pour plus de détails sur les modifications, consultezMigration à partir de dnf-plugin-support-info v1 à v2.

Conditions préalables

  • Instance AL2023

  • Le dnf-plugin-support-info package (disponible depuis les référentiels AL2023 par défaut)

  • Aucun privilège root n'est requis (sauf --sync en mode Legacy)

Démarrage

  1. Installez le plug-in .

    sudo dnf install dnf-plugin-support-info

  2. Interrogez un package pour vérifier l'installation.

    dnf supportinfo --pkg glibc

    La sortie indique l'état de support et la chronologie du package :

    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

Packages de requêtes

Pass --pkg avec un ou plusieurs noms de package pour afficher leurs informations d'assistance.

dnf supportinfo --pkg PACKAGE [PACKAGE ...]

Pour interroger un package spécifique

L'dnf supportinfoexemple suivant interroge un package en fin de vie :

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

Pour interroger plusieurs packages

dnf supportinfo --pkg glibc bash openssl

Packages de filtres

L'--showindicateur filtre les packages par état, niveau de support ou les deux.

dnf supportinfo --show FILTER [FILTER ...]

Types de filtres

Catégorie Valeurs Source
Filtres d'état (fixes) installed, available, unavailable, all Intégré au plugin
Filtres de niveau de support (dynamiques) Variable. Par exemplefull_support, eos Chargé à partir d'<support_level>entrées dans le fichier XML des informations de support
Note

Les filtres de niveau de support sont dynamiques. Ils proviennent directement des données XML d'informations de support définies par le fournisseur du système d'exploitation. Les valeurs disponibles dépendent de ce que AL2023 définit actuellement. Exécutez --list-filters pour voir l'ensemble actuel de valeurs de filtre valides. Pour plus d'informations sur la manière dont ces niveaux sont déclarés, voirSupportInfo Structure XML.

Logique du filtre

  • Plusieurs filtres d'état sont combinés avec OR : --show installed available correspond aux packages installés OU disponibles.

  • Plusieurs filtres de niveau de support sont combinés avec OR : fait --show full_support eos correspondre les packages au niveau de eos support full_support OR.

  • Lorsque vous combinez les deux types, ils sont combinés avec AND : --show installed eos correspond aux packages installés ET au niveau du eos support.

Note

Si un nom de filtre existe à la fois dans les catégories d'état et de niveau de support, le plugin correspond aux deux. Utilisez la syntaxe du préfixe pour lever l'ambiguïté : ou. state:NAME support:NAME

Pour répertorier les filtres disponibles

Exécutez --list-filters pour voir toutes les valeurs de filtre valides regroupées par catégorie :

dnf supportinfo --list-filters

Exemple de sortie :

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

Pour filtrer les packages installés

dnf supportinfo --show installed

La sortie répertorie chaque package dans un tableau avec son niveau de support et son état actuel :

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

Pour filtrer les packages installés à un niveau de support spécifique

dnf supportinfo --show installed eos

Pour utiliser la syntaxe des préfixes pour la désambiguïsation

dnf supportinfo --show state:installed support:full_support

Sortie structurée

Pour la création de scripts et l'automatisation, --showjson et pour --showxml produire des résultats lisibles par machine.

Pour obtenir une sortie JSON

dnf supportinfo --pkg nodejs20 --showjson

La sortie contient la phase actuelle, l'origine et la chronologie complète du package avec des informations sur le niveau de support :

{
  "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"
}

Pour obtenir une sortie XML

dnf supportinfo --pkg nodejs20 --showxml

Le résultat est un document XML dont la <package_support> racine contient un <statement> élément par cycle de vie, chacun avec ses phases, ses dates de début et les détails de son niveau de support. Pour la référence complète du schéma, consultezSupportInfo Structure XML.

Gérer le cache

Le plugin met en cache les informations de support XML localement pour réduire les requêtes réseau.

Comportement du cache

À l'expiration du cache :

  1. Le plugin vérifie si le fichier distant a changé (en utilisant HTTP ETag).

  2. S'il n'est pas modifié, il étend le cache sans retélécharger.

  3. En cas de modification, il télécharge le fichier mis à jour.

  4. En cas d'erreur réseau, il revient au fichier mis en cache s'il en existe un.

Pour synchroniser le cache

Téléchargez et mettez en cache les dernières informations d'assistance :

dnf supportinfo --sync

Utilisez-le pour les tâches d'automatisation et les tâches cron qui nécessitent des données d'assistance à jour sans exécuter de requête complète.

Pour vider le cache

dnf supportinfo --clean-cache

Non-root Utilisation

Toutes les commandes fonctionnent sans privilèges root. Lorsqu'il est exécuté en tant que root, le cache est stocké dans/var/cache/dnf/support-info/. Lorsqu'il est exécuté en tant qu'utilisateur non root, le cache est dirigé vers/var/tmp/dnf-username-*/support-info/. Cela suit la convention standard de DNF pour les répertoires temporaires par utilisateur.

Note

Si vous activez le mode hérité, exécutez sudo dnf supportinfo --sync une fois pour créer le fichier d'ancienne génération. Après cela, les requêtes non root fonctionnent normalement.

Référence de configuration

Le plugin lit la configuration à partir de/etc/dnf/plugins/supportinfo.conf. L'exemple suivant montre la configuration recommandée avec le mode Legacy désactivé :

[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
Option Description Par défaut
baseurl URL du fichier XML d'informations de support. Supporte les variables DNF telles $awsregion que. Obligatoire
templateurl URL du schéma XSD pour validation. Aucune
metadata_expire Durée du cache en secondes. Utilisez -1 pour infini, 0 pour toujours vérifier. 1800
legacy Activez la sortie compatible avec la version 1. Réglez sur 1 ou0. Consultez la section Migration depuis un ancien plug-in. 1

Référence des champs de sortie

Champ Description
Nom Nom du package
Version Version installée ou disponible
State installed, available ou unavailable
État actuel Phase du cycle de vie en cours, telle que Supported ou End of Life
Priorité des correctifs Nom du niveau de support
Description du niveau de support Human-readable description du niveau de support
Gravités couvertes Niveaux de gravité de sécurité auxquels sont soumis les correctifs
Origin Référentiel fournissant le package
Chronologie du support Liste chronologique des phases du cycle de vie avec dates
Note sur le colis Contexte supplémentaire, tel que les dates de fin de vie en amont

Schema

Le format des données d'informations de support est défini par un schéma XSD. Utilisez ce schéma pour valider un outillage personnalisé qui utilise directement le XML des informations de support :

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

Migration depuis le plug-in Legacy

Si vous avez déjà utilisé une version antérieure du dnf-plugin-support-info package, le nouveau plugin v2 est livré avec legacy = 1 par défaut pour maintenir la rétrocompatibilité. Dans une prochaine version trimestrielle d'AL2023, le format par défaut sera modifié legacy = 0 et la sortie passera au format v2 décrit sur cette page.

Si vous disposez de scripts ou d'outils qui analysent la sortie du plug-in ou lisent directement le fichier XML existant, consultez Migration à partir de dnf-plugin-support-info v1 à v2 la liste complète des différences, des before/after exemples et une liste de contrôle de migration étape par étape.

Pour conserver le comportement d'origine après la transition, legacy = 1 installez-le/etc/dnf/plugins/supportinfo.conf. Il s'agit d'une mesure temporaire. Le mode Legacy nécessite des privilèges root --sync et sera supprimé dans une prochaine version.

Résolution des problèmes

Données de cache périmées

Symptôme : les résultats de la requête indiquent des informations d'assistance obsolètes.

Résolution : Synchronisez le cache manuellement :

dnf supportinfo --sync

Si le problème persiste, effacez et resynchronisez :

dnf supportinfo --clean-cache
dnf supportinfo --sync

Fichier d'ancienne génération introuvable

Symptôme : les scripts en lecture /usr/lib/python*/site-packages/dnf-plugins/support_info.xml échouent avec le message « fichier introuvable ».

Résolution : Le plugin crée l'ancien fichier uniquement lorsque vous définissez legacy = 1 et exécutez au --sync moins une fois :

sudo dnf supportinfo --sync

Silegacy = 0, le fichier n'est plus maintenu. Migrez vos scripts pour les utiliser --showjson ou les --showxml sortir à la place. Pour connaître les étapes de migration, consultezMigration à partir de dnf-plugin-support-info v1 à v2.

Ressources supplémentaires