コンテナのアップデート後にハードウェアトランスコーディングへのアクセスが消えるのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

更新後にハードウェアトランスコードが機能しなくなるのは、再作成されたコンテナから以前と同じデバイス、権限グループ、ランタイム機能、または互換性のあるユーザー空間のスタックが見えなくなることが一般的な原因です。

ホストのGPUが引き続き動作していても、イメージの置き換え後にPlex、Jellyfin、Emby、またはカメラアプリが気づかないうちにCPU処理へフォールバックすることがあります。まず、新しいコンテナ内にデバイスが存在するか、サービスユーザーがデバイスを開けるかを確認します。そのうえで、ランタイムのマッピングと権限を、イメージ固有のコーデックやドライバーのリグレッションと切り分けます。

処理が実際にソフトウェア方式へフォールバックしたことを確認する

トランスコードが必要なファイルを強制的に再生し、メディアサーバーのダッシュボード、FFmpegまたはトランスコーダーのログ、ホストのCPU使用率、GPUエンジンの動作状況を記録します。ダイレクトプレイではハードウェア処理の経路を検証できません。

LinuxServerコミュニティの事例では、CPUの動作だけでは誤解を招くことがあるため、明示的なハードウェア使用状況の指標とGPUのテレメトリーを確認するよう推奨しています。判断のポイントは、条件を制御したトランスコード中にGPUエンジンが実際に使用されていることです。

ログでハードウェアエンコーダーが正常に開かれている場合は、非対応のフィルター、字幕、トーンマッピング、または一部のみのハードウェアアクセラレーションを調べます。デバイスを開けない場合は、ホストでの検出とコンテナからのアクセスを引き続き確認します。

ホストとコンテナ内のGPUデバイスを比較する

更新後のコンテナ内外で、想定されるデバイスノードを一覧にします。IntelまたはAMDのVA-APIでは、/dev/dri/card*と/dev/dri/renderD*を比較します。NVIDIAでは、ランタイムから認識できるか、また管理ツールが報告するデバイスを比較します。

UnraidのQuick Sync事例によると、/dev/driが存在するにはホストで適切なカーネルモジュールが必要な場合があり、コンテナにもそのデバイスを渡す必要があります。欠けていることが多いのは、メディアライブラリやアプリのデータベースではなく、/dev/driデバイスのマッピングです。

ホスト上にデバイスが存在しない場合は、まずホストのドライバー、BIOS、カーネル、またはハードウェアの状態を修復します。ホスト上には存在するもののコンテナ内にない場合は、以前と現在のCompose設定、またはUIで生成されたデバイス設定を比較します。

renderグループとvideoグループへのアクセスを確認する

ホスト上のGPUデバイスノードの数値の所有者IDとグループIDを記録し、コンテナ内のサービスユーザーに割り当てられているグループを確認します。renderなどの名前は、イメージによって異なる数値IDに対応する場合があります。

JellyfinのDockerトラブルシューティング事例では、ホストのrenderグループIDを明示的に一致させ、renderD128の権限を確認する設定が動作することが示されています。この数値によるrenderグループのマッピングは、イメージの変更によって内部のユーザーやグループが変わると、影響を受けることがあります。

デバイスを誰でも書き込み可能にするのではなく、コンテナ定義を通じて必要な補助グループを追加します。コンテナを再作成し、実際のメディアサービスユーザーとしてアクセスをテストします。

ランタイムフラグとイメージ固有の機能を確認する

以前と現在のイメージ定義を比較し、devices、group_add、GPUランタイム設定、機能変数、特権モード、およびコンテナマネージャーのテンプレート変更を確認します。

あるEmbyの報告では、アプリが利用可能な状態のままDockerでハードウェアアクセラレーションが停止しており、この問題を見落としやすくするGPU喪失後のソフトウェアフォールバックの例を示しています。

デバイスアクセスの限定的な問題を、広範な特権アクセスの付与で解決しないでください。エンコーダーの経路で必要となる最小限のデバイス権限とグループ権限を復元してください。

コンテナイメージの回帰とホストの障害を切り分ける

更新済みコンテナで簡単なGPUまたはFFmpegのテストを実行し、同じマウント、デバイスマッピング、メディアファイル、アプリ設定を使って、以前に固定したイメージと比較します。

同じランタイム状態で古いイメージがすぐに動作し、新しいイメージで失敗する場合は、ログを保存し、ユーザー空間、コーデック、FFmpeg、またはアプリケーションの回帰として扱ってください。管理されたイメージ比較でバージョンが原因と特定できているなら、権限を何度も変更しないでください。

ログから原因とわかる場合に限り、再生成可能であると文書化されたコーデックキャッシュのみを消去し、アプリのデータベースとメディアのメタデータには手を加えないでください。回帰の原因が判明するか修正されるまで、正常動作が確認されたイメージを固定してください。

修復後にパイプライン全体を検証する

ハードウェアデコード、エンコード、トーンマッピング、字幕の焼き込み、およびトランスコーディングを強制するクライアントを少なくとも1つテストします。ログに想定されたGPUデバイスが表示され、ホストでエンジンの動作が継続して確認できることを確かめます。

ZimaSpaceの手順実際のハードウェアトランスコーディングを確認するは、設定ページの切り替えよりも確実な完了テストになります。

更新済みまたは固定済みのコンテナが、再作成や再起動後もデバイスへのアクセスを維持し、想定されたコーデック経路でGPUを使用し、ひそかにフォールバックしなくなって初めて、問題が解決したと言えます。次回の更新に備え、以前のイメージダイジェストとランタイム定義をロールバックの基準として保持してください。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.