プラグイン移行 (1.0.0)

状態: draft / バージョン: 1.0.0 (2025-02-28)

TL;DR

• !! 注意: 古いバージョンからv1.0.0にアップグレードする場合、いくつかの基本的なマイグレーション手順を実行する必要があります。

想定読者

• Dify 1.0.0 へのアップグレードを検討しているチーム
• Plugin Migration 周辺の機能を業務で使うエンジニア／運用者

なぜ重要か

(執筆予定: この機能が解決する課題と運用上のインパクトを書く)

リリースノート抜粋

• !! 注意、古いバージョンから v1.0.0 へアップグレードする場合、いくつかの基本的な移行手順を実行する必要があります。
  v1.0.0 へのアップグレードの最初のステップは、現在の環境で使用されているツールとモデルを新しいプラグイン環境にインストールすることです。データベース移行の前にプラグインのインストールが完了していることを確認し、次のコマンドを実行してください。

poetry run flask extract-plugins --workers=20

このコマンドは、現在の環境で使用されているすべてのモデルとツールを抽出します。workers パラメータは、抽出中の並列プロセスの数を決定します。必要に応じて調整してください。
最終結果は plugins.jsonl ファイルに保存されます。このファイルには、現在の Dify インスタンス内のすべてのワークスペースのプラグイン情報が含まれています。
ネットワークが正常に機能しており、https://marketplace.dify.ai にアクセスできることを確認してから、次のコマンドを実行してください。

poetry run flask install-plugins --workers=2

このコマンドは、必要なすべてのプラグインを最新の環境にダウンロードしてインストールします。

アウトライン（執筆予定）

1. これまでの課題

(執筆予定)

2. 1.0.0 で何が変わったか

(執筆予定 — 上記抜粋を整理)

3. 使い方 / 設定手順

(執筆予定)

4. 運用上の注意点・トレードオフ

(執筆予定)

5. 関連リンク

(執筆予定)

検証が必要な事項

• [ ] 関連 PR 番号の特定
• [ ] 公式 Docs の該当ページ
• [ ] 実際の挙動確認（Dify Cloud or self-host）
• [ ] 既知の制限事項

ソース:
- GitHub Release 1.0.0

本記事は非公式まとめです。正式仕様は Dify 公式ドキュメント をご確認ください。