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

# Menggunakan info dukungan dnf Plugin
<a name="dnf-supportinfo-user-guide"></a>

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 ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html) 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 menjadi`legacy = 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, lihat[Migrasi dari dnf-plugin-support-info v1 ke v2](dnf-supportinfo-migrate-v1-v2.md).

**Topics**
+ [Prasyarat](#dnf-supportinfo-prerequisites)
+ [Memulai](#dnf-supportinfo-getting-started)
+ [Paket Kueri](#dnf-supportinfo-query-packages)
+ [Filter Paket](#dnf-supportinfo-filter-packages)
+ [Output Terstruktur](#dnf-supportinfo-structured-output)
+ [Kelola Cache](#dnf-supportinfo-manage-cache)
+ [Non-root Pemakaian](#dnf-supportinfo-non-root)
+ [Referensi Konfigurasi](#dnf-supportinfo-configuration-reference)
+ [Referensi Bidang Output](#dnf-supportinfo-output-fields)
+ [Skema](#dnf-supportinfo-schema)
+ [Migrasi dari Plugin Legacy](#dnf-supportinfo-migration-from-legacy)
+ [Pemecahan masalah](#dnf-supportinfo-troubleshooting)
+ [Sumber Daya Tambahan](#dnf-supportinfo-additional-resources)

## Prasyarat
<a name="dnf-supportinfo-prerequisites"></a>
+ Contoh AL2023
+ dnf-plugin-support-infoPaket (tersedia dari repositori AL2023 default)
+ Tidak diperlukan hak akses root (kecuali `--sync` dalam [ mode lama](#dnf-supportinfo-migration-from-legacy))

## Memulai
<a name="dnf-supportinfo-getting-started"></a>

1. Instal plugin.

   ```
   sudo dnf install dnf-plugin-support-info
   ```

1. 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
<a name="dnf-supportinfo-query-packages"></a>

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

```
dnf supportinfo --pkg {{PACKAGE}} [{{PACKAGE}} ...]
```

### Untuk Menanyakan Paket Tertentu
<a name="dnf-supportinfo-query-specific"></a>

`dnf supportinfo`Contoh 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
<a name="dnf-supportinfo-query-multiple"></a>

```
dnf supportinfo --pkg glibc bash openssl
```

## Filter Paket
<a name="dnf-supportinfo-filter-packages"></a>

`--show`Bendera memfilter paket berdasarkan negara bagian, tingkat dukungan, atau keduanya.

```
dnf supportinfo --show {{FILTER}} [{{FILTER}} ...]
```

### Jenis Filter
<a name="dnf-supportinfo-filter-types"></a>


| 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, lihat[SupportInfo Struktur XML](dnf-supportinfo-xml-structure.md).

### Logika Filter
<a name="dnf-supportinfo-filter-logic"></a>
+ 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
<a name="dnf-supportinfo-list-filters"></a>

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
<a name="dnf-supportinfo-filter-installed"></a>

```
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
<a name="dnf-supportinfo-filter-installed-level"></a>

```
dnf supportinfo --show installed eos
```

### Cara Menggunakan Sintaks Awalan untuk Disambiguasi
<a name="dnf-supportinfo-filter-prefix"></a>

```
dnf supportinfo --show state:installed support:full_support
```

## Output Terstruktur
<a name="dnf-supportinfo-structured-output"></a>

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

### Untuk Mendapatkan Output JSON
<a name="dnf-supportinfo-json-output"></a>

```
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
<a name="dnf-supportinfo-xml-output"></a>

```
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, lihat[SupportInfo Struktur XML](dnf-supportinfo-xml-structure.md).

## Kelola Cache
<a name="dnf-supportinfo-manage-cache"></a>

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

### Perilaku Cache
<a name="dnf-supportinfo-cache-behavior"></a>

Saat cache kedaluwarsa:

1. Plugin memeriksa apakah file jarak jauh telah berubah (menggunakan HTTP ETag).

1. Jika tidak berubah, itu memperluas cache tanpa mengunduh ulang.

1. Jika diubah, itu mengunduh file yang diperbarui.

1. Pada kesalahan jaringan, itu jatuh kembali ke file yang di-cache jika ada.

### Untuk Menyinkronkan Cache
<a name="dnf-supportinfo-sync-cache"></a>

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
<a name="dnf-supportinfo-clean-cache"></a>

```
dnf supportinfo --clean-cache
```

## Non-root Pemakaian
<a name="dnf-supportinfo-non-root"></a>

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](#dnf-supportinfo-migration-from-legacy), jalankan `sudo dnf supportinfo --sync` sekali untuk membuat file lama. Setelah itu, kueri non-root berfungsi normal.

## Referensi Konfigurasi
<a name="dnf-supportinfo-configuration-reference"></a>

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 atau0. Lihat [ Migrasi dari Plugin Legacy](#dnf-supportinfo-migration-from-legacy). | 1 | 

## Referensi Bidang Output
<a name="dnf-supportinfo-output-fields"></a>


| 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
<a name="dnf-supportinfo-schema"></a>

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
<a name="dnf-supportinfo-migration-from-legacy"></a>

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](dnf-supportinfo-migrate-v1-v2.md) 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
<a name="dnf-supportinfo-troubleshooting"></a>

### Data Cache Basi
<a name="dnf-supportinfo-troubleshooting-stale-cache"></a>

**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
<a name="dnf-supportinfo-troubleshooting-legacy-file"></a>

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

Jika`legacy = 0`, file tidak lagi dipertahankan. Migrasikan skrip Anda untuk digunakan `--showjson` atau dikeluarkan `--showxml` sebagai gantinya. Untuk langkah-langkah migrasi, lihat[Migrasi dari dnf-plugin-support-info v1 ke v2](dnf-supportinfo-migrate-v1-v2.md).

## Sumber Daya Tambahan
<a name="dnf-supportinfo-additional-resources"></a>
+ [Pernyataan Dukungan AL2023 (dapat dibaca manusia) ](https://docs.aws.amazon.com/linux/al2023/release-notes/support-information.html)
+ [Plugin Info Dukungan DNF di GitHub ](https://github.com/amazonlinux/dnf-plugin-support-info)
+ [pustaka penguraian amazon-linux-supportinfo aktif GitHub ](https://github.com/amazonlinux/amazon-linux-supportinfo)