すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ACK クラスターにおける Dify コンポーネントのアップグレードガイド

    ドキュメントセンター

    Container Service for Kubernetes:ACK クラスターにおける Dify コンポーネントのアップグレードガイド

    最終更新日:Nov 09, 2025

    このトピックでは、Container Service for Kubernetes (ACK) クラスターで ack-dify を以前のバージョンから 1.0.0 以降にアップグレードする方法について説明します。アップグレードを実行するには、ack-dify データをバックアップし、コマンドを実行してプラグインを抽出しインストールし、データを移行し、プラグインが正常に動作することを確認する必要があります。これらのステップを完了すると、新しいプラグインエコシステムを使用できます。

    適用範囲

    • 現在のバージョン：1.0.0 より前。

    • ターゲットバージョン：1.0.0 以降。

    1. ack-dify のデータをバックアップする

    バックアップセンター機能を使用して、dify-system 名前空間の ack-dify アプリケーションのデータをバックアップします。詳細については、「即時バックアップ」をご参照ください。

    2. ack-dify をアップグレードする

    Container Service 管理コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] を選択します。ターゲットクラスターの名前をクリックします。クラスター詳細ページで、[アプリケーション] > [Helm] を選択します。Helm ページで ack-dify を見つけ、[更新] をクリックします。次に、最新バージョンを選択し、[OK] をクリックして ack-dify コンポーネントの更新を完了します。

    3. プラグインを移行する

    3.1 ack-dify API コンテナにログインする

    kubectl exec -it <ack-dify-api-xxxxx-xxxxx> -n dify-system -- bash

    3.2 プラグインを抽出する

    poetry run flask extract-plugins --workers=20
    説明

    システムがコンテンツの入力を求めるプロンプトを表示した場合は、Enter を押してプロンプトをスキップします。

    3.3 プラグインをインストールする

    poetry run flask install-plugins --workers=2
    重要

    クラスターがインターネットおよび https://marketplace.dify.ai にアクセスできることを確認してください。

    4. データの移行

    互換性を高めるために、ack-dify が以前のバージョンにロールバックされていないことを確認し、次のコマンドを実行してデータを移行します。

    poetry run flask migrate-data-for-plugin

    5. アップグレードを確認する

    • Dify プラットフォームにアクセスします。

    • Dify プラットフォームにプラグインがインストールされているかどうかを確認します。

    • ランダムなプラグインを選択し、プラグインが正常に動作するかどうかをテストして、データ移行を確認します。

    ロールバック

    ack-dify を以前のバージョンにロールバックする場合は、次の手順を実行します。

    1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。管理するクラスターの名前をクリックします。クラスター詳細ページで、[アプリケーション] > [Helm] を選択します。Helm ページで ack-dify リリースを見つけ、[アクション] 列の [削除] をクリックします。[OK] をクリックします。次に、ack-dify が使用するすべての永続ボリューム要求 (PVC) を手動で削除します。

    2. バックアップセンター機能を使用して ack-dify を復元します。

      • 対応するバックアップボールトで作成した バックアップファイル を選択します。

      • データを dify-system 名前空間に復元します。復元が完了すると、ack-dify にアクセスできます。

    重要

    • データ移行が完了し、プラグインが正常に動作することを確認するために、ack-dify をアップグレード直後にロールバックしないでください。

    • アップグレード中に問題が発生した場合は、Community Edition を v1.0.0 に移行する を参照してください。

    FAQ

    1. バックアップファイルからデータを復元するのに必要な時間は、データ量とネットワークの状態によって異なります。

    2. プラグインの移行に失敗した場合は、クラスターが https://marketplace.dify.ai にアクセスできるかどうかを確認してください。

    3. データの移行に失敗した場合は、移行コマンドを再実行してください。

    免責事項

    ACK 上の Dify は、オープンソースの Dify プロジェクトを Alibaba Cloud ACK 環境に適応させ、迅速なデプロイメントを可能にする Helm デプロイメントソリューションです。ACK は、Dify アプリケーション自体の動作や、プラグインやデータベースなどの他のエコシステムコンポーネントとの互換性を保証するものではありません。ACK は、Dify またはそのエコシステムコンポーネントの欠陥によって生じた事業上の損失に対して、補償やその他の商業サービスを提供するものではありません。オープンソースコミュニティからの更新をフォローし、オープンソースソフトウェアの問題を積極的に修正して、お客様の Dify デプロイメントの安定性とセキュリティを確保することをお勧めします。