Bagaimana Plugin Menggunakan File Ini Contoh Minimal Lengkap Referensi Elemen Integritas Referensial

SupportInfo Struktur XML

Halaman ini mendokumentasikan skema XML v1.0 yang digunakan untuk menentukan siklus hidup dukungan paket, garis waktu, dan klasifikasi untuk distribusi Linux. Skema ini independen dari DNF dan tidak spesifik untuk distribusi tunggal. Anda dapat mengkonsumsinya langsung dari alat apa pun. dnf supportinfoPlugin adalah salah satu konsumen tersebut.

Definisi skema (XSD): https://cdn.amazonlinux.com/al2023/core/supportinfo-1.0.xsd
Data dukungan (XML): https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml

Untuk mengurai XML ini secara langsung, gunakan pust amazon-linux-supportinfo aka sumber terbuka, yang mengimplementasikan skema yang dijelaskan pada halaman ini, alih-alih menulis parser khusus.

Bagaimana Plugin Menggunakan File Ini

Dari file ini, plugin melaporkan:

Tingkat dukungan mana paket berada (nilai-nilai ini mengisi opsi --show filter)
Ketika fase siklus hidup berubah (ditampilkan dalam --pkg output dan timeline)
Prioritas patch dan cakupan tingkat keparahan untuk setiap tingkat dukungan
Dari mana paket itu berasal (asal dan klasifikasi)

Contoh Minimal Lengkap

Contoh ini menunjukkan struktur minimum dengan semua bagian yang diperlukan dan satu paket:


<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">
  <lifecycles>
    <lifecycle name="default_lc"
               display_name="AL2023 Standard Lifecycle"
               description="Standard support lifecycle for Amazon Linux 2023 packages">
      <phase name="full_support"
             support_level="default"
             start_milestone="AL2023_GA"
             display_name="Full Support"/>
      <phase name="end_of_support"
             support_level="eos"
             start_milestone="AL2023_EOS"
             display_name="End of Support"/>
    </lifecycle>
  </lifecycles>

  <support_milestones>
    <milestone name="AL2023_GA" date="2023-03-15"
               display_name="AL2023 General Availability"
               description="Amazon Linux 2023 general availability date"/>
    <milestone name="AL2023_EOS" date="2029-06-30"
               display_name="AL2023 End of Support"
               description="End of all support for Amazon Linux 2023"/>
  </support_milestones>

  <support_levels>
    <support_level name="default"
                   severities="Low,Medium,Important,Critical"
                   description="Full security and bug fix support for all severities"
                   display_name="Default Support" />
    <support_level name="eos"
                   severities=""
                   description="End of support - no further updates"
                   display_name="End of Support" />
  </support_levels>

  <packages>
    <package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>
  </packages>

  <package_classes>
    <package_class name="default">
      <summary>Default class for Amazon Linux packages</summary>
      <text></text>
    </package_class>
  </package_classes>

  <package_origins>
    <package_origin name="al2023_core"
                    repo_id="amazonlinux"
                    dist="amzn2023"
                    vendor="amazonlinux"
                    display_name="Amazon Linux 2023 Core"
                    description="Core Amazon Linux 2023 repository" />
  </package_origins>

  <notes>
    <note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>
  </notes>
</package_support>

Referensi Elemen

`package_support` (Elemen Akar)

Elemen root yang berisi semua metadata dukungan.

Atribut	Diperlukan	Deskripsi
`schema_version`	Ya	Versi format skema (saat ini`1.0`)
`current_as`	Ya	Stempel waktu ISO saat data dukungan terakhir dibuat


<package_support schema_version="1.0" current_as="2025-08-21T22:41:55.575196">

S current_as tempel waktu muncul dalam output untuk menunjukkan kesegaran data.

`siklus hidup`

Mendefinisikan urutan fase yang ditransisi paket dari waktu ke waktu.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi unik yang direferensikan oleh `package@lifecycle`
`note`	Tidak	Referensi a `note@name` untuk konteks tambahan
`display_name`	Tidak	Customer-facing label
`description`	Tidak	Human-readable deskripsi


<lifecycle name="redis6_lc" note="eol_redis6"
           display_name="Redis 6 Lifecycle"
           description="Support lifecycle for Redis 6 packages">
  <phase .../>
</lifecycle>

Plugin berjalan fase secara berurutan, menemukan fase yang saat ini aktif, dan melaporkan tingkat dukungan fase itu dalam output.

`fase`

Mendefinisikan satu tahap dalam siklus hidup. Setiap fase berlanjut sampai fase berikutnya dimulai (atau tanpa batas jika itu adalah fase terakhir).

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi fase (unik dalam siklus hidupnya)
`support_level`	Ya	Referensi a `support_level@name`
`start_date`	Bersyarat	Tanggal ISO tetap (`YYYY-MM-DD`). Gunakan ini atau `start_milestone`
`start_milestone`	Bersyarat	Referensi a`milestone@name`. Gunakan ini atau `start_date`
`display_name`	Tidak	Customer-facing label

catatan

Tentukan dengan tepat salah satu start_date ataustart_milestone, bukan keduanya.


<phase name="limited_support"
       support_level="limited"
       start_milestone="AL2023_6months"
       display_name="Limited Support"/>

Setiap fase aktif dari tanggal mulai hingga fase berikutnya dimulai. Fase terakhir dalam siklus hidup tetap aktif tanpa batas.

