moviepilot-update

MoviePilot の更新

MoviePilot の再起動とアップグレードの操作には、このスキルを使用します。

組み込みの moviepilot_api ツールのみを使用してください。ホストは固定の API ルートを選択し、信頼された Agent の ID で認証を行い、管理者権限と確認のポリシーを適用します。API トークン、URL、HTTP メソッド、シェルコマンド、またはレガシーのヘルパースクリプトを要求したり、渡したりしないでください。

操作

バージョンを確認する

{"operation_id":"system.versions","path_params":{},"query":{},"body":{}}

この読み取り専用の操作では、利用可能な MoviePilot のリリースが一覧表示されます。

MoviePilot を再起動する

{"operation_id":"system.restart","path_params":{},"query":{},"body":{}}

再起動には明示的な確認が必要で、現在の Agent セッションが中断されます。

Release を更新する

最新の安定版 V3 Release を確認し、現在の進行状況を調べます。手動で確認すると、古い準備済みの対象がより新しいバージョンに置き換わる場合があります。確認に失敗した場合、ダウンロード済みパッケージは保持されます。

{"operation_id":"system.update.check","path_params":{},"query":{},"body":{}}
{"operation_id":"system.update.status","path_params":{},"query":{},"body":{}}

supports_batch_update=true の場合は、最新のバックエンド、対応するフロントエンド、サイトリソースをまとめて準備します。これによって MoviePilot が再起動することはありません。

{"operation_id":"system.update.download","path_params":{},"query":{},"body":{"target":"all"}}

updates 内の state=ready ではないすべての項目が state=ready を報告し、確認エラーのある項目がないことを確認してから、別途明示的な確認を得てインストールしてください。

{"operation_id":"system.update.install","path_params":{},"query":{},"body":{"target":"all"}}

install は検証済みのインストール指示を1つ書き込み、MoviePilot を1回再起動します。ユーザーが再起動を明示的に確認するまで、これを呼び出さないでください。特定の単一対象の更新をユーザーが要求した場合は、target=application または target=resources を使用してください。supports_batch_update に対応していない古いホストでは、単一対象のフローを維持してください。対象を省略すると、デフォルトで application になります。

Dev の更新と再起動

{"operation_id":"system.upgrade.dev","path_params":{},"query":{},"body":"dev"}

本文は、正確な JSON 文字列 "dev" でなければなりません。Stable Release の更新では、代わりに check、download、status、install を使用してください。

注意事項

• すべての操作には、MoviePilot の管理者、または検証済みの通知チャネル管理者が必要です。ホストが認可を処理します。モデルは管理者フラグを決して捏造してはなりません。
• 現在のエージェントセッションが中断されるのは、再起動、Release のインストール、Dev のアップグレードのみです。確認とダウンロードはオンラインのまま実行されます。
• スケジュールされた確認では、ダウンロード済みパッケージが保持されます。明示的な確認では、より高いバージョンが存在する場合に限り、古い準備済みの対象が更新されます。進行中のダウンロードとインストールは保護されます。以前に上書きされたリソースの状態は、対応するステージ済みパッケージの検証後に ready に復旧する場合があります。各対象を確認するには updates を使用し、再度ダウンロードするのではなく、インストールの確認を求めてください。
• 上記の API フローを優先してください。API を利用できない場合に限り、手動のコンテナーコマンドに切り替えてください。