Prasyarat Memulai Paket Kueri Filter Paket Output Terstruktur Kelola Cache Non-root Pemakaian Referensi Konfigurasi Referensi Bidang Output Skema Migrasi dari Plugin Legacy Pemecahan masalah Sumber Daya Tambahan

Menggunakan info dukungan dnf Plugin

dnf-plugin-support-infoPaket ini menyediakan dnf supportinfo perintah untuk AL2023. Gunakan perintah ini untuk menanyakan siklus hidup dan informasi dukungan untuk paket: cari tahu apakah paket saat ini didukung, tingkat keparahan apa yang menerima patch, dan kapan status dukungan berubah.

Untuk tampilan ringkasan dari semua pernyataan dukungan paket, lihat Pernyataan Dukungan AL2023 di Catatan Rilis AL2023.

penting

Plugin v2 dikirimkan dengan legacy = 1 in/etc/dnf/plugins/supportinfo.conf. Dalam mode ini, output menggunakan nama bidang v1 dan format. Dalam rilis triwulanan AL2023 mendatang, default berubah menjadilegacy = 0, beralih ke format keluaran v2 yang didokumentasikan di halaman ini. Untuk mulai menggunakan output v2 sekarang, legacy = 0 atur konfigurasi Anda. Untuk detail tentang perubahan apa, lihatMigrasi dari dnf-plugin-support-info v1 ke v2.

Prasyarat

Contoh AL2023
dnf-plugin-support-infoPaket (tersedia dari repositori AL2023 default)
Tidak diperlukan hak akses root (kecuali --sync dalam mode lama)

Memulai

Instal plugin.


sudo dnf install dnf-plugin-support-info

Kueri paket untuk memverifikasi instalasi.


dnf supportinfo --pkg glibc

Output menunjukkan status dukungan paket dan timeline:


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

Paket Kueri

L --pkg uluskan dengan satu atau lebih nama paket untuk menampilkan informasi dukungan mereka.


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

Untuk Menanyakan Paket Tertentu

dnf supportinfoContoh berikut menanyakan paket yang telah mencapai akhir masa pakai:


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

Untuk Menanyakan Beberapa Paket


dnf supportinfo --pkg glibc bash openssl

Filter Paket

--showBendera memfilter paket berdasarkan negara bagian, tingkat dukungan, atau keduanya.


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

Jenis Filter

Kategori	Nilai	Sumber
Filter negara (tetap)	`installed`, `available`, `unavailable`, `all`	Dibangun ke dalam plugin
Filter tingkat dukungan (dinamis)	Bervariasi. Misalnya,`full_support`, `eos`	Dimuat dari `<support_level>` entri di XML info dukungan

catatan

Filter tingkat dukungan bersifat dinamis. Mereka datang langsung dari data XML info dukungan yang ditentukan oleh vendor OS. Nilai yang tersedia tergantung pada apa yang didefinisikan AL2023 saat ini. Jalan --list-filters kan untuk melihat rangkaian nilai filter yang valid saat ini. Untuk informasi tentang bagaimana level ini dinyatakan, lihatSupportInfo Struktur XML.

Logika Filter

Beberapa filter status digabungkan dengan OR: --show installed available cocok dengan paket yang diinstal ATAU tersedia.
Beberapa filter tingkat dukungan digabungkan dengan OR: --show full_support eos cocok paket di tingkat eos dukungan full_support OR.
Ketika Anda menggabungkan kedua jenis, keduanya digabungkan dengan AND: --show installed eos cocok dengan paket yang diinstal DAN di tingkat eos dukungan.

catatan

Jika nama filter ada di kategori level status dan dukungan, plugin cocok dengan keduanya. Gunakan sintaks awalan untuk memisahkan: state:NAME atau. support:NAME

Untuk Daftar Filter yang Tersedia

Jalankan --list-filters untuk melihat semua nilai filter yang valid dikelompokkan berdasarkan kategori:


dnf supportinfo --list-filters

Contoh output:


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

Untuk Memfilter Paket yang Diinstal


dnf supportinfo --show installed

Output mencantumkan setiap paket dalam tabel dengan tingkat dukungan dan status saat ini:


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

Untuk Memfilter Paket yang Diinstal pada Tingkat Dukungan Tertentu


dnf supportinfo --show installed eos

Cara Menggunakan Sintaks Awalan untuk Disambiguasi


dnf supportinfo --show state:installed support:full_support

Output Terstruktur

Untuk skrip dan otomatisasi, --showjson dan --showxml menghasilkan output yang dapat dibaca mesin.

Untuk Mendapatkan Output JSON


dnf supportinfo --pkg nodejs20 --showjson

Output berisi fase paket saat ini, asal, dan garis waktu lengkap dengan detail tingkat dukungan:


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

Untuk Mendapatkan Output XML


dnf supportinfo --pkg nodejs20 --showxml

Outputnya adalah dokumen XML dengan <package_support> root yang berisi satu <statement> elemen per siklus hidup, masing-masing dengan fase, tanggal mulai, dan detail tingkat dukungan. Untuk referensi skema lengkap, lihatSupportInfo Struktur XML.

Kelola Cache

