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.

# Migration à partir de dnf-plugin-support-info v1 à v2
<a name="dnf-supportinfo-migrate-v1-v2"></a>

Le dnf-plugin-support-info package dispose d'une nouvelle version majeure (v2) avec un format de sortie repensé. Ce guide vous aide à mettre à jour tous les scripts ou outils qui analysent les résultats. `dnf supportinfo`

Pendant la période de transition, le plugin v2 est livré avec `legacy = 1` in`/etc/dnf/plugins/supportinfo.conf`, ce qui préserve la sortie compatible avec la v1. Une fois que vous avez mis à jour vos scripts, configurez `legacy = 0` pour passer à la sortie v2.

**Topics**
+ [Vue d’ensemble](#dnf-supportinfo-migrate-overview)
+ [Changements majeurs qui nécessitent une action](#dnf-supportinfo-migrate-breaking-changes)
+ [Ce qui ne change pas](#dnf-supportinfo-migrate-unchanged)
+ [Période de transition](#dnf-supportinfo-migrate-transition-period)

## Vue d’ensemble
<a name="dnf-supportinfo-migrate-overview"></a>

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


| Événement | Timing (Durée) | 
| --- | --- | 
| plugin v2 (dnf-plugin-support-info 2.0) disponible | Maintenant | 
| Le plugin est livré avec legacy = 1 (sortie compatible avec la version 1) | Version initiale de la v2 | 
| La valeur par défaut passe à legacy = 0 | Une prochaine publication trimestrielle pour AL2023 | 
| le format v1 n'est plus maintenu | Après la période de transition | 

### Ce que vous devez faire
<a name="dnf-supportinfo-migrate-what-to-do"></a>

Si vous disposez de scripts qui analysent la sortie de la console, la sortie XML ou lisent le fichier XML depuis le disque, mettez-les à jour pour gérer les nouveaux noms de champs, la nouvelle structure et les nouveaux chemins de fichier. Si vous l'utilisez`--showjson`, vos scripts n'ont pas besoin d'être modifiés, car la sortie JSON est identique entre la v1 et la v2. Si vous lisez le fichier XML directement depuis le disque, passez au téléchargement du fichier XML depuis le périphérique configuré `baseurl` ou utilisez-le`dnf supportinfo --show installed --showxml`.

## Changements majeurs qui nécessitent une action
<a name="dnf-supportinfo-migrate-breaking-changes"></a>

### Si vous analysez la sortie de la console
<a name="dnf-supportinfo-migrate-console-output"></a>

#### Champs de détail
<a name="dnf-supportinfo-migrate-detail-fields"></a>

Le plugin a modifié les libellés des champs qu'il affiche lorsque vous interrogez un package spécifique :


| étiquette v1 | étiquette v2 | Remarques | 
| --- | --- | --- | 
| État du support | État actuel | Renommé | 
| Périodes de support | Chronologie du support | Renommé, déplacé vers la fin de la sortie | 
| Déclaration de soutien | (supprimé)  | Ne s'affiche plus | 
| Lien | Lien | Inchangé (affiché lorsqu'il est disponible) | 
| Autres informations | Autres informations | Inchangé (affiché lorsqu'il est disponible) | 
| (non présent)  | Priorité des correctifs | Nouveau domaine | 
| (non présent)  | Description du niveau de support | Nouveau domaine | 
| (non présent)  | Gravités couvertes | Nouveau domaine | 
| (non présent)  | Origin | Nouveau domaine | 

La colonne du libellé du champ comporte désormais 28 caractères (au lieu de 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
```

#### Colonnes de la table
<a name="dnf-supportinfo-migrate-table-columns"></a>

Le tableau récapitulatif est passé de 6 colonnes à 7. Le tableau v2 affiche également une ligne d'en-tête (ce n'est pas le cas pour la v1) :


| colonne v1 | colonne v2 | Modifier | 
| --- | --- | --- | 
| Nom | Package | Renommé | 
| Version | Version | Inchangé | 
| State | State | Inchangé | 
| État du support | État actuel | Renommé | 
| (non présent)  | Niveau de support | Nouvelle colonne | 
| Date (telle que2029-06-30) | Jusqu'à (phase suivante) (par exemple2029-06-30 (end\_of\_support)) | Renommé, format modifié | 
| Remarque | Remarque | Inchangé | 

**Important**  
La colonne de date inclut désormais le nom de la phase suivante entre parenthèses. Si vous analysez ce champ, mettez à jour votre logique de regex ou de délimiteur.

**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 vous analysez la sortie de `--showxml`
<a name="dnf-supportinfo-migrate-xml-output"></a>

La `--showxml` sortie v2 utilise une structure XML différente de celle de la v1. L'`<package_support>`élément racine est le même, mais les éléments enfants, les attributs et la hiérarchie ont changé.

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

Principales différences structurelles :
+ La v1 utilise `marker``start_date`, `end_date` attributs sur `<statement>` `<summary>` with`<text>`, `<link>` children
+ La v2 utilise des `current_phase` attributs et des `<phases>` éléments imbriqués avec des détails sur le niveau de support
+ La v2 omet `<covered_severities>` complètement lorsqu'elle est vide (au lieu d'un élément vide)
+ Les éléments du package v2 incluent `state` et leurs `origin` attributs
+ La v2 n'inclut pas `<summary>``<text>`, ou `<link>` des éléments

### Si vous lisez le fichier XML directement depuis le disque
<a name="dnf-supportinfo-migrate-xml-file"></a>

Le plugin v1 a regroupé son fichier de données à l'adresse suivante :

```
/usr/lib/python*/site-packages/dnf-plugins/support_info.xml
```

**Avertissement**  
Ce fichier n'est plus mis à jour une fois `legacy = 0` qu'il prend effet. Ne vous fiez pas à ce chemin pour les données actuelles.

Le plugin v2 met en cache les données `/var/cache/dnf/support-info/` lorsqu'il est exécuté en tant que root. Lorsqu'il est exécuté en tant qu'utilisateur non root, il utilise`/var/tmp/dnf-{{username}}-*/support-info/`, conformément à la convention standard de DNF pour les répertoires temporaires par utilisateur. Les fichiers de ces répertoires utilisent des noms de fichiers dont le contenu est adressé et ne sont pas stables. Ne les analysez pas directement.

**Alternatives recommandées : **

1. Téléchargez le fichier XML directement à partir de l'URL configurée :

   ```
   https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml
   ```

1. Utilisez la CLI pour obtenir une sortie structurée pour les packages installés :

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

### Si vous filtrez avec `--show`
<a name="dnf-supportinfo-migrate-show-filter"></a>

Les valeurs acceptées par le `--show` filtre ont changé :


| valeurs du filtre v1 | valeurs du filtre v2 | 
| --- | --- | 
| supported | full\_support | 
| unsupported | eos | 

Les filtres v1 sont des noms de ** phase ** (`supported`,`unsupported`). Les filtres v2 sont des noms de niveaux de ** support ** (`full_support``eos`,, etc.).

Exécutez `--list-filters` pour découvrir les valeurs de filtre disponibles sur votre système :

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

## Ce qui ne change pas
<a name="dnf-supportinfo-migrate-unchanged"></a>

Une fois la dnf-plugin-support-info v2 installée, les paramètres suivants restent les mêmes quel que soit le `legacy` réglage :
+ **`--showjson`sortie. ** La sortie JSON est identique, que ce `legacy` soit `0` ou non`1`, car le plugin se normalise à la structure interne de la v2 avant le formatage.
+ **Arguments CLI. ** Tous les indicateurs (`--pkg`,`--show`,`--showxml`,`--showjson`,`--clean-cache`,`--list-filters`,`--sync`) fonctionnent dans les deux modes.
+ **Nom de la commande. ** Tu cours toujours`dnf supportinfo`.

**Note**  
Les `--sync` indicateurs `--showjson``--clean-cache`,`--list-filters`, et sont nouveaux dans la v2 et ne sont pas disponibles dans la v1.

## Période de transition
<a name="dnf-supportinfo-migrate-transition-period"></a>

Le plugin v2 est livré avec `legacy = 1``/etc/dnf/plugins/supportinfo.conf`. Pendant cette période :

1. Le plugin télécharge les données v2 à partir de l'URL configurée.

1. La sortie de la console, la sortie XML et les valeurs de filtre continuent de se comporter comme dans la version v1.

1. Le fichier XML au format v1 reste disponible à l'ancien chemin afin que les scripts existants continuent de fonctionner.

Dans une prochaine version trimestrielle d'AL2023, la valeur par défaut sera. `legacy = 0` À ce moment-là :
+ La sortie de la console utilise les noms de champs et la structure de la v2.
+ `--showxml`produit le nouveau format basé sur les phases.
+ `--show`les valeurs de filtre sont remplacées par des noms de niveaux de support.
+ Le fichier XML v1 situé à l'ancien chemin n'est plus mis à jour.

**Pour conserver temporairement une sortie compatible avec la version 1**, configurez `legacy = 1` : `/etc/dnf/plugins/supportinfo.conf`

```
[main]
legacy = 1
```

**Important**  
L'`legacy = 1`option est un pont temporaire. Prévoyez de migrer votre outillage vers la sortie v2 plutôt que de vous fier à ce paramètre indéfiniment.