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.

# Migration von dnf-plugin-support-info v1 bis v2
<a name="dnf-supportinfo-migrate-v1-v2"></a>

Das dnf-plugin-support-info Paket hat eine neue Hauptversion (v2) mit einem neu gestalteten Ausgabeformat. Dieses Handbuch hilft Ihnen dabei, alle Skripte oder Tools zu aktualisieren, die die Ausgabe analysieren`dnf supportinfo`.

Während der Übergangsphase wird das v2-Plugin mit `legacy = 1` in ausgeliefert`/etc/dnf/plugins/supportinfo.conf`, wodurch die v1-kompatible Ausgabe erhalten bleibt. Sobald Sie Ihre Skripte aktualisiert haben, stellen Sie sie so ein, `legacy = 0` dass sie zur v2-Ausgabe wechseln.

**Topics**
+ [-Übersicht](#dnf-supportinfo-migrate-overview)
+ [Umfassende Änderungen, die Maßnahmen erfordern](#dnf-supportinfo-migrate-breaking-changes)
+ [Was ändert sich nicht](#dnf-supportinfo-migrate-unchanged)
+ [Übergangszeitraum](#dnf-supportinfo-migrate-transition-period)

## -Übersicht
<a name="dnf-supportinfo-migrate-overview"></a>

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


| Veranstaltung | Timing | 
| --- | --- | 
| v2-Plugin (dnf-plugin-support-info 2.0) verfügbar | Jetzt | 
| Das Plugin wird mit legacy = 1 (v1-kompatibler Ausgabe) geliefert | Erste Version 2 | 
| Standardänderungen zu legacy = 0 | Eine zukünftige vierteljährliche Veröffentlichung von AL2023 | 
| Das v1-Format wird nicht mehr beibehalten | Nach der Übergangsphase | 

### Was müssen Sie tun
<a name="dnf-supportinfo-migrate-what-to-do"></a>

Wenn Sie über Skripts verfügen, die Konsolenausgaben oder XML-Ausgaben analysieren oder die XML-Datei von der Festplatte lesen, aktualisieren Sie sie, sodass sie die neuen Feldnamen, Strukturen und Dateipfade verarbeiten. Wenn Sie es verwenden`--showjson`, müssen Ihre Skripts nicht geändert werden, da die JSON-Ausgabe zwischen Version 1 und Version 2 identisch ist. Wenn Sie die XML-Datei direkt von der Festplatte lesen, wechseln Sie zum Herunterladen der XML-Datei von der konfigurierten Version `baseurl` oder verwenden Sie`dnf supportinfo --show installed --showxml`.

## Umfassende Änderungen, die Maßnahmen erfordern
<a name="dnf-supportinfo-migrate-breaking-changes"></a>

### Wenn Sie die Konsolenausgabe analysieren
<a name="dnf-supportinfo-migrate-console-output"></a>

#### Detailfelder
<a name="dnf-supportinfo-migrate-detail-fields"></a>

Das Plugin hat die Feldbezeichnungen geändert, die angezeigt werden, wenn Sie ein bestimmtes Paket abfragen:


| v1-Bezeichnung | v2-Etikett | Hinweise | 
| --- | --- | --- | 
| Status der Unterstützung | Aktueller Status | Umbenannt | 
| Support-Zeiträume | Zeitplan für den Support | Umbenannt, ans Ende der Ausgabe verschoben | 
| Erklärung zum Support | (entfernt)  | Wird nicht mehr angezeigt | 
| Link | Link | Unverändert (wird angezeigt, wenn verfügbar) | 
| Weitere Informationen | Andere Informationen | Unverändert (wird angezeigt, wenn verfügbar) | 
| (nicht vorhanden)  | Patch-Priorität | Neues Feld | 
| (nicht vorhanden)  | Beschreibung der Unterstützungsstufe | Neues Feld | 
| (nicht vorhanden)  | Abgedeckte Schweregrade | Neues Feld | 
| (nicht vorhanden)  | Origin | Neues Feld | 

Die Feldbeschriftungsspalte ist jetzt 28 Zeichen breit (zuvor 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
```

#### Tabellenspalten
<a name="dnf-supportinfo-migrate-table-columns"></a>

Die Übersichtstabelle wurde von 6 auf 7 Spalten geändert. In der v2-Tabelle wird auch eine Kopfzeile angezeigt (Version 1 nicht):


| Spalte v1 | Spalte v2 | Änderungen | 
| --- | --- | --- | 
| Name | Package | Umbenannt | 
| Version | Version | Unverändert | 
| Status | Status | Unverändert | 
| Status der Unterstützung | Aktueller Status | Umbenannt | 
| (nicht vorhanden)  | Stufe der Unterstützung | Neue Spalte | 
| Datum (wie2029-06-30) | Bis (nächste Phase) (wie2029-06-30 (end\_of\_support)) | Umbenannt, Format geändert | 
| Hinweis | Hinweis | Unverändert | 

**Wichtig**  
Die Datumsspalte enthält jetzt den Namen der nächsten Phase in Klammern. Wenn Sie dieses Feld analysieren, aktualisieren Sie Ihre Regex- oder Trennzeichenlogik.

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

### Wenn Sie die `` --showxml-Ausgabe analysieren
<a name="dnf-supportinfo-migrate-xml-output"></a>

Die `--showxml` v2-Ausgabe verwendet eine andere XML-Struktur als die v1-Ausgabe. Das `<package_support>` Stammelement ist dasselbe, aber die untergeordneten Elemente, Attribute und die Hierarchie haben sich geändert.

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

Die wichtigsten strukturellen Unterschiede:
+ v1 verwendet`marker`,`start_date`, `end_date` Attribute für`<summary>`, `<statement>` with,`<text>`, `<link>` children
+ v2 verwendet `current_phase` Attribute und verschachtelte `<phases>` Elemente mit Angaben zur Unterstützungsebene
+ v2 wird `<covered_severities>` komplett weggelassen, wenn es leer ist (anstelle eines leeren Elements)
+ Zu den v2-Paketelementen gehören die `state` Attribute und `origin`
+ v2 enthält keine `<summary>``<text>`, oder `<link>` Elemente

### Wenn Sie die XML-Datei direkt von der Festplatte lesen
<a name="dnf-supportinfo-migrate-xml-file"></a>

Das v1-Plugin hat seine Datendatei unter folgender Adresse gebündelt:

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

**Warnung**  
Diese Datei wird nicht mehr aktualisiert, sobald sie in Kraft `legacy = 0` tritt. Verlassen Sie sich bei aktuellen Daten nicht auf diesen Pfad.

Das v2-Plugin speichert Daten im Cache, `/var/cache/dnf/support-info/` wenn es als Root ausgeführt wird. Wenn es als Nicht-Root-Benutzer ausgeführt wird`/var/tmp/dnf-{{username}}-*/support-info/`, verwendet es gemäß der DNF-Standardkonvention temporäre Verzeichnisse pro Benutzer. Dateien in diesen Verzeichnissen verwenden inhaltsadressierte Dateinamen und sind nicht stabil. Analysieren Sie sie nicht direkt.

**Empfohlene Alternativen: **

1. Laden Sie das XML direkt von der konfigurierten URL herunter:

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

1. Verwenden Sie die CLI, um eine strukturierte Ausgabe für installierte Pakete zu erhalten:

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

### Wenn Sie mit `--show filtern`
<a name="dnf-supportinfo-migrate-show-filter"></a>

Die vom `--show` Filter akzeptierten Werte haben sich geändert:


| v1-Filterwerte | v2-Filterwerte | 
| --- | --- | 
| supported | full\_support | 
| unsupported | eos | 

v1-Filter sind ** Phasennamen ** (`supported`,`unsupported`). v2-Filter sind Namen der ** Unterstützungsebenen ** (`full_support``eos`, usw.).

Führen Sie `--list-filters` Folgendes aus, um die verfügbaren Filterwerte auf Ihrem System zu ermitteln:

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

## Was ändert sich nicht
<a name="dnf-supportinfo-migrate-unchanged"></a>

Sobald Sie dnf-plugin-support-info Version 2 installiert haben, bleibt Folgendes unabhängig von der `legacy` Einstellung gleich:
+ **`--showjson`Ausgabe. ** Die JSON-Ausgabe ist identisch, egal ob `legacy` `0` oder`1`, da sich das Plugin vor der Formatierung auf die interne v2-Struktur normalisiert.
+ **CLI-Argumente. ** Alle Flags (`--pkg``--show`,`--showxml`,`--showjson`,,`--clean-cache`,`--list-filters`,`--sync`) funktionieren in beiden Modi.
+ **Name des Befehls. ** Du rennst immer noch`dnf supportinfo`.

**Anmerkung**  
Die `--sync` Flags `--showjson` `--clean-cache``--list-filters`,, und sind neu in Version 2 und in Version 1 nicht verfügbar.

## Übergangszeitraum
<a name="dnf-supportinfo-migrate-transition-period"></a>

Das v2-Plugin wird mit `legacy = 1` in geliefert`/etc/dnf/plugins/supportinfo.conf`. Während dieser Zeit:

1. Das Plugin lädt v2-Daten von der konfigurierten URL herunter.

1. Konsolenausgabe, XML-Ausgabe und Filterwerte verhalten sich weiterhin wie v1.

1. Die XML-Datei im v1-Format bleibt unter dem alten Pfad verfügbar, sodass vorhandene Skripts weiterhin funktionieren.

In einer zukünftigen vierteljährlichen Version von AL2023 wird die Standardeinstellung in geändert. `legacy = 0` Zu diesem Zeitpunkt:
+ Die Konsolenausgabe verwendet v2-Feldnamen und -Strukturen.
+ `--showxml`erzeugt das neue phasenbasierte Format.
+ `--show`Die Filterwerte ändern sich, sodass sie Levelnamen unterstützen.
+ Die v1-XML-Datei im alten Pfad wird nicht mehr aktualisiert.

**Um die v1-kompatible Ausgabe vorübergehend beizubehalten**, geben Sie `legacy = 1` Folgendes ein: `/etc/dnf/plugins/supportinfo.conf`

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

**Wichtig**  
Die `legacy = 1` Option ist eine temporäre Brücke. Planen Sie, Ihre Tools auf die v2-Ausgabe zu migrieren, anstatt sich auf unbestimmte Zeit auf diese Einstellung zu verlassen.