PAI-EAS は、Dify のためのマネージドホスティングと弾力的なスケーリングを提供します。これにより、チームはインフラストラクチャのメンテナンスではなく、アプリケーションロジックに集中でき、プロトタイプから本番環境への移行を加速させることができます。
仕組み
このソリューションは、PAI-EAS 上で Dify をホストし、外部依存関係をマウントして完全なサービスを構築します。アーキテクチャは、PAI-EAS サービスインスタンスと、Virtual Private Cloud (VPC) を介して安全に通信する外部クラウドサービスで構成されます。
アーキテクチャのコアコンポーネントは次のとおりです:
-
PAI-EAS サービス:コアコンピューティングプラットフォームとして、PAI-EAS は Web UI、API バックエンド、非同期タスクワーカー、プラグインサンドボックスなど、すべての Dify サービスコンポーネントをマルチコンテナ環境で実行します。サービスのライフサイクル管理、リソーススケジューリング、ネットワーク設定を処理します。
-
ApsaraDB RDS for PostgreSQL:ユーザー、会話、ナレッジベース、ワークフロー、プラグイン設定のデータを保存し、データの永続性とコンピューティングレイヤーからの独立性を確保します。
-
ApsaraDB for Redis:高性能キャッシングとメッセージキューイングを提供し、ホットデータのキャッシュ、セッション状態の管理、Celery Broker を介した Dify コンポーネント間での非同期タスクの分散に使用されます。
-
Alibaba Cloud Elasticsearch:ベクトルデータベースおよび全文検索エンジンとして機能します。検索拡張生成 (RAG) シナリオでは、ナレッジベースのドキュメントを保存、インデックス作成し、効率的に取得します。
-
Object Storage Service (OSS):Dify アプリケーションプラグイン、アップロードされたナレッジベースファイル、その他のデータに永続的なファイルストレージを提供し、サービスの更新または再起動後にデータが失われないようにします。
ユーザーは、PAI-EAS が提供する Web サービスエンドポイントを介して Dify にアクセスします。すべてのリクエストは、Nginx コンテナによって Dify-Web または Dify-API コンテナにルーティングされます。API サービスは、ビジネスロジックのために ApsaraDB RDS for PostgreSQL、ApsaraDB for Redis、および Alibaba Cloud Elasticsearch と対話します。ドキュメントのインデックス作成などの非同期タスクは、Redis を介してワーカーコンテナにディスパッチされます。永続ファイルは、マウントされた OSS パスから読み書きされます。
ステップ 1:必要なリソースの準備
Dify をデプロイする前に、必要な外部依存関係を準備します。ネットワーク接続を確保するために、すべてのリソースは PAI-EAS サービスと同じリージョンおよび VPC に存在する必要があります。
ApsaraDB RDS for PostgreSQL および Alibaba Cloud Elasticsearch インスタンスは、作成後に別の VPC に移動することはできません。インスタンス作成時に、PAI-EAS サービスと同じ VPC を選択する必要があります。
-
VPC を計画します。VPC がない場合は、VPC と vSwitch を作成します。
-
ApsaraDB RDS for PostgreSQL インスタンスを作成します。インスタンスが作成されたら、その特権アカウントを作成します。このアカウントを使用して、Dify のコア機能データ用とプラグインデータ用の 2 つのデータベースを作成します。詳細については、「アカウントとデータベースの作成」をご参照ください。
重要PostgreSQL 16 を選択することを推奨します。PostgreSQL 18 を使用すると、uuidv7 関数の競合が発生する可能性があります。
-
ApsaraDB for Redis インスタンスを作成します。PAI-EAS コンテナがインスタンスにアクセスできるようにするには、PAI-EAS サービス用の vSwitch の IP アドレス範囲を Redis インスタンスのアローリストに追加する必要があります。この情報は、VPC コンソールの vSwitch 詳細ページで確認できます。
-
Alibaba Cloud Elasticsearch インスタンスを作成します。このインスタンスは、ナレッジベースでのベクトルストレージと全文検索に使用されます。PAI-EAS サービスと同じ VPC にあることを確認してください。
ステップ 2:Dify サービスのデプロイ
-
PAI コンソールにログインします。ページ上部でリージョンを選択します。次に、目的のワークスペースを選択し、[Elastic Algorithm Service (EAS)] をクリックします。
-
Inference Service タブで、Deploy Service をクリックします。Scenario-based Model Deployment セクションで、Dify LLM platform をクリックします。
-
デプロイページで、次のパラメーターを設定します。
-
OSS:OSS バケットを選択し、ナレッジベースファイルとプラグインデータを永続的に保存するパスを指定します。このパスには `dify` と `dify_plugin` の 2 つのフォルダが作成されます。
-
PostgreSQL configuration:
-
Host Address:ApsaraDB RDS for PostgreSQL インスタンスの内部エンドポイントを入力します。確認するには、ApsaraDB RDS for PostgreSQL コンソールでインスタンスの データベースの接続 ページに移動します。
-
Port:デフォルトは 5432 です。異なる場合は実際のポートを入力します。
-
Database - core data:アプリケーション、ユーザー、会話、ナレッジベース、ワークフロー、モデル設定など、すべてのコア機能データを保存するデータベースの名前を入力します。
-
Database plugins:プラグインのランタイムステータス、設定、メタデータに関連する情報を永続的に保存するために作成されたデータベースの名前を入力します。
-
Account と Password:データベースの作成に使用した特権アカウントとパスワードを入力します。
-
-
Redis config:
-
Host:ApsaraDB for Redis インスタンスの内部エンドポイントを入力します。ApsaraDB for Redis コンソールに移動し、インスタンス詳細ページに移動して、[接続情報] セクションからエンドポイントを取得します。
-
Port:デフォルトは 6379 です。異なる場合は実際のポートを入力します。
-
Account と Password:ApsaraDB for Redis インスタンスのアカウントとパスワードを入力します。
-
-
Elasticsearch configuration:
-
Host address:Alibaba Cloud Elasticsearch インスタンスの内部エンドポイントを入力します。Alibaba Cloud Elasticsearch コンソールに移動し、インスタンス詳細ページに移動して、[基本情報] セクションからエンドポイントを取得します。
-
Port:デフォルトは 9200 です。異なる場合は実際のポートを入力します。
-
Account と Password:Alibaba Cloud Elasticsearch インスタンスのユーザー名 (デフォルトは `elastic`) とパスワードを入力します。パスワードを忘れた場合は、リセットできます。
-
-
Resource Specification:サービスをデプロイするための PAI-EAS インスタンス仕様を選択します。安定したサービスオペレーションを確保するために、少なくとも 8 vCPU と 16 GB のメモリを持つ仕様を推奨します。
-
-
すべての構成が正しいことを確認したら、Deploy をクリックします。サービスステータスが Deploy に変更されると、デプロイメントは成功です。
ステップ 3:デプロイの検証
デプロイ後、サービスステータスを確認し、その機能を検証します。
-
サービスログの確認
サービスが起動に失敗した場合や異常に実行された場合は、サービス詳細ページの [インスタンスリスト] に移動し、対応するコンテナコンポーネントを見つけて、その横にある [ログ] ボタンをクリックします。起動ログとランタイムログを確認して、エラーの原因を特定します。
-
Dify Web UI へのアクセス
サービス詳細ページで、右上隅にある Web applications をクリックして Dify の初期化ページを開きます。管理者アカウントを作成してアプリケーションの使用を開始します。
-
API の呼び出し
Dify アプリケーションが作成された後、API アクセスページに表示されるベース URL は内部サービスアドレスです。Dify アプリケーションで、左側のナビゲーションウィンドウで [API にアクセス] をクリックして [ベース URL] を表示します。インターネットから Dify API を呼び出すには、このベース URL (例:
http://******.console.cn-hangzhou.eas.pai-ml.com) を PAI-EAS サービスのパブリックエンドポイントに置き換えます。サービスの [呼び出し方法] ダイアログボックスで、[共有ゲートウェイ] タブに切り替えて、パブリックエンドポイント (curl コマンドのサービス URL)、VPC エンドポイント、および トークン を取得します。API キーを作成した後、API を介してアプリケーションと対話できます。左側のナビゲーションウィンドウで、[API にアクセス] をクリックします。API ページで、右上隅にある [API キー] をクリックします。表示されるダイアログボックスで、[+ シークレットキーを作成] をクリックして API キーを生成します。このキーは、API 呼び出しでの
Authorization: Bearer認証に使用されます。次の例は、パブリック API 呼び出しを使用してチャットボットアプリケーションにメッセージを送信する方法を示しています:
curl -X POST 'http://xxxx.your_aliyun_account_id.cn-hangzhou.pai-eas.aliyuncs.com/v1/chat-messages' \ --header 'Authorization: Bearer app-xxxxxxxxxxxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "inputs": {}, "query": "Tell me about the main features of Dify", "response_mode": "blocking", "user": "test-user-001" }'
ステップ 4:JSON を使用した高度なデプロイ
自動化された、または高度にカスタマイズされたデプロイには、JSON 設定ファイルを使用します。次のテンプレートは、Dify に必要なすべてのコンテナ、環境変数、ストレージマウント、およびネットワーク設定を定義します。PAI-EAS サービスデプロイページで、[JSON デプロイ] に切り替えてテンプレートを貼り付けます。
テンプレート内のプレースホルダー ($ プレフィックス付き) を実際の値に置き換えます。パラメーターの詳細については、「JSON デプロイ」をご参照ください。
-
metadata セクションでは、Web アクセスポートを開くために
"enable_webservice": trueを設定する必要があります。 -
storage セクションでは、
$oss_pathを実際の OSS パス (例: "oss://your-bucket-name/dify-data/") に置き換えます。このパスは Dify API とプラグインによって使用され、その下に `dify` と `dify_plugin` の 2 つのフォルダが作成されます。 -
containers セクションでは、いくつかの環境変数を置き換える必要があります。次のリストでこれらの変数について説明します。詳細については、「Dify 環境変数」をご参照ください。
PostgreSQL 設定
-
db_host:ApsaraDB RDS for PostgreSQL インスタンスのエンドポイント。
-
db_port:デフォルトは 5432 です。
-
api_db:Dify のコア機能用データベース。アプリケーション、ユーザー、会話、ナレッジベース、ワークフロー、モデル設定など、コア機能に関連するすべてのデータを永続的に保存します。
-
plugin_daemon_db:Dify プラグイン用データベース。プラグインのランタイムステータス、設定、メタデータに関連する情報を永続的に保存します。
-
db_username と db_password:両方のデータベースで同じユーザー名とパスワードを共有します。
Redis 設定
Redis は、AI との会話中にサービスコンポーネント間のリアルタイムメッセージングと通信を容易にします。
-
redis_host:ApsaraDB for Redis インスタンスの接続エンドポイント。
-
redis_port:デフォルトは 6379 です。
-
redis_password:ApsaraDB for Redis インスタンスを作成したときに設定したパスワード。
Elasticsearch 設定
ベクトルストレージと全文検索機能を提供します。
-
elasticsearch_host:Alibaba Cloud Elasticsearch インスタンスの接続エンドポイント。
-
elasticsearch_port:デフォルトは 9200 です。
-
elasticsearch_username:デフォルトは `elastic` です。
-
elasticsearch_password:Alibaba Cloud Elasticsearch インスタンスを作成したときに設定したパスワード。パスワードを忘れた場合は、インスタンスのアクセスパスワードをリセットできます。
セキュリティキー
Dify は、内部通信を保護し、データを保護するためにいくつかのキーを使用します。各キーは
openssl rand -base64 42コマンドで生成します。-
secret_key:セッションクッキーに安全に署名し、データベース内の機密情報を暗号化するために使用されるキー。
-
api_key:不正な外部呼び出しを防ぐために、内部 API アクセスに必要なキー。
-
plugin_daemon_key:不正な外部呼び出しを防ぐために、`plugin_daemon` サービスへの内部アクセスに必要なキー。
-
よくある質問
データベース接続の問題
[2025-09-13 00:46:28] [/bin/sh]: 2025/09/12 16:46:28 /app/internal/db/pg/pg.go:34
[2025-09-13 00:46:28] [/bin/sh]: [error] failed to initialize database, got error failed to connect to `host=pgm-xxxxxxxxxx.pg.rds.aliyuncs.com user=dify database=postgres`: dial error (timeout: dial tcp 10.0.0.230:5432: connect: connection timed out)
[2025-09-13 00:46:28] [/bin/sh]: 2025/09/12 16:46:28 init.go:95: [PANIC]failed to init dify plugin db: failed to connect to `host=pgm-xxxxxxxxxx.pg.rds.aliyuncs.com user=dify database=postgres`: dial error (timeout: dial tcp 10.0.0.230:5432: connect: connection timed out)
[2025-09-13 00:46:28] [/bin/sh]: panic: [PANIC]failed to init dify plugin db: failed to connect to `host=pgm-xxxxxxxxxx.pg.rds.aliyuncs.com user=dify database=postgres`: dial error (timeout: dial tcp 10.0.0.230:5432: connect: connection timed out)
ApsaraDB RDS for PostgreSQL インスタンスが PAI-EAS サービスと同じ VPC にあることを確認してください。ApsaraDB RDS for PostgreSQL インスタンスは別の VPC に移動できません。正しい VPC に新しいインスタンスを作成する必要があります。
ApsaraDB RDS for PostgreSQL コンソールでインスタンス詳細ページの左側のナビゲーションウィンドウで [データベース接続] をクリックして、インスタンスの VPC 名と内部エンドポイントを表示します。デフォルトのポートは 5432 です。
Redis 接続の問題
dify-api の Redis クライアントが Redis サーバーに接続できません。
[2025-09-13 00:28:21] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/redis/utils.py", line 188, in wrapper
[2025-09-13 00:28:21] [/bin/sh]: return func(*args, **kwargs)
[2025-09-13 00:28:21] [/bin/sh]: ^^^^^^^^^^^^^^^^^^^^^
[2025-09-13 00:28:21] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/redis/connection.py", line 1530, in get_connection
[2025-09-13 00:28:21] [/bin/sh]: connection.connect()
[2025-09-13 00:28:21] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/redis/connection.py", line 379, in connect
[2025-09-13 00:28:21] [/bin/sh]: self.connect_check_health(check_health=True)
[2025-09-13 00:28:21] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/redis/connection.py", line 389, in connect_check_health
[2025-09-13 00:28:21] [/bin/sh]: raise TimeoutError("Timeout connecting to server")
[2025-09-13 00:28:21] [/bin/sh]: redis.exceptions.TimeoutError: Timeout connecting to server
[2025-09-13 00:28:22] time="2025-09-12T16:28:22Z" level=info msg="program stopped with status:exit status 1" program=/bin/sh
考えられる原因:
-
VPC ネットワークの問題:ApsaraDB for Redis インスタンスが PAI-EAS サービスと同じ VPC にあることを確認します。
ApsaraDB for Redis インスタンスの [インスタンス情報] ページの [基本情報] セクションで [VPC] フィールドを表示して、その VPC ID を確認します。
-
アローリスト設定の問題:Redis インスタンスにアローリストが設定されていることを確認します。PAI-EAS サービス用の vSwitch の IP アドレス範囲を追加する必要があります。vSwitch ページで IP アドレス範囲を確認できます。
たとえば、[ホワイトリスト設定] ページで、vSwitch CIDR ブロック
192.168.32.0/22をアローリストグループに追加します。
Elasticsearch 接続の問題
考えられる原因は VPC ネットワークの問題です。Alibaba Cloud Elasticsearch インスタンスが PAI-EAS サービスと同じ VPC にあることを確認してください。
Alibaba Cloud Elasticsearch インスタンスの [基本情報] ページで、[VPC] フィールドをチェックしてインスタンスの VPC ID を取得します。
「データベースが存在しません」エラー
Dify が起動すると、dify-api 用のコアデータデータベースと dify-plugin 用のプラグインデータベースの 2 つのデータベースに接続します。
[2025-09-13 01:33:20] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/sqlalchemy/engine/default.py", line 625, in connect
[2025-09-13 01:33:20] [/bin/sh]: return self.loaded_dbapi.connect(*cargs, **cparams) # type: ignore[no-any-return] # NOQA: E501
[2025-09-13 01:33:20] [/bin/sh]: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[2025-09-13 01:33:20] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/psycopg2/__init__.py", line 122, in connect
[2025-09-13 01:33:20] [/bin/sh]: conn = _connect(dsn, connection_factory=connection_factory, **kwasync)
[2025-09-13 01:33:20] [/bin/sh]: ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[2025-09-13 01:33:20] [/bin/sh]: File "/app/api/.venv/lib/python3.12/site-packages/psycogreen/gevent.py", line 32, in gevent_wait_callback
[2025-09-13 01:33:20] [/bin/sh]: state = conn.poll()
[2025-09-13 01:33:20] [/bin/sh]: ^^^^^^^^^^^
[2025-09-13 01:33:20] [/bin/sh]: sqlalchemy.exc.OperationalError: (psycopg2.OperationalError) FATAL: database "dify_core" does not exist
[2025-09-13 01:33:20] [/bin/sh]:
このデプロイで使用される Dify Community Edition 1.7.1 では、プラグインデータベースは自動的に作成されますが、コアデータデータベースは作成されません。手動で作成する必要があります。
marketplace.dify.ai に接続できない
PAI-EAS コンテナは、デフォルトではパブリックインターネットにアクセスできません。これを解決するには、「PAI-EAS サービスがパブリックまたは内部リソースにアクセスできるようにする」をご参照ください。
[2025-09-13 00:00:00] [/bin/sh]: 2025-09-12 16:00:00,847.847 WARNING [Dummy-1] [ssrf_proxy.py:81] - Request to URL https://marketplace.dify.ai/api/v1/plugins/download?unique_identifier=langgenius/tongyi:0.0.46@8e73008929dbc393493d442fab4c34ef016ae817b144b45da278ba76580e failed on attempt 1: timed out
[2025-09-13 00:00:02] [/bin/sh]: 2025-09-12 16:00:02,046.046 WARNING [Dummy-2] [ssrf_proxy.py:81] - Request to URL https://marketplace.dify.ai/api/v1/plugins/download?unique_identifier=langgenius/tongyi:0.0.46@8e73008929dbc393493d442fab4c34ef016ae817b144b45da278ba76580e failed on attempt 1: timed out
[2025-09-13 00:00:06] [/bin/sh]: 2025-09-12 16:00:06,416.416 WARNING [Dummy-1] [ssrf_proxy.py:81] - Request to URL https://marketplace.dify.ai/api/v1/plugins/download?unique_identifier=langgenius/tongyi:0.0.46@8e73008929dbc393493d442fab4c34ef016ae817b144b45da278ba76580e failed on attempt 2: timed out
[2025-09-13 00:00:07] [/bin/sh]: 2025-09-12 16:00:07,614.614 WARNING [Dummy-2] [ssrf_proxy.py:81] - Request to URL https://marketplace.dify.ai/api/v1/plugins/download?unique_identifier=langgenius/tongyi:0.0.