

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwendung der DNF-Supportinformationen Plug-In
<a name="dnf-supportinfo-user-guide"></a>

Das dnf-plugin-support-info Paket enthält den `dnf supportinfo` Befehl für AL2023. Verwenden Sie diesen Befehl, um Lebenszyklus- und Supportinformationen für Pakete abzufragen: Finden Sie heraus, ob ein Paket derzeit unterstützt wird, für welche Schweregrade Patches gelten und wann sich der Support-Status ändert.

Eine Zusammenfassung aller Hinweise zur Paketunterstützung finden Sie in den [ AL2023 Support Statements ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html) in den * AL2023 Release Notes. *

**Wichtig**  
Das v2-Plugin wird mit `legacy = 1` in geliefert. `/etc/dnf/plugins/supportinfo.conf` In diesem Modus verwendet die Ausgabe die v1-Feldnamen und das Format. In einer zukünftigen vierteljährlichen Version von AL2023 wird die Standardeinstellung auf `legacy = 0` das auf dieser Seite dokumentierte v2-Ausgabeformat umgestellt. Um jetzt mit der v2-Ausgabe zu beginnen, stellen Sie dies `legacy = 0` in Ihrer Konfiguration ein. Einzelheiten zu den Änderungen finden Sie unter[Migration von dnf-plugin-support-info v1 bis v2](dnf-supportinfo-migrate-v1-v2.md).

