Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Migrazione da dnf-plugin-support-info da v1 a v2
<a name="dnf-supportinfo-migrate-v1-v2"></a>

Il dnf-plugin-support-info pacchetto ha una nuova versione principale (v2) con un formato di output riprogettato. Questa guida ti aiuta ad aggiornare qualsiasi script o strumento che analizza l'output. `dnf supportinfo`

Durante il periodo di transizione, il plugin v2 viene fornito con `legacy = 1` in, che preserva `/etc/dnf/plugins/supportinfo.conf` l'output compatibile con la v1. Dopo aver aggiornato gli script, impostate il passaggio `legacy = 0` all'output v2.

**Topics**
+ [Panoramica di](#dnf-supportinfo-migrate-overview)
+ [Modifiche sostanziali che richiedono un'azione](#dnf-supportinfo-migrate-breaking-changes)
+ [Cosa non cambia](#dnf-supportinfo-migrate-unchanged)
+ [Periodo di transizione](#dnf-supportinfo-migrate-transition-period)

## Panoramica di
<a name="dnf-supportinfo-migrate-overview"></a>

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


| Event | Timing (Tempo) | 
| --- | --- | 
| plugin v2 () disponibile dnf-plugin-support-info 2.0 | Adesso | 
| Il plug-in viene fornito con legacy = 1 (output compatibile con v1) | Versione iniziale v2 | 
| Modifiche predefinite a legacy = 0 | Una futura versione trimestrale AL2023 | 
| il formato v1 non è più mantenuto | Dopo il periodo di transizione | 

### Cosa devi fare
<a name="dnf-supportinfo-migrate-what-to-do"></a>

Se disponi di script che analizzano l'output della console, l'output XML o leggono il file XML dal disco, aggiornali per gestire i nuovi nomi dei campi, la struttura e i percorsi dei file. Se lo usi`--showjson`, i tuoi script non necessitano di modifiche, perché l'output JSON è identico tra v1 e v2. Se leggi il file XML direttamente dal disco, passa al download dell'XML dal file configurato o utilizzato. `baseurl` `dnf supportinfo --show installed --showxml`

## Modifiche sostanziali che richiedono un'azione
<a name="dnf-supportinfo-migrate-breaking-changes"></a>

### Se si analizza l'output della console
<a name="dnf-supportinfo-migrate-console-output"></a>

#### Campi di dettaglio
<a name="dnf-supportinfo-migrate-detail-fields"></a>

Il plugin ha modificato le etichette dei campi visualizzate quando si interroga un pacchetto specifico:


| etichetta v1 | etichetta v2 | Note | 
| --- | --- | --- | 
| Stato del supporto | Stato attuale | Rinominato | 
| Periodi di assistenza | Cronologia dell'assistenza | Rinominato, spostato alla fine dell'output | 
| Dichiarazione di supporto | (rimosso)  | Non più visualizzato | 
| Link | Link | Invariato (mostrato quando disponibile) | 
| Altre informazioni | Altre informazioni | Invariato (mostrato quando disponibile) | 
| (non presente)  | Priorità delle patch | Nuovo campo | 
| (non presente)  | Descrizione del livello di supporto | Nuovo campo | 
| (non presente)  | Severità coperte | Nuovo campo | 
| (non presente)  | Origin | Nuovo campo | 

La colonna dell'etichetta del campo è ora larga 28 caratteri (in precedenza 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
```

#### Colonne di tabella
<a name="dnf-supportinfo-migrate-table-columns"></a>

La tabella riassuntiva è passata da 6 colonne a 7. La tabella v2 mostra anche una riga di intestazione (v1 no):


| colonna v1 | colonna v2 | Modifica | 
| --- | --- | --- | 
| Nome | Pacchetto | Rinominato | 
| Versione | Versione | Invariato | 
| Stato | Stato | Invariato | 
| Stato del supporto | Stato attuale | Rinominato | 
| (non presente)  | Livello di supporto | Nuova colonna | 
| Data (ad esempio2029-06-30) | Fino alla (Fase successiva) (ad esempio2029-06-30 (end\_of\_support)) | Rinominato, formato modificato | 
| Nota | Nota | Invariato | 

**Importante**  
La colonna della data ora include il nome della fase successiva tra parentesi. Se analizzi questo campo, aggiorna la logica dell'espressione regolare o dei delimitatori.

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

### Se si analizza l'output di `--showxml`
<a name="dnf-supportinfo-migrate-xml-output"></a>

L'`--showxml`output v2 utilizza una struttura XML diversa da quella della v1. L'`<package_support>`elemento principale è lo stesso, ma gli elementi secondari, gli attributi e la gerarchia sono cambiati.

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

Principali differenze strutturali:
+ v1 utilizza gli `end_date` attributi `marker``start_date`,, su `<statement>` with`<summary>`,`<text>`, children `<link>`
+ v2 utilizza `current_phase` attributi ed `<phases>` elementi annidati con dettagli sul livello di supporto
+ v2 omette `<covered_severities>` completamente quando è vuoto (invece di un elemento vuoto)
+ Gli elementi del pacchetto v2 includono e attributi `state` `origin`
+ v2 non include `<summary>``<text>`, o elementi `<link>`

### Se leggi il file XML direttamente dal disco
<a name="dnf-supportinfo-migrate-xml-file"></a>

Il plugin v1 ha raggruppato il suo file di dati in:

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

**avvertimento**  
Questo file non viene più aggiornato una volta entrato in `legacy = 0` vigore. Non fare affidamento su questo percorso per i dati correnti.

Il plugin v2 memorizza i dati nella cache `/var/cache/dnf/support-info/` quando viene eseguito come root. Quando viene eseguito come utente non root, utilizza, seguendo la convenzione standard di DNF`/var/tmp/dnf-{{username}}-*/support-info/`, le directory temporanee per utente. I file in queste directory utilizzano nomi di file indirizzati al contenuto e non sono stabili. Non analizzarli direttamente.

**Alternative consigliate: **

1. Scarica l'XML direttamente dall'URL configurato:

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

1. Usa la CLI per ottenere un output strutturato per i pacchetti installati:

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

### Se si filtra con --show ``
<a name="dnf-supportinfo-migrate-show-filter"></a>

I valori accettati dal `--show` filtro sono cambiati:


| valori del filtro v1 | valori del filtro v2 | 
| --- | --- | 
| supported | full\_support | 
| unsupported | eos | 

i filtri v1 sono nomi di ** fase ** (`supported`,`unsupported`). I filtri v2 sono nomi di livello di ** supporto ** (`full_support`,`eos`, ecc.).

Corri `--list-filters` per scoprire i valori di filtro disponibili sul tuo sistema:

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

## Cosa non cambia
<a name="dnf-supportinfo-migrate-unchanged"></a>

Una volta installata la dnf-plugin-support-info v2, quanto segue rimane invariato indipendentemente dall'`legacy`impostazione:
+ **`--showjson`uscita. ** L'output JSON è identico indipendentemente dal fatto che `legacy` sia `0` o`1`, perché il plug-in si normalizza alla struttura interna della v2 prima della formattazione.
+ **Argomenti CLI. ** Tutti i flag (`--pkg`,,`--show`,`--showxml`,`--showjson`, `--clean-cache``--list-filters`,`--sync`) funzionano in entrambe le modalità.
+ **Nome del comando. ** Corri ancora`dnf supportinfo`.

**Nota**  
I `--sync` flag `--showjson``--clean-cache`,`--list-filters`, e sono nuovi nella v2 e non sono disponibili nella v1.

## Periodo di transizione
<a name="dnf-supportinfo-migrate-transition-period"></a>

Il plugin v2 viene fornito con `legacy = 1` in`/etc/dnf/plugins/supportinfo.conf`. Durante questo periodo:

1. Il plugin scarica i dati v2 dall'URL configurato.

1. L'output della console, l'output XML e i valori dei filtri continuano a comportarsi come v1.

1. Il file XML in formato v1 rimane disponibile nel vecchio percorso, quindi gli script esistenti continuano a funzionare.

In una futura versione trimestrale AL2023, l'impostazione predefinita diventa. `legacy = 0` A quel punto:
+ L'output della console utilizza i nomi e la struttura dei campi v2.
+ `--showxml`produce il nuovo formato basato sulle fasi.
+ `--show`i valori dei filtri vengono modificati per supportare i nomi dei livelli.
+ Il file XML v1 nel vecchio percorso non viene più aggiornato.

**Per mantenere temporaneamente l'output compatibile con la v1**, imposta: `legacy = 1` `/etc/dnf/plugins/supportinfo.conf`

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

**Importante**  
L'`legacy = 1`opzione è un bridge temporaneo. Pianificate di migrare i vostri strumenti all'output v2 anziché affidarvi a questa impostazione a tempo indeterminato.