`pal`

Mendefinisikan penanda tanggal yang dapat digunakan kembali yang referensi fase siklus hidup.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi unik yang direferensikan oleh `phase@start_milestone`
`date`	Ya	Tanggal ISO (`YYYY-MM-DD`)
`display_name`	Tidak	Customer-facing label
`description`	Tidak	Human-readable deskripsi


<milestone name="AL2023_GA" date="2023-03-15"
           display_name="AL2023 General Availability"
           description="Amazon Linux 2023 general availability date"/>

Tonggak memungkinkan fase berbagi tanggal. Ketika tanggal tonggak berubah, setiap fase yang mereferensikannya diperbarui secara otomatis.

`tingkat dukungan`

Mendefinisikan tingkat dukungan dan tingkat keparahan yang dicakupnya. Masing-masing name menjadi nilai --show filter yang valid.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi unik. Digunakan sebagai nilai `--show` filter
`severities`	Ya	Comma-separated tingkat keparahan tercakup (string kosong = tidak ada tambalan)
`description`	Ya	Human-readable deskripsi ditampilkan dalam `--list-filters` output
`display_name`	Tidak	Customer-facing label


<support_level name="limited"
               severities="Important,Critical"
               description="Security fixes for Important and Critical severities only"
               display_name="Limited Support" />

Running dnf supportinfo --show limited mencantumkan semua paket yang saat ini berada di level dukungan ini. Per --list-filters intah menampilkan setiap level name dandescription.

`package`

Memetakan nama paket RPM ke siklus hidup, asal, dan kelasnya.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Nama paket RPM
`lifecycle`	Ya	Referensi a `lifecycle@name`
`origin`	Ya	Referensi a `package_origin@name`
`package_class`	Tidak	Referensi a `package_class@name`


<package name="curl" lifecycle="default_lc" origin="al2023_core" package_class="default"/>

catatan

Paket dapat muncul beberapa kali dengan origin nilai yang berbeda (misalnya, paket yang sama di repo inti dan SPAL). Kombinasi dari name + origin harus unik.

Setiap RPM yang diinstal dicocokkan dengan daftar ini untuk menentukan siklus hidup dan status dukungan saat ini.

`kelas_paket`

Mengkategorikan paket berdasarkan perannya dalam sistem. Nama kelas dan ringkasan muncul di output plugin.

Attribute/Element	Diperlukan	Deskripsi
`@name`	Ya	Pengidentifikasi unik yang direferensikan oleh `package@package_class`
`summary`(anak)	Ya	Deskripsi singkat tentang kategori
`text`(anak)	Ya	Deskripsi yang diperluas. Elemen harus ada tetapi mungkin kosong


<package_class name="os_dependency">
  <summary>Packages supported only as dependencies of the operating system</summary>
  <text></text>
</package_class>

Nama kelas muncul dalam output untuk menunjukkan peran paket pada sistem.

`paket_asal`

Mengidentifikasi sumber repositori dari sebuah paket. originNilai muncul di dnf supportinfo --pkg output.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi unik yang direferensikan oleh `package@origin`
`repo_id`	Ya	ID repositori DNF
`dist`	Ya	Pengidentifikasi distribusi
`vendor`	Ya	Vendor paket
`signing_key`	Tidak	Pengidentifikasi kunci penandatanganan GPG
`display_name`	Tidak	Customer-facing label
`description`	Tidak	Human-readable deskripsi


<package_origin name="al2023_core"
                repo_id="amazonlinux"
                dist="amzn2023"
                vendor="amazonlinux"
                display_name="Amazon Linux 2023 Core"
                description="Core Amazon Linux 2023 repository" />

Mun display_name cul sebagai bidang “Origin” dalam --pkg output.

`not`

Menyediakan teks bentuk bebas yang dapat dirujuk oleh siklus hidup untuk konteks tambahan.

Atribut	Diperlukan	Deskripsi
`name`	Ya	Pengidentifikasi unik yang direferensikan oleh `lifecycle@note`

Konten teks elemen berisi pesan catatan.


<note name="eol_redis6">Upstream end-of-life for Redis 6 (redis6) is 2025-08-31</note>

Ketika siklus hidup paket mereferensikan catatan, teks catatan muncul sebagai “Catatan Paket” dalam --pkg output.

Integritas Referensial

Skema menghubungkan elemen bersama melalui name referensi. Setiap atribut sumber harus cocok name dengan elemen target yang ada:

Atribut sumber	Referensi
`package@lifecycle`	`lifecycle@name`
`package@origin`	`package_origin@name`
`package@package_class`	`package_class@name`
`phase@support_level`	`support_level@name`
`phase@start_milestone`	`milestone@name`
`lifecycle@note`	`note@name`

Selain itu, kombinasi package@name dan package@origin harus unik di semua package elemen.

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

Migrasi v1 ke v2

Bahasa pemrograman dan runtime

SupportInfo Struktur XML

Topik

Bagaimana Plugin Menggunakan File Ini

Contoh Minimal Lengkap

Referensi Elemen

package_support (Elemen Akar)

siklus hidup

fase

catatan

pal

tingkat dukungan

package

catatan

kelas_paket

paket_asal

not

Integritas Referensial

`package_support` (Elemen Akar)

`siklus hidup`

`fase`

`pal`

`tingkat dukungan`

`package`

`kelas_paket`

`paket_asal`

`not`