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 ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html) 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, consultez[Migration à partir de dnf-plugin-support-info v1 à v2](dnf-supportinfo-migrate-v1-v2.md).
**Topics**
+ [Conditions préalables](#dnf-supportinfo-prerequisites)
+ [Démarrage](#dnf-supportinfo-getting-started)
+ [Packages de requêtes](#dnf-supportinfo-query-packages)
+ [Packages de filtres](#dnf-supportinfo-filter-packages)
+ [Sortie structurée](#dnf-supportinfo-structured-output)
+ [Gérer le cache](#dnf-supportinfo-manage-cache)
+ [Non-root Utilisation](#dnf-supportinfo-non-root)
+ [Référence de configuration](#dnf-supportinfo-configuration-reference)
+ [Référence des champs de sortie](#dnf-supportinfo-output-fields)
+ [Schema](#dnf-supportinfo-schema)
+ [Migration depuis le plug-in Legacy](#dnf-supportinfo-migration-from-legacy)
+ [Résolution des problèmes](#dnf-supportinfo-troubleshooting)
+ [Ressources supplémentaires](#dnf-supportinfo-additional-resources)
## 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](#dnf-supportinfo-migration-from-legacy))
## Démarrage
1. Installez le plug-in .
```
sudo dnf install dnf-plugin-support-info
```
1. 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 supportinfo`exemple 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'`--show`indicateur 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'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, voir[SupportInfo Structure XML](dnf-supportinfo-xml-structure.md).
### 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 `` racine contient un `` é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, consultez[SupportInfo Structure XML](dnf-supportinfo-xml-structure.md).
## 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).
1. S'il n'est pas modifié, il étend le cache sans retélécharger.
1. En cas de modification, il télécharge le fichier mis à jour.
1. 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é](#dnf-supportinfo-migration-from-legacy), 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](#dnf-supportinfo-migration-from-legacy). | 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](dnf-supportinfo-migrate-v1-v2.md) 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
```
Si`legacy = 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, consultez[Migration à partir de dnf-plugin-support-info v1 à v2](dnf-supportinfo-migrate-v1-v2.md).
## Ressources supplémentaires
+ [Déclarations de support AL2023 (lisibles par l'homme) ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html)
+ [Plugin DNF Support Info sur GitHub ](https://github.com/amazonlinux/dnf-plugin-support-info)
+ [bibliothèque d'analyse amazon-linux-supportinfo sur GitHub ](https://github.com/amazonlinux/amazon-linux-supportinfo)