View a markdown version of this page

Migrasi dari dnf-plugin-support-info v1 ke v2 - Amazon Linux 2023
Gambaran umumMelanggar Perubahan yang Membutuhkan TindakanApa yang Tidak BerubahPeriode transisi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Migrasi dari dnf-plugin-support-info v1 ke v2

dnf-plugin-support-infoPaket ini memiliki versi utama baru (v2) dengan format output yang didesain ulang. Panduan ini membantu Anda memperbarui skrip atau perkakas apa pun yang mengurai keluarandnf supportinfo.

Selama periode transisi, plugin v2 dikirimkan dengan legacy = 1 in/etc/dnf/plugins/supportinfo.conf, yang mempertahankan output yang kompatibel dengan v1. Setelah Anda memperbarui skrip Anda, atur legacy = 0 untuk beralih ke output v2.

Gambaran umum

Jadwal

Peristiwa Pengaturan waktu
v2 plugin (dnf-plugin-support-info 2.0) tersedia Sekarang
Plugin dikirimkan dengan legacy = 1 (output yang kompatibel dengan v1) Rilis v2 awal
Perubahan default ke legacy = 0 Rilis triwulanan AL2023 di masa depan
format v1 tidak lagi dipertahankan Setelah masa transisi

Apa yang perlu Anda lakukan

Jika Anda memiliki skrip yang mengurai output konsol, output XML, atau membaca file XML dari disk, perbarui untuk menangani nama bidang baru, struktur, dan jalur file. Jika Anda menggunakan--showjson, skrip Anda tidak memerlukan perubahan, karena output JSON identik antara v1 dan v2. Jika Anda membaca file XML langsung dari disk, beralih ke mengunduh XML dari yang dikonfigurasi baseurl atau gunakandnf supportinfo --show installed --showxml.

Melanggar Perubahan yang Membutuhkan Tindakan

Jika Anda Mengurai Output Konsol

Bidang Detail

Plugin mengubah label bidang yang ditampilkan saat Anda menanyakan paket tertentu:

label v1 label v2 Catatan
Status Dukungan Status saat ini Mengganti nama
Periode Dukungan Garis Waktu Dukungan Mengganti nama, dipindahkan ke akhir output
Pernyataan Dukungan (dihapus) Tidak lagi ditampilkan
Tautan Tautan Tidak berubah (ditampilkan jika tersedia)
Info Lainnya Info Lainnya Tidak berubah (ditampilkan jika tersedia)
(tidak hadir) Prioritas Patch Bidang baru
(tidak hadir) Deskripsi Tingkat Dukungan Bidang baru
(tidak hadir) Tingkat keparahan yang tercakup Bidang baru
(tidak hadir) asal Bidang baru

Kolom label bidang sekarang memiliki lebar 28 karakter (sebelumnya 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

Kolom Tabel

Tabel ringkasan telah berubah dari 6 kolom menjadi 7. Tabel v2 juga menampilkan baris header (v1 tidak):

kolom v1 Kolom v2 Ubah
Nama Paket Mengganti nama
Versi Versi Tidak berubah
Status Status Tidak berubah
Status Dukungan Status saat ini Mengganti nama
(tidak hadir) Tingkat Dukungan Kolom baru
Tanggal (seperti2029-06-30) Sampai (Tahap Berikutnya) (seperti2029-06-30 (end_of_support)) Mengganti nama, format diubah
Catatan Catatan Tidak berubah
penting

Kolom tanggal sekarang menyertakan nama fase berikutnya dalam tanda kurung. Jika Anda mengurai bidang ini, perbarui logika regex atau pembatas Anda.

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

Jika Anda mengurai -- showxml Output

--showxmlOutput v2 menggunakan struktur XML yang berbeda dari v1. <package_support>Elemen root adalah sama, tetapi elemen anak, atribut, dan hierarki telah berubah.

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>

Perbedaan struktural utama:

  • v1 menggunakanmarker,start_date, end_date atribut <statement> dengan<summary>,<text>, <link> anak-anak

  • v2 menggunakan current_phase atribut dan <phases> elemen bersarang dengan detail tingkat dukungan

  • v2 menghilangkan <covered_severities> seluruhnya saat kosong (bukan elemen kosong)

  • elemen paket v2 termasuk state dan origin atribut

  • v2 tidak termasuk<summary>,<text>, atau <link> elemen

Jika Anda Membaca File XML Langsung dari Disk

Plugin v1 menggabungkan file datanya di:

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

File ini tidak lagi diperbarui legacy = 0 setelah berlaku. Jangan mengandalkan jalur ini untuk data saat ini.

Plugin v2 menyimpan data /var/cache/dnf/support-info/ saat dijalankan sebagai root. Ketika dijalankan sebagai pengguna non-root, ia menggunakan/var/tmp/dnf-username-*/support-info/, mengikuti konvensi standar DNF untuk direktori sementara per pengguna. File di direktori ini menggunakan nama file yang beralamat konten dan tidak stabil. Jangan menguraikannya secara langsung.

Alternatif yang disarankan:

  1. Unduh XML langsung dari URL yang dikonfigurasi:

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

  2. Gunakan CLI untuk mendapatkan output terstruktur untuk paket yang diinstal:

    dnf supportinfo --show installed --showxml

Jika Anda Memfilter dengan --show

Nilai yang diterima oleh --show filter telah berubah:

nilai filter v1 nilai filter v2
supported full_support
unsupported eos

filter v1 adalah nama fase (supported,unsupported). filter v2 adalah nama level dukungan (full_support,eos, dll.).

Jalan --list-filters kan untuk menemukan nilai filter yang tersedia di sistem Anda:

dnf supportinfo --list-filters

Apa yang Tidak Berubah

Setelah Anda menginstal dnf-plugin-support-info v2, berikut ini tetap sama terlepas dari pengatur legacy annya:

  • --showjsonkeluaran. Output JSON identik apakah legacy itu 0 atau1, karena plugin menormalkan ke struktur internal v2 sebelum memformat.

  • Argumen CLI. Semua bendera (--pkg--show,--showxml,--showjson,,--clean-cache,--list-filters,--sync) bekerja di kedua mode.

  • Nama perintah. Kau masih laridnf supportinfo.

catatan

Ben --sync dera --showjson--clean-cache,--list-filters,, dan baru di v2 dan tidak tersedia di v1.

Periode transisi

Plugin v2 dikirimkan dengan legacy = 1 in/etc/dnf/plugins/supportinfo.conf. Selama periode ini:

  1. Plugin mengunduh data v2 dari URL yang dikonfigurasi.

  2. Output konsol, output XML, dan nilai filter terus berperilaku seperti v1.

  3. File XML format v1 tetap tersedia di jalur lama sehingga skrip yang ada terus berfungsi.

Dalam rilis triwulanan AL2023 mendatang, defaultnya berubah menjadilegacy = 0. Pada titik itu:

  • Output konsol menggunakan nama dan struktur bidang v2.

  • --showxmlmenghasilkan format berbasis fase baru.

  • --shownilai filter berubah untuk mendukung nama level.

  • File XML v1 di jalur lama tidak lagi diperbarui.

Untuk menjaga output yang kompatibel dengan v1 sementara, atur: legacy = 1 /etc/dnf/plugins/supportinfo.conf

[main]
legacy = 1
penting

P legacy = 1 ilihannya adalah jembatan sementara. Rencanakan untuk memigrasikan perkakas Anda ke output v2 daripada mengandalkan pengaturan ini tanpa batas waktu.