View a markdown version of this page

Utilizzo di informazioni di supporto dnf Plug-in - Amazon Linux 2023
PrerequisitiNozioni di basePacchetti di interrogazioneFiltrare i pacchettiOutput strutturatoGestisci la cacheNon-root UtilizzoInformazioni di riferimento sulla configurazioneRiferimento ai campi di outputSchemaMigrazione da Legacy PluginRisoluzione dei problemiRisorse aggiuntive

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

Utilizzo di informazioni di supporto dnf Plug-in

Il dnf-plugin-support-info pacchetto fornisce il dnf supportinfo comando per AL2023. Usa questo comando per richiedere informazioni sul ciclo di vita e sul supporto dei pacchetti: scopri se un pacchetto è attualmente supportato, quali livelli di gravità ricevono le patch e quando cambia lo stato del supporto.

Per una panoramica riassuntiva di tutte le dichiarazioni di supporto dei pacchetti, consulta le dichiarazioni di supporto AL2023 nelle note di rilascio di AL2023.

Importante

Il plugin v2 viene fornito con in. legacy = 1 /etc/dnf/plugins/supportinfo.conf In questa modalità, l'output utilizza i nomi e il formato dei campi v1. In una futura versione trimestrale AL2023, l'impostazione predefinita cambia inlegacy = 0, passando al formato di output v2 documentato in questa pagina. Per iniziare subito a utilizzare l'output v2, imposta la tua configurazione. legacy = 0 Per i dettagli sulle modifiche, consultaMigrazione da dnf-plugin-support-info da v1 a v2.

Prerequisiti

  • Istanza AL2023

  • Il dnf-plugin-support-info pacchetto (disponibile nei repository AL2023 predefiniti)

  • Non sono richiesti privilegi di root (tranne --sync in modalità legacy)

Nozioni di base

  1. Installa il plugin .

    sudo dnf install dnf-plugin-support-info

  2. Interroga un pacchetto per verificare l'installazione.

    dnf supportinfo --pkg glibc

    L'output mostra lo stato e la tempistica del supporto del pacchetto:

    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

Pacchetti di interrogazione

Pass --pkg con uno o più nomi di pacchetti per visualizzarne le informazioni di supporto.

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

Per richiedere un pacchetto specifico

L'dnf supportinfoesempio seguente interroga un pacchetto che ha raggiunto la fine del ciclo di vita:

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

Per interrogare più pacchetti

dnf supportinfo --pkg glibc bash openssl

Filtrare i pacchetti

Il --show flag filtra i pacchetti per stato, livello di supporto o entrambi.

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

Tipi di filtro

Categoria Valori Origine
Filtri di stato (fissi) installed, available, unavailable, all Integrato nel plugin
Filtri a livello di supporto (dinamici) Varia. Ad esempiofull_support, eos Caricato da <support_level> voci nel file XML delle informazioni di supporto
Nota

I filtri del livello di supporto sono dinamici. Provengono direttamente dai dati XML delle informazioni di supporto definiti dal fornitore del sistema operativo. I valori disponibili dipendono da ciò che AL2023 definisce attualmente. Esegui --list-filters per visualizzare il set corrente di valori di filtro validi. Per informazioni su come vengono dichiarati questi livelli, vedereSupportInfo Struttura XML.

Logica di filtro

  • I filtri di stato multipli si combinano con OR: --show installed available corrisponde ai pacchetti installati O disponibili.

  • Più filtri a livello di supporto si combinano con OR: --show full_support eos corrisponde ai pacchetti a livello di eos supporto full_support OR.

  • Quando si combinano entrambi i tipi, si combinano con AND: --show installed eos corrisponde ai pacchetti installati AND a livello di eos supporto.

Nota

Se il nome di un filtro esiste in entrambe le categorie di stato e di supporto, il plug-in corrisponde a entrambe. Usa la sintassi del prefisso per disambiguare: o. state:NAME support:NAME

Per elencare i filtri disponibili

Esegui --list-filters per visualizzare tutti i valori di filtro validi raggruppati per categoria:

dnf supportinfo --list-filters

Output di esempio:

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

Per filtrare i pacchetti installati

dnf supportinfo --show installed

L'output elenca ogni pacchetto in una tabella con il relativo livello di supporto e lo stato corrente:

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

Per filtrare i pacchetti installati a un livello di supporto specifico

dnf supportinfo --show installed eos

Per utilizzare la sintassi del prefisso per la disambiguazione

dnf supportinfo --show state:installed support:full_support

Output strutturato

Per lo scripting e l'automazione e per --showxml produrre output --showjson leggibili dalla macchina.

Per ottenere un output JSON

dnf supportinfo --pkg nodejs20 --showjson

L'output contiene la fase attuale, l'origine e la cronologia completa del pacchetto con dettagli sul livello di supporto:

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

Per ottenere un output XML

dnf supportinfo --pkg nodejs20 --showxml

