View a markdown version of this page

Migrazione da dnf-plugin-support-info da v1 a v2 - Amazon Linux 2023
Panoramica diModifiche sostanziali che richiedono un'azioneCosa non cambiaPeriodo di transizione

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

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.

Panoramica di

Sequenza temporale

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

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

Se si analizza l'output della console

Campi di dettaglio

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

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

L'--showxmloutput 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 markerstart_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

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

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

    dnf supportinfo --show installed --showxml

Se si filtra con --show

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

Una volta installata la dnf-plugin-support-info v2, quanto segue rimane invariato indipendentemente dall'legacyimpostazione:

  • --showjsonuscita. L'output JSON è identico indipendentemente dal fatto che legacy sia 0 o1, 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 ancoradnf supportinfo.

Nota

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

Periodo di transizione

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.

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

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

  • --showxmlproduce il nuovo formato basato sulle fasi.

  • --showi 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 = 1opzione è un bridge temporaneo. Pianificate di migrare i vostri strumenti all'output v2 anziché affidarvi a questa impostazione a tempo indeterminato.