すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:XXL-JOB を介した Dify ワークフローのスケジューリング

    ドキュメントセンター

    Container Service for Kubernetes:XXL-JOB を介した Dify ワークフローのスケジューリング

    最終更新日:Nov 10, 2025

    Dify ワークフローは、リスク監視、データ分析、コンテンツ生成、データ同期、その他の典型的なアプリケーションシナリオなど、多くのシナリオで自動タスクを実装するためにスケジューリングが必要です。しかし、Dify はネイティブではスケジューリング機能をサポートしていません。このトピックでは、XXL-JOB 分散タスクスケジューリングを統合して、ワークフローアプリケーションのスケジューリングとステータス監視を実装し、ワークフローの安定した運用を確保する方法について説明します。

    XXL-JOB スケジューリングの コア機能

    機能

    概要

    タスクサポート

    インターネット上の自己構築 Dify ワークフローと、Alibaba Cloud 内部ネットワーク環境の自己構築 Dify ワークフローのスケジューリングをサポートします。

    柔軟な時間構成

    • 複数の時間タイプをサポート: cron、fixed_rate、fixed_delay、one_time、および API スケジューリング。時間精度は秒単位です。

    • タイムゾーン設定とカスタムカレンダーをサポートし、グローバルなビジネス要件に対応します。

    エンタープライズレベルのアラートと監視

    • CloudMonitor の連絡先と連絡先グループ管理を統合し、包括的なエンタープライズレベルのアラートサポートを提供します。

    • 柔軟なアラートポリシー:

      • タスクレベル: 失敗アラート、タイムアウトアラート、成功通知。

      • インスタンスおよびアプリケーションレベル: しきい値アラート。

    • マルチチャネルメッセージ通知: ショートメッセージ、電話、Webhook、メールなどの複数の通知方法をサポートします。

    可観測性とスケジューリングダッシュボード

    インスタンスおよびアプリケーションレベルでスケジューリング情報を表示するエンタープライズレベルのスケジューリングダッシュボードを提供します。これには、スケジューリングの傾向、成功率、失敗率などの主要なメトリック曲線が含まれます。

    実行履歴とイベント追跡

    • 実行履歴: 各 Dify ワークフローの実行詳細を記録します。これには、ステータス、基本情報、入出力パラメーター、時間消費、トークン消費が含まれます。

    • スケジューリングイベント: 各スケジュールに関連するイベントを記録し、ワークフローおよびノードレベルのイベント情報をカバーします。

    • ノード追跡: ワークフロー実行におけるすべてのノードの操作を詳細に記録し、ループ、反復、条件分岐の詳細なドリルダウン分析をサポートします。

    ソリューション概要

    XXL-JOB を構成して Dify ワークフローアプリケーションをスケジュールするには、わずか 3 ステップで完了します:

    1. Dify 環境の作成: ACK クラスターを作成し、クラスターに ack-dify コンポーネントをインストールし、Dify サービスにアクセスして、ワークフローアプリケーションを作成します。

    2. スケジューリングインスタンスの作成と構成: XXL-JOB スケジューリングインスタンスを作成し、インスタンス内にアプリケーションを作成してタスクをグループ化および管理し、次にタスクパラメーターを構成して Dify ワークフローアプリケーションに接続します。

    3. 統合のテスト: 分散スケジューリング機能が正常に動作することを確認し、スケジューリングが成功した後にスケジューリングの詳細を表示します。

    1. Dify 環境の作成

    ① Dify 環境のデプロイ

    ワンクリックで Dify 環境をデプロイして、ack-dify コンポーネントのインストールや Dify サービスのインターネットアクセスの有効化などの操作を完了します。

    説明

    インターネットアクセスはデモンストレーション目的で便利です。本番環境にデプロイする場合、アプリケーションデータのセキュリティのために、[Resource Access Management] 機能を有効にすることをお勧めします。

    初めて ACK クラスターを使用し、クラスターの作成プロセスに慣れていない場合、ワンクリックデプロイ をクリックして、Dify サービスに必要なランタイム環境を作成できます。このソリューションでは、ACK マーケットプレイスの ack-dify アプリケーションテンプレートを使用して、Helm を介して Dify アプリケーションを低コストで迅速にデプロイし、開発およびテスト要件を満たします。

    重要

    ワンクリックデプロイを使用する前に、Container Service ACK クラスターを アクティベートおよび承認 しているかどうかを確認することをお勧めします。詳細については、「ACK マネージドクラスターのクイック作成」をご参照ください。

    1. [ワンクリックデプロイ] をクリックし、[リソースオーケストレーションサービス] でリージョン (オプション) 中国 (杭州) を選択し、ROS テンプレートに従ってクラスターの [ゾーン]、[インスタンス仕様]、[インスタンスパスワード]、[セキュリティ確認]、およびその他の重要な情報を選択します。残りの情報はデフォルトのままにします。設定が完了したら、[作成] をクリックします。

    2. クラスターには多くのリソースが必要なため、完了するまで辛抱強く 約 10 分 待つ必要があります。クラスターが作成されたら、Container Service コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。ターゲットクラスターの名前をクリックしてクラスター詳細ページに移動し、[ワークロード] > [Pod] をクリックします。名前空間は dify-system です。ターゲットクラスターに [Ack-dify コンポーネント] リソースが正しくインストールされているかどうかを確認します。

    3. (オプション) Pod が保留状態にある場合、既存のクラスターに ack-dify の PVC 依存関係がない可能性があります。クラスターにデフォルトの CNFS ファイルシステムと対応する NAS StorageClass を作成します。詳細については、「CNFS を使用して NAS ファイルシステムを管理する (推奨)」をご参照ください。Pod の例外のトラブルシューティングの詳細については、「Pod の例外のトラブルシューティング」をご参照ください。

    [Ack-dify コンポーネント] がインストールされたら、次のステップに進むことができます。

    ② 外部 IP アドレスの表示

    構成が完了したら、[サービス] > [サービス] > [ack-dify] をクリックします。名前空間は dify-system です。ack-dify サービスの [外部 IP アドレス] が表示されます。この外部 IP アドレスをブラウザのアドレスバーに入力して、Dify サービスにアクセスします。

    image

    ③ Dify サービスへの登録

    [外部 IP アドレス] にアクセスし、ページのプロンプトに従って [管理者アカウントの設定] (メールアドレス、ユーザー名、パスワード) を行い、Dify プラットフォームに登録してサービスを使用します。

    image

    ④ Dify ワークフローアプリケーションの作成

    後続のスケジューリングテストのために、簡単な Dify ワークフローの例を作成する必要があります。提供されたファイル dify-flow.yml を Dify にインポートして、ワークフローアプリケーションを迅速に構築し、更新の公開を完了できます。

    重要

    XXL-JOB を介した Dify ワークフローのスケジューリングは、Dify ワークフローアプリケーションのみをサポートします。チャットタイプのアプリケーションは現在サポートされていません。

    image

    2. スケジューリングインスタンスの作成と構成

    ① インスタンスの作成

    XXL-JOB コンソールにログインし、トップメニューバーでリージョンを選択し、[インスタンスの作成] をクリックします。エンジンバージョンは 2.2.0 以上である必要があります。

    • リージョン: Dify クラスター 環境のリージョンと一致している必要があります。

    • インスタンス名: Dify-demo。

    • VPC: Dify クラスター 環境の VPC と一致している必要があります。

    image

    ② アプリケーションの作成

    XXL-JOB タスクを使用する前に、まずアプリケーションを作成する必要があります。アプリケーションの作成は、タスクの論理的なグループ化と管理のためです。各アプリケーションは独立したタスク実行単位と見なすことができ、後でタスクを統一的に表示、構成、スケジュールするのが容易になります。

    XXL-JOB インスタンスページで、ターゲットインスタンスを見つけ、[アクション] 列の [タスク管理] をクリックします。左側のナビゲーションウィンドウで、[アプリケーション管理] を選択し、[アプリケーションの作成] をクリックします。

    • AppName: 例: Dify-AppName。

    • 名前: 例: Dify-AppName。

    • AccessToken: システムによって自動的に生成されます。

    image

    ③ タスクの作成

    タスクは、特定のビジネスロジックのスケジューリング単位です。アプリケーションが作成された後、タスクエグゼキュータにバインドする必要があります。エグゼキュータは AppName を介してアプリケーションに登録し、そのアプリケーションの下でタスクを実行します。

    説明

    事前にアプリケーションを作成しないと、エグゼキュータが正しく登録できず、タスクのスケジューリングと実行が正常に失敗します。

    • タスク名: Dify-test。

    • 関連アプリケーション: 作成されたアプリケーション (例: Dify-AppName)。

    • タスクタイプ: Dify ワークフロー。

    • その他: デフォルトのままにします。

    image

    ④ タスクパラメーターの構成

    Dify ワークフローアプリケーションが公開および更新された後、[API にアクセス] を選択して、必要なタスクパラメーターを表示します。

    • エンドポイント: Dify ワークフローの API サーバー。

    • API キー: Dify ワークフローの API キー。ワークフローごとにキーが異なります。

    • 入力: JSON 形式のワークフローの入力。

      {"input_text": "what is your name"}

    image

    3. 統合のテスト

    ① テストタスクの実行

    分散スケジューリング機能が正常に動作することを確認するには、タスクスケジューリングをテストする必要があります。[タスク管理] を選択し、[一度実行] をクリックして、スケジュールされたタスクをテストできます。

    image

    ② スケジューリング詳細の表示

    [実行リスト] を選択し、[詳細] をクリックしてスケジューリングタスクの詳細を表示します。テストスケジューリングタスクが成功したことを確認し、詳細を表示できます。

    image.png

    ③ 詳細情報

    • [詳細] をクリックして 基本情報 を表示します。

    • [詳細] をクリックして 入力と出力 を表示します。

    • [詳細] をクリックして ノード追跡 を表示します。

      説明

      イテレータやループ分岐などの構造については、さらに詳細なノード情報やデータを表示できます。

    image.png

    免責事項

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