**Topics**
+ [Voraussetzungen](#dnf-supportinfo-prerequisites)
+ [Erste Schritte](#dnf-supportinfo-getting-started)
+ [Pakete abfragen](#dnf-supportinfo-query-packages)
+ [Pakete filtern](#dnf-supportinfo-filter-packages)
+ [Strukturierte Ausgabe](#dnf-supportinfo-structured-output)
+ [Den Cache verwalten](#dnf-supportinfo-manage-cache)
+ [Non-root Verwendung](#dnf-supportinfo-non-root)
+ [Konfigurationsreferenz](#dnf-supportinfo-configuration-reference)
+ [Referenz zu den Ausgabefeldern](#dnf-supportinfo-output-fields)
+ [Schema](#dnf-supportinfo-schema)
+ [Migration vom Legacy-Plugin](#dnf-supportinfo-migration-from-legacy)
+ [Fehlerbehebung](#dnf-supportinfo-troubleshooting)
+ [Weitere Ressourcen](#dnf-supportinfo-additional-resources)

## Voraussetzungen
<a name="dnf-supportinfo-prerequisites"></a>
+ AL2023-Instanz
+ Das dnf-plugin-support-info Paket (verfügbar in den Standard-AL2023-Repositorys)
+ Keine Root-Rechte erforderlich (außer `--sync` im [ Legacy-Modus) ](#dnf-supportinfo-migration-from-legacy)

## Erste Schritte
<a name="dnf-supportinfo-getting-started"></a>

1. Installieren Sie das -Plug-in.

   ```
   sudo dnf install dnf-plugin-support-info
   ```

1. Fragen Sie ein Paket ab, um die Installation zu überprüfen.

   ```
   dnf supportinfo --pkg glibc
   ```

   Die Ausgabe zeigt den Support-Status und den Zeitplan des Pakets:

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

## Pakete abfragen
<a name="dnf-supportinfo-query-packages"></a>

Geben Sie `--pkg` einen oder mehrere Paketnamen ein, um deren Support-Informationen anzuzeigen.

```
dnf supportinfo --pkg {{PACKAGE}} [{{PACKAGE}} ...]
```

### Um ein bestimmtes Paket abzufragen
<a name="dnf-supportinfo-query-specific"></a>

Das folgende `dnf supportinfo` Beispiel fragt ein Paket ab, das das Ende seiner Lebensdauer erreicht hat:

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

### So fragen Sie mehrere Pakete ab
<a name="dnf-supportinfo-query-multiple"></a>

```
dnf supportinfo --pkg glibc bash openssl
```

## Pakete filtern
<a name="dnf-supportinfo-filter-packages"></a>

Das `--show` Flag filtert Pakete nach Status, Unterstützungsstufe oder beidem.

```
dnf supportinfo --show {{FILTER}} [{{FILTER}} ...]
```

### Filtertypen
<a name="dnf-supportinfo-filter-types"></a>


| Kategorie | Werte | Quelle | 
| --- | --- | --- | 
| Statusfilter (behoben) | installed, available, unavailable, all | In das Plugin eingebaut | 
| Filter auf Unterstützungsniveau (dynamisch) | Variiert. Zum full\_support Beispiel eos | Wird aus <support\_level> Einträgen in der Support-Info-XML geladen | 

**Anmerkung**  
Filter auf Support-Ebene sind dynamisch. Sie stammen direkt aus den vom Betriebssystemanbieter definierten XML-Daten für Support-Informationen. Die verfügbaren Werte hängen davon ab, was AL2023 derzeit definiert. Führen Sie `--list-filters` den Befehl aus, um den aktuellen Satz gültiger Filterwerte anzuzeigen. Hinweise zur Deklaration dieser Stufen finden Sie unter[SupportInfo XML-Struktur](dnf-supportinfo-xml-structure.md).

### Logik filtern
<a name="dnf-supportinfo-filter-logic"></a>
+ Mehrere Statusfilter werden mit OR kombiniert: `--show installed available` entspricht Paketen, die installiert ODER verfügbar sind.
+ Filter mehrerer Unterstützungsebenen in Kombination mit OR: `--show full_support eos` entspricht Paketen auf der `full_support` `eos` OR-Supportstufe.
+ Wenn Sie beide Typen kombinieren, werden sie mit AND kombiniert: `--show installed eos` entspricht Paketen, die INSTALLIERT UND auf der `eos` Support-Ebene installiert sind.

**Anmerkung**  
Wenn ein Filtername sowohl in den Kategorien „Status“ als auch in der Kategorie „Support“ existiert, stimmt das Plugin mit beiden überein. Verwenden Sie die Präfix-Syntax zur Disambiguierung: oder. `state:{{NAME}}` `support:{{NAME}}`

### Um verfügbare Filter aufzulisten
<a name="dnf-supportinfo-list-filters"></a>

Ausführen`--list-filters`, um alle gültigen Filterwerte gruppiert nach Kategorien anzuzeigen:

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

Beispielausgabe:

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

### Um installierte Pakete zu filtern
<a name="dnf-supportinfo-filter-installed"></a>

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

Die Ausgabe listet jedes Paket in einer Tabelle mit seinem Unterstützungslevel und seinem aktuellen Status auf:

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

### So filtern Sie installierte Pakete auf einer bestimmten Unterstützungsstufe
<a name="dnf-supportinfo-filter-installed-level"></a>

```
dnf supportinfo --show installed eos
```

### So verwenden Sie die Präfixsyntax zur Disambiguierung
<a name="dnf-supportinfo-filter-prefix"></a>

```
dnf supportinfo --show state:installed support:full_support
```

## Strukturierte Ausgabe
<a name="dnf-supportinfo-structured-output"></a>

Für Skripterstellung und Automatisierung `--showjson` sowie für `--showxml` maschinenlesbare Ausgaben.

### Um eine JSON-Ausgabe zu erhalten
<a name="dnf-supportinfo-json-output"></a>

```
dnf supportinfo --pkg nodejs20 --showjson
```

Die Ausgabe enthält die aktuelle Phase, den Ursprung und den vollständigen Zeitplan des Pakets mit Details zur Unterstützungsebene:

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

### Um eine XML-Ausgabe zu erhalten
<a name="dnf-supportinfo-xml-output"></a>

```
dnf supportinfo --pkg nodejs20 --showxml
```

Die Ausgabe ist ein XML-Dokument mit einem `<package_support>` Stammdokument, das ein `<statement>` Element pro Lebenszyklus enthält, jedes mit seinen Phasen, Startdaten und Details zur Supportstufe. Die vollständige Schemareferenz finden Sie unter[SupportInfo XML-Struktur](dnf-supportinfo-xml-structure.md).

## Den Cache verwalten
<a name="dnf-supportinfo-manage-cache"></a>

Das Plugin speichert die Support-Info-XML lokal im Cache, um Netzwerkanfragen zu reduzieren.

### Verhalten des Caches
<a name="dnf-supportinfo-cache-behavior"></a>

Wenn der Cache abläuft:

1. Das Plugin prüft, ob sich die Remote-Datei geändert hat (mit HTTP ETag).

1. Wenn es unverändert bleibt, erweitert es den Cache, ohne ihn erneut herunterzuladen.

1. Wenn es geändert wird, wird die aktualisierte Datei heruntergeladen.

1. Bei Netzwerkfehlern wird auf die zwischengespeicherte Datei zurückgegriffen, falls eine existiert.

### Um den Cache zu synchronisieren
<a name="dnf-supportinfo-sync-cache"></a>

Laden Sie die neuesten Support-Informationsdaten herunter und speichern Sie sie im Cache:

```
dnf supportinfo --sync
```

Verwenden Sie dies für Automatisierungs- und Cron-Jobs, die aktuelle Support-Daten benötigen, ohne eine vollständige Abfrage ausführen zu müssen.

### Um den Cache zu leeren
<a name="dnf-supportinfo-clean-cache"></a>

```
dnf supportinfo --clean-cache
```

## Non-root Verwendung
<a name="dnf-supportinfo-non-root"></a>

Alle Befehle funktionieren ohne Root-Rechte. Wenn der Cache als Root ausgeführt wird, wird er unter gespeichert`/var/cache/dnf/support-info/`. Wenn der Cache als Benutzer ausgeführt wird, der kein Root-Benutzer ist, wird er in das Verzeichnis verschoben`/var/tmp/dnf-{{username}}-*/support-info/`. Dies folgt der DNF-Standardkonvention für temporäre Verzeichnisse pro Benutzer.

**Anmerkung**  
Wenn Sie den [ Legacy-Modus aktivieren](#dnf-supportinfo-migration-from-legacy), führen Sie ihn `sudo dnf supportinfo --sync` einmal aus, um die Legacy-Datei zu erstellen. Danach funktionieren Abfragen, die nichts mit Root zu tun haben, normal.

## Konfigurationsreferenz
<a name="dnf-supportinfo-configuration-reference"></a>

Das Plugin liest die Konfiguration von`/etc/dnf/plugins/supportinfo.conf`. Das folgende Beispiel zeigt die empfohlene Konfiguration mit deaktiviertem Legacy-Modus:

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


| Option | Description | Standard | 
| --- | --- | --- | 
| baseurl | URL zur XML-Datei mit den Support-Informationen. Unterstützt DNF-Variablen wie$awsregion. | Erforderlich | 
| templateurl | URL zum XSD-Schema zur Validierung. | Keine | 
| metadata\_expire | Cachedauer in Sekunden. Verwenden Sie -1 für unendlich, 0 um immer zu überprüfen. | 1800 | 
| legacy | Aktiviert die v1-kompatible Ausgabe. Auf oder setzen. 1 0 Siehe [ Migration vom Legacy-Plugin](#dnf-supportinfo-migration-from-legacy). | 1 | 

## Referenz zu den Ausgabefeldern
<a name="dnf-supportinfo-output-fields"></a>


| Feld | Description | 
| --- | --- | 
| Name | Package name | 
| Version | Installierte oder verfügbare Version | 
| Status | installed, available oder unavailable | 
| Aktueller Status | Aktuelle Lebenszyklusphase, wie z. B. Supported oder End of Life | 
| Patch-Priorität | Name der Unterstützungsstufe | 
| Beschreibung der Unterstützungsstufe | Human-readable Beschreibung der Unterstützungsstufe | 
| Abgedeckte Schweregrade | Sicherheitsschweregrade, für die Patches bereitgestellt werden | 
| Origin | Repository, das das Paket bereitstellt | 
| Zeitplan für den Support | Chronologische Liste der Lebensphasen mit Daten | 
| Hinweis zum Paket | Zusätzlicher Kontext, z. B. Upstream-EOL-Daten | 

## Schema
<a name="dnf-supportinfo-schema"></a>

Das Datenformat für Support-Informationen wird durch ein XSD-Schema definiert. Verwenden Sie dieses Schema, um benutzerdefinierte Tools zu validieren, die das Support-Info-XML direkt verwenden:

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

## Migration vom Legacy-Plugin
<a name="dnf-supportinfo-migration-from-legacy"></a>

Wenn Sie zuvor eine frühere Version des dnf-plugin-support-info Pakets verwendet haben, wird das neue v2-Plugin `legacy = 1` standardmäßig mitgeliefert, um die Abwärtskompatibilität aufrechtzuerhalten. In einer zukünftigen vierteljährlichen Version von AL2023 werden die Standardänderungen `legacy = 0` und die Ausgabe auf das auf dieser Seite dokumentierte v2-Format umgestellt.

Wenn Sie über Skripts oder Tools verfügen, die die Plugin-Ausgabe analysieren oder die ältere XML-Datei direkt lesen, finden Sie unter [Migration von dnf-plugin-support-info v1 bis v2](dnf-supportinfo-migrate-v1-v2.md) eine vollständige Liste der Unterschiede, before/after Beispiele und eine schrittweise Migrationscheckliste.

Um das alte Verhalten nach der Umstellung beizubehalten, schalten Sie ein. `legacy = 1` `/etc/dnf/plugins/supportinfo.conf` Dies ist eine vorübergehende Maßnahme. Der Legacy-Modus erfordert Root-Rechte für `--sync` und wird in einer zukünftigen Version entfernt.

## Fehlerbehebung
<a name="dnf-supportinfo-troubleshooting"></a>

### Veraltete Cache-Daten
<a name="dnf-supportinfo-troubleshooting-stale-cache"></a>

**Symptom: Die ** Abfrageergebnisse zeigen veraltete Supportinformationen.

**Lösung: ** Synchronisieren Sie den Cache manuell:

```
dnf supportinfo --sync
```

Wenn das Problem weiterhin besteht, löschen Sie den Vorgang und synchronisieren Sie ihn erneut:

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

### Legacy-Datei wurde nicht gefunden
<a name="dnf-supportinfo-troubleshooting-legacy-file"></a>

**Symptom: ** Skripts, die lesen, `/usr/lib/python*/site-packages/dnf-plugins/support_info.xml` schlagen mit der Meldung „Datei nicht gefunden“ fehl.

**Lösung: ** Das Plugin erstellt die Legacy-Datei nur, wenn Sie Folgendes festgelegt `legacy = 1` und `--sync` mindestens einmal ausgeführt haben:

```
sudo dnf supportinfo --sync
```

Wenn`legacy = 0`, wird die Datei nicht mehr verwaltet. Migrieren Sie stattdessen Ihre Skripte, um sie zu verwenden `--showjson` oder `--showxml` auszugeben. Die Schritte zur Migration finden Sie unter[Migration von dnf-plugin-support-info v1 bis v2](dnf-supportinfo-migrate-v1-v2.md).

## Weitere Ressourcen
<a name="dnf-supportinfo-additional-resources"></a>
+ [AL2023-Supporterklärungen (für Menschen lesbar) ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html)
+ [Das DNF Support Info-Plugin ist aktiviert GitHub ](https://github.com/amazonlinux/dnf-plugin-support-info)
+ [Die Analysebibliothek amazon-linux-supportinfo ist aktiviert GitHub ](https://github.com/amazonlinux/amazon-linux-supportinfo)