L'output è un documento XML con una <package_support> radice contenente un <statement> elemento per ciclo di vita, ciascuno con le sue fasi, date di inizio e dettagli sul livello di supporto. Per il riferimento completo allo schema, vedere. SupportInfo Struttura XML

Gestisci la cache

Il plugin memorizza nella cache le informazioni di supporto XML localmente per ridurre le richieste di rete.

Comportamento della cache

Quando la cache scade:

  1. Il plugin controlla se il file remoto è cambiato (usando HTTP ETag).

  2. Se rimane invariato, estende la cache senza doverlo scaricare nuovamente.

  3. Se modificato, scarica il file aggiornato.

  4. In caso di errori di rete, torna al file memorizzato nella cache, se ne esiste uno.

Per sincronizzare la cache

Scarica e memorizza nella cache i dati più recenti relativi all'assistenza:

dnf supportinfo --sync

Usalo per l'automazione e i cron job che richiedono dati di supporto aggiornati senza eseguire una query completa.

Per cancellare la cache

dnf supportinfo --clean-cache

Non-root Utilizzo

Tutti i comandi funzionano senza privilegi di root. Quando viene eseguito come root, la cache viene archiviata in/var/cache/dnf/support-info/. Quando viene eseguita come utente non root, la cache va a/var/tmp/dnf-username-*/support-info/. Ciò segue la convenzione standard di DNF per le directory temporanee per utente.

Nota

Se abiliti la modalità legacy, esegui sudo dnf supportinfo --sync una sola operazione per creare il file legacy. Dopodiché, le query non root funzionano normalmente.

Informazioni di riferimento sulla configurazione

Il plugin legge la configurazione da. /etc/dnf/plugins/supportinfo.conf L'esempio seguente mostra la configurazione consigliata con la modalità legacy disabilitata:

[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
Opzione Description Predefinita
baseurl URL del file XML delle informazioni di supporto. Supporta variabili DNF come$awsregion. Richiesto
templateurl URL allo schema XSD per la convalida. Nessuno
metadata_expire Durata della cache in secondi. Usa -1 per infinito, 0 per controllare sempre. 1800
legacy Abilita l'output compatibile con la versione 1. Impostato su o. 1 0 Vedi Migrazione dal plug-in precedente. 1

Riferimento ai campi di output

Campo Description
Nome Nome pacchetto
Versione Versione installata o disponibile
Stato installed, available o unavailable
Stato attuale Fase attuale del ciclo di vita, ad esempio o Supported End of Life
Priorità delle patch Nome del livello di supporto
Descrizione del livello di supporto Human-readable descrizione del livello di supporto
Severità coperte Livelli di gravità della sicurezza che ricevono le patch
Origin Repository che fornisce il pacchetto
Cronologia dell'assistenza Elenco cronologico delle fasi del ciclo di vita con date
Nota sul pacchetto Contesto aggiuntivo, ad esempio le date EOL a monte

Schema

Il formato dei dati delle informazioni di supporto è definito da uno schema XSD. Usa questo schema per convalidare gli strumenti personalizzati che utilizzano direttamente le informazioni di supporto XML:

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

Migrazione da Legacy Plugin

Se in precedenza hai utilizzato una versione precedente del dnf-plugin-support-info pacchetto, il nuovo plug-in v2 viene fornito di legacy = 1 default per mantenere la compatibilità con le versioni precedenti. In una futura versione trimestrale AL2023, le modifiche predefinite legacy = 0 e l'output passa al formato v2 documentato in questa pagina.

Se disponete di script o strumenti che analizzano l'output del plug-in o leggono direttamente il file XML precedente, consultate l'elenco completo delle differenze, before/after degli Migrazione da dnf-plugin-support-info da v1 a v2 esempi e una lista di controllo dettagliata sulla migrazione.

Per mantenere il comportamento precedente dopo la transizione, imposta. legacy = 1 /etc/dnf/plugins/supportinfo.conf Si tratta di una misura temporanea. La modalità Legacy richiede i privilegi di root --sync e verrà rimossa in una versione futura.

Risoluzione dei problemi

Dati della cache obsoleti

Sintomo: i risultati delle query mostrano informazioni di supporto obsolete.

Risoluzione: sincronizza la cache manualmente:

dnf supportinfo --sync

Se il problema persiste, cancella e risincronizza:

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

File precedente non trovato

Sintomo: gli script in lettura hanno /usr/lib/python*/site-packages/dnf-plugins/support_info.xml esito negativo e viene visualizzato il messaggio «file non trovato».

Risoluzione: il plugin crea il file precedente solo quando lo imposti legacy = 1 ed esegui --sync almeno una volta:

sudo dnf supportinfo --sync

In caso contrariolegacy = 0, il file non viene più mantenuto. Esegui invece la migrazione dei tuoi script per usarli --showjson o produrli--showxml. Per le fasi di migrazione, consulta. Migrazione da dnf-plugin-support-info da v1 a v2

Risorse aggiuntive