Plugin menyimpan XML info dukungan secara lokal untuk mengurangi permintaan jaringan.

Perilaku Cache

Saat cache kedaluwarsa:

Plugin memeriksa apakah file jarak jauh telah berubah (menggunakan HTTP ETag).
Jika tidak berubah, itu memperluas cache tanpa mengunduh ulang.
Jika diubah, itu mengunduh file yang diperbarui.
Pada kesalahan jaringan, itu jatuh kembali ke file yang di-cache jika ada.

Untuk Menyinkronkan Cache

Unduh dan simpan data info dukungan terbaru:


dnf supportinfo --sync

Gunakan ini untuk pekerjaan otomatisasi dan cron yang membutuhkan data dukungan terkini tanpa menjalankan kueri lengkap.

Untuk Menghapus Cache


dnf supportinfo --clean-cache

Non-root Pemakaian

Semua perintah bekerja tanpa hak root. Saat dijalankan sebagai root, cache disimpan di/var/cache/dnf/support-info/. Saat dijalankan sebagai pengguna non-root, cache masuk ke/var/tmp/dnf-username-*/support-info/. Ini mengikuti konvensi standar DNF untuk direktori sementara per pengguna.

catatan

Jika Anda mengaktifkan mode lama, jalankan sudo dnf supportinfo --sync sekali untuk membuat file lama. Setelah itu, kueri non-root berfungsi normal.

Referensi Konfigurasi

Plugin membaca konfigurasi dari/etc/dnf/plugins/supportinfo.conf. Contoh berikut menunjukkan konfigurasi yang disarankan dengan mode lama dinonaktifkan:


[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

Opsi	Deskripsi	Default
`baseurl`	URL ke file XML info dukungan. Mendukung variabel DNF seperti`$awsregion`.	Diperlukan
`templateurl`	URL ke skema XSD untuk validasi.	Tidak ada
`metadata_expire`	Durasi cache dalam hitungan detik. Gunakan `-1` untuk tak terbatas, `0` untuk selalu memeriksa.	`1800`
`legacy`	Aktifkan output yang kompatibel dengan v1. Setel ke `1` atau`0`. Lihat Migrasi dari Plugin Legacy.	`1`

Referensi Bidang Output

Bidang	Deskripsi
Nama	Nama paket
Versi	Versi terinstal atau tersedia
Status	`installed`,`available`, atau `unavailable`
Status saat ini	Fase siklus hidup saat ini, seperti `Supported` atau `End of Life`
Prioritas Patch	Nama tingkat dukungan
Deskripsi Tingkat Dukungan	Human-readable deskripsi tingkat dukungan
Tingkat keparahan yang tercakup	Tingkat keparahan keamanan yang menerima patch
asal	Repositori menyediakan paket
Garis Waktu Dukungan	Daftar kronologis fase siklus hidup dengan tanggal
Catatan Paket	Konteks tambahan, seperti tanggal EOL hulu

Skema

Format data info dukungan ditentukan oleh skema XSD. Gunakan skema ini untuk memvalidasi perkakas khusus yang menggunakan XML info dukungan secara langsung:


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

Migrasi dari Plugin Legacy

Jika sebelumnya Anda menggunakan versi dnf-plugin-support-info paket sebelumnya, plugin v2 baru dikirimkan secara legacy = 1 default untuk mempertahankan kompatibilitas ke belakang. Dalam rilis triwulanan AL2023 mendatang, perubahan default ke legacy = 0 dan output beralih ke format v2 yang didokumentasikan di halaman ini.

Jika Anda memiliki skrip atau perkakas yang mengurai keluaran plugin atau membaca file XML lama secara langsung, lihat Migrasi dari dnf-plugin-support-info v1 ke v2 daftar lengkap perbedaan, before/after contoh, dan daftar periksa migrasi langkah demi langkah.

Untuk mempertahankan perilaku lama setelah transisi, legacy = 1 atur/etc/dnf/plugins/supportinfo.conf. Ini adalah tindakan sementara. Mode Legacy memerlukan hak akses root untuk --sync dan akan dihapus dalam rilis mendatang.

Pemecahan masalah

Data Cache Basi

Gejala: Hasil kueri menunjukkan informasi dukungan yang sudah ketinggalan zaman.

Resolusi: Sinkronkan cache secara manual:


dnf supportinfo --sync

Jika masalah berlanjut, hapus dan sinkronkan ulang:


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

File Legacy Tidak Ditemukan

Gejala: Skrip yang membaca /usr/lib/python*/site-packages/dnf-plugins/support_info.xml gagal dengan “file tidak ditemukan.”

Resol usi: Plugin membuat file lama hanya ketika Anda mengatur legacy = 1 dan menjalankan --sync setidaknya sekali:


sudo dnf supportinfo --sync

Jikalegacy = 0, file tidak lagi dipertahankan. Migrasikan skrip Anda untuk digunakan --showjson atau dikeluarkan --showxml sebagai gantinya. Untuk langkah-langkah migrasi, lihatMigrasi dari dnf-plugin-support-info v1 ke v2.

Sumber Daya Tambahan

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Plugin Info Dukungan

Migrasi v1 ke v2