View a markdown version of this page

dnf supportinfo プラグインの使用 - Amazon Linux 2023

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

dnf supportinfo プラグインの使用

dnf-plugin-support-info パッケージは AL2023 の dnf supportinfo コマンドを提供します。このコマンドを使用して、パッケージのライフサイクルとサポート情報をクエリします。パッケージが現在サポートされているかどうか、パッチを受け取る重要度レベル、サポートステータスが変更されたタイミングを確認します。

すべてのパッケージサポートステートメントの概要については、AL2023 リリースノートの「AL2023 サポートステートメント」を参照してください。 AL2023

重要

v2 プラグインは、 legacy = 1の に付属しています/etc/dnf/plugins/supportinfo.conf。このモードでは、出力は v1 フィールド名と形式を使用します。今後の AL2023 四半期リリースでは、デフォルトは に変更されlegacy = 0、このページに記載されている v2 出力形式に切り替えられます。v2 出力の使用を今すぐ開始するには、設定legacy = 0で を設定します。変更点の詳細については、「」を参照してくださいv1 dnf-plugin-support-info から v2 への移行

前提条件

  • AL2023 インスタンス

  • dnf-plugin-support-info パッケージ (デフォルトの AL2023 リポジトリから使用可能)

  • ルート権限は必要ありません (レガシーモード--syncの を除く)

開始方法

  1. プラグインをインストールします。

    sudo dnf install dnf-plugin-support-info
  2. パッケージをクエリしてインストールを確認します。

    dnf supportinfo --pkg glibc

    出力には、パッケージのサポートステータスとタイムラインが表示されます。

    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

クエリパッケージ

サポート情報を表示するには、1 つ以上のパッケージ名--pkgで を渡します。

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

特定のパッケージをクエリするには

次の のdnf supportinfo例では、サポートが終了したパッケージをクエリします。

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

複数のパッケージをクエリするには

dnf supportinfo --pkg glibc bash openssl

パッケージをフィルタリングする

--show フラグは、状態、サポートレベル、またはその両方でパッケージをフィルタリングします。

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

フィルタータイプ

Category ソース
状態フィルター (修正済み) installed, available, unavailable, all プラグインに組み込まれている
サポートレベルフィルター (動的) 可変。たとえば、full_supporteos サポート情報 XML の<support_level>エントリからロード
注記

サポートレベルのフィルターは動的です。これらは、OS ベンダーによって定義されたサポート情報 XML データから直接取得されます。使用可能な値は、AL2023 が現在定義しているものによって異なります。--list-filters を実行して、有効なフィルター値の現在のセットを表示します。これらのレベルの宣言方法については、「」を参照してくださいSupportInfo XML 構造

フィルタロジック

  • 複数の状態フィルターは OR と組み合わせます。 は、インストールされているパッケージまたは利用可能なパッケージ--show installed availableと一致します。

  • 複数のサポートレベルフィルターは OR と組み合わされ、full_supportOR eos サポートレベルでパッケージ--show full_support eosに一致します。

  • 両方のタイプを組み合わせると、AND と結合されます。 は、eosサポートレベルでインストールされている AND パッケージ--show installed eosと一致します。

注記

状態とサポートレベルの両方のカテゴリにフィルター名が存在する場合、プラグインは両方と照合します。プレフィックス構文を使用して、 state:NAMEまたは の曖昧さを解消しますsupport:NAME

使用可能なフィルターを一覧表示するには

を実行して--list-filters、カテゴリ別にグループ化されたすべての有効なフィルター値を表示します。

dnf supportinfo --list-filters

出力の例:

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

インストール済みパッケージをフィルタリングするには

dnf supportinfo --show installed

出力には、サポートレベルと現在のステータスを持つテーブル内の各パッケージが一覧表示されます。

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

特定のサポートレベルでインストール済みパッケージをフィルタリングするには

dnf supportinfo --show installed eos

曖昧さを解消するためにプレフィックス構文を使用するには

dnf supportinfo --show state:installed support:full_support

構造化出力

スクリプティングと自動化の場合、 --showjsonと は機械読み取り可能な出力--showxmlを生成します。

JSON 出力を取得するには

dnf supportinfo --pkg nodejs20 --showjson

出力には、パッケージの現在のフェーズ、オリジン、およびサポートレベルの詳細を含む完全なタイムラインが含まれます。

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

XML 出力を取得するには

dnf supportinfo --pkg nodejs20 --showxml

出力は、ライフサイクルごとに 1 つの<statement>要素を含む<package_support>ルートを持つ XML ドキュメントで、それぞれにフェーズ、開始日、サポートレベルの詳細が含まれます。スキーマの完全なリファレンスについては、「」を参照してくださいSupportInfo XML 構造

