View a markdown version of this page

v1 dnf-plugin-support-info から v2 への移行 - Amazon Linux 2023

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

v1 dnf-plugin-support-info から v2 への移行

dnf-plugin-support-info パッケージには、再設計された出力形式の新しいメジャーバージョン (v2) があります。このガイドは、dnf supportinfo出力を解析するスクリプトやツールを更新するのに役立ちます。

移行期間中、v2 プラグインは legacy = 1の に付属し/etc/dnf/plugins/supportinfo.conf、v1 互換の出力を保持します。スクリプトを更新したら、v2 出力に切り替えるlegacy = 0ように を設定します。

概要

タイムライン

イベント [Timing] (タイミング)
v2 プラグイン (dnf-plugin-support-info 2.0) が利用可能 現在
プラグインに付属 legacy = 1 (v1 互換出力) 最初の v2 リリース
へのデフォルトの変更 legacy = 0 AL2023 の今後の四半期リリース
v1 形式は維持されなくなりました 移行期間後

実行する必要があること

コンソール出力、XML 出力を解析するスクリプト、またはディスクから XML ファイルを読み取るスクリプトがある場合は、それらを更新して新しいフィールド名、構造、ファイルパスを処理します。を使用する場合--showjson、JSON 出力は v1 と v2 の間で同じであるため、スクリプトを変更する必要はありません。XML ファイルをディスクから直接読み取る場合は、設定済みの から XML をダウンロードするか、 baseurlを使用しますdnf supportinfo --show installed --showxml。

アクションを必要とする重大な変更

コンソール出力を解析する場合

詳細フィールド

プラグインは、特定のパッケージをクエリするときに表示されるフィールドラベルを変更しました。

v1 ラベル v2 ラベル 注意事項
サポートステータス 現在のステータス 名前が変更されました
サポート期間 サポートタイムライン 名前を変更、出力の末尾に移動
サポートステートメント (削除) 表示されなくなりました
Link Link 変更なし (使用可能な場合に表示されます)
その他の情報 その他の情報 変更なし (使用可能な場合に表示されます)
(存在しない) パッチ優先度 新しいフィールド
(存在しない) サポートレベルの説明 新しいフィールド
(存在しない) 対象重要度 新しいフィールド
(存在しない) オリジン 新しいフィールド

フィールドラベル列の幅が 28 文字になりました (以前は 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

テーブルの列

概要テーブルが 6 列から 7 列に変更されました。v2 テーブルにはヘッダー行も表示されます (v1 では表示されません)。

v1 列 v2 列 変更
名前 パッケージ 名前が変更されました
バージョン バージョン 変更なし
State State 変更なし
サポートステータス 現在のステータス 名前が変更されました
(存在しない) サポートレベル 新しい列
日付 ( など2029-06-30) まで (次のフェーズ) ( など2029-06-30 (end_of_support)) 名前変更、形式変更
メモ メモ 変更なし
重要

日付列に次のフェーズ名が括弧で囲まれるようになりました。このフィールドを解析する場合は、正規表現または区切り記号のロジックを更新します。

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

--showxml 出力を解析する場合

v2 --showxml出力は v1 とは異なる XML 構造を使用します。ルート<package_support>要素は同じですが、子要素、属性、階層が変更されています。

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>

主な構造上の違い:

  • v1 は、marker、start_date、、<summary><text><link>子<statement>を持つ のend_date属性を使用します

  • v2 は、サポートレベルの詳細でcurrent_phase属性とネストされた<phases>要素を使用します

  • v2 は空の場合 (空の要素ではなく) <covered_severities>は完全に省略します

  • v2 パッケージ要素には stateおよび origin 属性が含まれます

  • v2 には、<summary>、<text>、または <link>要素は含まれません

XML ファイルをディスクから直接読み取る場合

v1 プラグインは、次の場所にデータファイルをバンドルしました。

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

このファイルは、 legacy = 0が有効になると更新されなくなります。現在のデータに対してこのパスに依存しないでください。

v2 プラグインは、ルートとして実行される/var/cache/dnf/support-info/と、 にデータをキャッシュします。ルート以外のユーザーとして実行する場合、ユーザーごとの一時ディレクトリに関する DNF の標準規則に従って/var/tmp/dnf-username-*/support-info/、 を使用します。これらのディレクトリ内のファイルはコンテンツアドレス付きファイル名を使用し、安定しません。直接解析しないでください。

推奨される代替方法:

  1. 設定済みの URL から直接 XML をダウンロードします。

    https://cdn.amazonlinux.com/al2023/core/AL2023-supportinfo-1.0.xml
  2. CLI を使用して、インストールされたパッケージの構造化された出力を取得します。

    dnf supportinfo --show installed --showxml

でフィルタリングする場合 --show

--show フィルターで受け入れられる値が変更されました。

v1 フィルター値 v2 フィルター値
supported full_support
unsupported eos

v1 フィルターはフェーズ名 (supported、) ですunsupported。v2 フィルターはサポートレベル名 (full_support、 eosなど) です。

を実行して--list-filters、システムで使用可能なフィルター値を検出します。

dnf supportinfo --list-filters

変更されない内容

v2 dnf-plugin-support-info をインストールすると、legacy設定に関係なく、以下は変わりません。

  • --showjson 出力。プラグインはフォーマット前に v2 内部構造に正規化されるため1、JSON 出力legacyは 0と のどちらでも同じです。

  • CLI 引数。すべてのフラグ (--pkg、--show、、--showxml、--showjson、、--sync) --clean-cache --list-filtersは両方のモードで機能します。

  • コマンド名。は引き続き実行しますdnf supportinfo。

注記

--showjson、--clean-cache、、--list-filtersおよび --syncフラグは v2 では新しく、v1 では利用できません。

移行期間

v2 プラグインは、 legacy = 1の に付属しています/etc/dnf/plugins/supportinfo.conf。その間に、以下が行われます。

  1. プラグインは、設定された URL から v2 データをダウンロードします。

  2. コンソール出力、XML 出力、フィルター値は、引き続き v1 のように動作します。

  3. v1 形式の XML ファイルは古いパスで引き続き使用できるため、既存のスクリプトは引き続き機能します。

将来の AL2023 四半期リリースでは、デフォルトは に変わりますlegacy = 0。その時点で:

  • コンソール出力は v2 フィールド名と構造を使用します。

  • --showxml は、新しいフェーズベースの形式を生成します。

  • --show フィルター値は、レベル名をサポートするように変更されます。

  • 古いパスの v1 XML ファイルは更新されなくなりました。

v1 互換の出力を一時的に維持するには、 legacy = 1で を設定します/etc/dnf/plugins/supportinfo.conf。

[main] legacy = 1
重要

legacy = 1 オプションは一時的なブリッジです。この設定に無期限に依存するのではなく、ツールを v2 出力に移行する計画を立ててください。