View a markdown version of this page

Verwendung der DNF-Supportinformationen Plug-In - Amazon Linux 2023
VoraussetzungenErste SchrittePakete abfragenPakete filternStrukturierte AusgabeDen Cache verwaltenNon-root VerwendungKonfigurationsreferenzReferenz zu den AusgabefeldernSchemaMigration vom Legacy-PluginFehlerbehebungWeitere Ressourcen

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

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 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 unterMigration von dnf-plugin-support-info v1 bis v2.

Voraussetzungen

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

Erste Schritte

  1. Installieren Sie das -Plug-in.

    sudo dnf install dnf-plugin-support-info

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

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

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

Um ein bestimmtes Paket abzufragen

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

dnf supportinfo --pkg glibc bash openssl

Pakete filtern

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

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

Filtertypen

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 unterSupportInfo XML-Struktur.

Logik filtern

  • 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

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

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

dnf supportinfo --show installed eos

So verwenden Sie die Präfixsyntax zur Disambiguierung

dnf supportinfo --show state:installed support:full_support

Strukturierte Ausgabe

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

Um eine JSON-Ausgabe zu erhalten

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

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 unterSupportInfo XML-Struktur.

Den Cache verwalten

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

Verhalten des Caches

Wenn der Cache abläuft:

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

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

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

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

Um den Cache zu synchronisieren

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

dnf supportinfo --clean-cache

Non-root Verwendung

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

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

Referenz zu den Ausgabefeldern

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

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

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

Veraltete Cache-Daten

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

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

Wennlegacy = 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 unterMigration von dnf-plugin-support-info v1 bis v2.

Weitere Ressourcen