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 ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html) 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 in`legacy = 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, consulta[Migrazione da dnf-plugin-support-info da v1 a v2](dnf-supportinfo-migrate-v1-v2.md).
**Topics**
+ [Prerequisiti](#dnf-supportinfo-prerequisites)
+ [Nozioni di base](#dnf-supportinfo-getting-started)
+ [Pacchetti di interrogazione](#dnf-supportinfo-query-packages)
+ [Filtrare i pacchetti](#dnf-supportinfo-filter-packages)
+ [Output strutturato](#dnf-supportinfo-structured-output)
+ [Gestisci la cache](#dnf-supportinfo-manage-cache)
+ [Non-root Utilizzo](#dnf-supportinfo-non-root)
+ [Informazioni di riferimento sulla configurazione](#dnf-supportinfo-configuration-reference)
+ [Riferimento ai campi di output](#dnf-supportinfo-output-fields)
+ [Schema](#dnf-supportinfo-schema)
+ [Migrazione da Legacy Plugin](#dnf-supportinfo-migration-from-legacy)
+ [Risoluzione dei problemi](#dnf-supportinfo-troubleshooting)
+ [Risorse aggiuntive](#dnf-supportinfo-additional-resources)
## 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) ](#dnf-supportinfo-migration-from-legacy)
## Nozioni di base
1. Installa il plugin .
```
sudo dnf install dnf-plugin-support-info
```
1. 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 supportinfo`esempio 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 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, vedere[SupportInfo Struttura XML](dnf-supportinfo-xml-structure.md).
### 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 `` radice contenente un `` 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](dnf-supportinfo-xml-structure.md)
## 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).
1. Se rimane invariato, estende la cache senza doverlo scaricare nuovamente.
1. Se modificato, scarica il file aggiornato.
1. 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](#dnf-supportinfo-migration-from-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](#dnf-supportinfo-migration-from-legacy). | 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](dnf-supportinfo-migrate-v1-v2.md) 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 contrario`legacy = 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](dnf-supportinfo-migrate-v1-v2.md)
## Risorse aggiuntive
+ [Dichiarazioni di supporto AL2023 (leggibili dall'uomo) ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html)
+ [Plugin DNF Support Info attivo GitHub ](https://github.com/amazonlinux/dnf-plugin-support-info)
+ [Libreria di analisi amazon-linux-supportinfo attiva GitHub ](https://github.com/amazonlinux/amazon-linux-supportinfo)