キャッシュの管理

プラグインはサポート情報 XML をローカルにキャッシュして、ネットワークリクエストを減らします。

キャッシュ動作

キャッシュの有効期限が切れた場合:

  1. プラグインは、リモートファイルが変更されているかどうかを確認します (HTTP ETag を使用)。

  2. 変更しない場合、キャッシュは再ダウンロードせずに拡張されます。

  3. 変更すると、更新されたファイルがダウンロードされます。

  4. ネットワークエラーの場合、キャッシュされたファイルが存在する場合は、キャッシュされたファイルにフォールバックします。

キャッシュを同期するには

最新のサポート情報データをダウンロードしてキャッシュします。

dnf supportinfo --sync

これは、完全なクエリを実行せずにup-to-dateサポートデータを必要とするオートメーションジョブと cron ジョブに使用します。

キャッシュをクリアするには

dnf supportinfo --clean-cache

非ルート使用状況

すべてのコマンドはルート権限なしで動作します。root として実行すると、キャッシュは に保存されます/var/cache/dnf/support-info/。ルート以外のユーザーとして実行すると、キャッシュは になります/var/tmp/dnf-username-*/support-info/。これは、ユーザーごとの一時ディレクトリに関する DNF の標準規則に従います。

注記

レガシーモードを有効にする場合は、 を 1 sudo dnf supportinfo --sync回実行してレガシーファイルを作成します。その後、非ルートクエリは正常に動作します。

設定リファレンス

プラグインは から設定を読み取ります/etc/dnf/plugins/supportinfo.conf。次の例は、レガシーモードが無効になっている推奨設定を示しています。

[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
オプション 説明 デフォルト
baseurl サポート情報 XML ファイルへの URL。などの DNF 変数をサポートします$awsregion 必須
templateurl 検証用の XSD スキーマへの URL。 なし
metadata_expire キャッシュ時間を秒単位で表します。常にチェック0するには、 を無限-1に使用します。 1800
legacy v1 互換出力を有効にします。を 1または に設定します0「レガシープラグインからの移行」を参照してください。 1

出力フィールドリファレンス

フィールド 説明
名前 パッケージ名
バージョン インストール済みまたは利用可能なバージョン
State installed, available, または unavailable
現在のステータス Supported や などの現在のライフサイクルフェーズ End of Life
パッチ優先度 サポートレベル名
サポートレベルの説明 サポートレベルの人間が読める説明
対象重要度 パッチを受け取るセキュリティ重要度レベル
オリジン パッケージを提供するリポジトリ
サポートタイムライン ライフサイクルフェーズと日付の時系列リスト
パッケージノート アップストリーム EOL の日付などの追加のコンテキスト

Schema

サポート情報データ形式は、XSD スキーマによって定義されます。このスキーマを使用して、サポート情報 XML を直接使用するカスタムツールを検証します。

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

レガシープラグインからの移行

以前にパッケージの以前のバージョンを使用した場合dnf-plugin-support-info、新しい v2 プラグインは下位互換性を維持するためにlegacy = 1デフォルトで に付属しています。将来の AL2023 四半期リリースでは、デフォルトは に変更legacy = 0され、出力はこのページに記載されている v2 形式に切り替わります。

プラグイン出力を解析したり、レガシー XML ファイルを直接読み取ったりするスクリプトまたはツールがある場合は、相違点の完全なリスト、前後の例、step-by-step移行チェックリストv1 dnf-plugin-support-info から v2 への移行について、「」を参照してください。

移行後もレガシー動作を維持するには、 legacy = 1で を設定します/etc/dnf/plugins/supportinfo.conf。これは一時的な対策です。レガシーモードには のルート権限が必要--syncであり、今後のリリースで削除されます。

トラブルシューティング

古いキャッシュデータ

症状: クエリ結果に古いサポート情報が表示されます。

解決策: キャッシュを手動で同期します。

dnf supportinfo --sync

問題が解決しない場合は、クリアして再同期します。

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

レガシーファイルが見つかりません

症状: 「ファイルが見つかりません」で読み取るスクリプトが/usr/lib/python*/site-packages/dnf-plugins/support_info.xml失敗します。

解決策: プラグインは、--sync少なくとも 1 回 を設定legacy = 1して実行した場合にのみレガシーファイルを作成します。

sudo dnf supportinfo --sync

の場合legacy = 0、ファイルは維持されなくなります。スクリプトを移行して、代わりに --showjsonまたは を--showxml出力します。移行手順については、「」を参照してくださいv1 dnf-plugin-support-info から v2 への移行

その他のリソース