diff --git a/ja/self-host/platform-guides/dify-premium.mdx b/ja/self-host/platform-guides/dify-premium.mdx index 64dd3a438..1e33ff108 100644 --- a/ja/self-host/platform-guides/dify-premium.mdx +++ b/ja/self-host/platform-guides/dify-premium.mdx @@ -4,126 +4,82 @@ title: AWS上のDify Premium ⚠️ このドキュメントはAIによって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/self-host/platform-guides/dify-premium)を参照してください。 -Dify Premiumは、カスタムブランディングを可能にし、EC2としてAWS VPCにワンクリックでデプロイできるAWS AMIサービスです。[AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6)にアクセスして購読してください。以下のようなシナリオで有用です： +Dify Premiumは、カスタムブランディングを可能にし、EC2インスタンスとしてAWS VPCにワンクリックでデプロイできるAWS AMIサービスです。[AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6)にアクセスして購読してください。以下のようなシナリオで有用です： -* 中小企業として1つまたは少数のアプリケーションを作成したく、データレジデンシーを重視している。 -* [Dify Cloud](https://cloud.dify.ai)に興味があるが、あなたのユースケースが[プラン](https://dify.ai/pricing)でサポートされているよりも多くのリソースを必要とする。 -* 組織内でDify Enterpriseを採用する前にPOCを実行したい。 +- 中小企業として1つまたは少数のアプリケーションを作成したく、データレジデンシーを重視している。 +- [Dify Cloud](https://cloud.dify.ai)に興味があるが、あなたのユースケースが[プラン](https://dify.ai/pricing)でサポートされているよりも多くのリソースを必要とする。 +- 組織内でDify Enterpriseを採用する前にPOCを実行したい。 -## セットアップ +## アクセス & セットアップ -初めてDifyにアクセスする場合は、Admin初期化パスワード（EC2のインスタンスIDに設定）を入力してセットアップ処理を開始します。 +AMIがデプロイされた後、EC2コンソールで確認できるインスタンスのパブリックIPを通じてDifyにアクセスします（デフォルトではHTTPポート80を使用）。 -AMIがデプロイされた後、EC2コンソールで見つけたインスタンスのパブリックIPを通じてDifyにアクセスします（デフォルトではHTTPポート80を使用）。 +初めてDifyにアクセスする場合は、Admin初期化パスワード（EC2のインスタンスID）を入力してセットアップ処理を開始します。 -## アップグレード - -EC2インスタンスで、以下のコマンドを実行します： - -``` -git clone https://github.com/langgenius/dify.git /tmp/dify -mv -f /tmp/dify/docker/* /dify/ -rm -rf /tmp/dify -docker-compose down -docker-compose pull -docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d -``` - - - -> このセクションでは、古いCommunity EditionをDify v1.0.0+に移行する方法を説明します。この特定の移行範囲*より後*のバージョンへのDify PremiumまたはCommunity Editionの一般的なアップグレードについては、それぞれのメインアップグレード手順を参照してください。 - -アップグレードプロセスには以下のステップが含まれます： - -1. データのバックアップ -2. プラグインの移行 -3. メインのdifyプロジェクトのアップグレード - -### 1. データのバックアップ - -1.1 `cd`コマンドを実行してDifyプロジェクトディレクトリに移動し、バックアップブランチを作成します。 - -1.2 以下のコマンドを実行してdocker-compose YAMLファイルをバックアップします（オプション）。 - -```bash -cd docker -cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak -``` - -1.3 コマンドを実行してdockerサービスを停止し、Dockerディレクトリでバックアップデータコマンドを実行します。 - -```bash -docker compose down -tar -cvf volumes-$(date +%s).tgz volumes -``` - -### 2. バージョンのアップグレcker Composeによるデプロイをサポートしています。Difyプロジェクトパスに移動し、以下のコマンドを実行してDifyバージョンにアップグレードします： - -```bash -git checkout 1.0.0 # 1.0.0ブランチに切り替え -cd docker -docker compose -f docker-compose.yaml up -d -``` - -### 3. ツールをプラグインに移行 - -> **コマンド実行とパッケージ管理に関する重要な注意（v1.0.0移行用）：** -> * **デフォルトコンテナ名：** `docker exec`コマンドの例では`docker-api-1`を使用しています。APIコンテナが異なる名前またはID（`docker ps`を使用して確認可能）を持つ場合は、それに応じてコマンドを調整してください。 -> * **Pythonパッケージマネージャー（`uv` vs. `poetry`）：** - * Difyは、パフォーマンス向上のためにバージョン[v1.3.0](https://github.com/langgenius/dify/releases/tag/1.3.0)からPythonパッケージ管理を`poetry`から`uv`に切り替えました。Dify v1.3.0以降の一般的な操作では、標準コマンドは`uv run flask ...`です。 - * **このセクションはDify v1.0.0へのアップグレードに焦点を当てています。** Dify v1.0.0からv1.3.0未満までの期間では、`poetry`がパッケージマネージャーでした。したがって、以下の例の`flask`コマンドは正しく`poetry run ...`を使用しています。コードの例では、コメントで現在の`uv`標準を最初に強調し、次にこの特定のv1.0.0移行範囲に関連する`poetry`コマンドを示します。 - -このステップの目的は、以前にCommunity Editionで使用されていたツールとモデルベンダーを自動的に移行し、新しいプラグイン環境にインストールすることです。 - -1. `docker ps`コマンドを実行してAPIコンテナ名またはIDを確認します。デフォルトは多くの場合`docker-api-1`です。 - -例： - -```bash -docker ps -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -417241cd**** nginx:latest "sh -c 'cp /docker-e…" 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp docker-nginx-1 -f84aa773**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-worker-1 -a3cb19c2**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-api-1 -``` - -コマンド`docker exec -it docker-api-1 bash`を実行してコンテナターミナルに入り（コンテナ名が異なる場合はそれを使用）、次に実行します： - -```bash -# Dify v1.3.0+環境では、標準コマンドは'uv run ...'です。 -uv run flask extract-plugins --workers=20 -# -# ゲット移行バージョンがDify v1.0.0からv1.3.0未満の場合は、'poetry'を使用してください： -# poetry run flask extract-plugins --workers=20 -``` - -> v1.0.0移行用のこのガイドに従ってコマンドを実行しようとする際にエラーが発生した場合（例：`uv`または`poetry`が見つからない）、そのバージョンの元の前提条件に従って`poetry`環境がサーバー上で正しく設定されていることを確認してください。`poetry`コマンドの実行後にターミナルで入力を求められた場合は、**「Enter」**を押してスキップしてください。 +## カスタマイズ -このコマンドは、現在環境で使用中のすべてのモデルとツールを抽出します。workersパラメータは抽出中に使用される並列プロセス数を制御し、必要に応じて調整できます。コマンド実行後、現在のDifyインスタンス内のすべてのワークスペース用のプラグイン情報を含む`plugins.jsonl`ファイルが生成されます。 +### 設定 -ネットワークがパブリックインターネットにアクセスでき、`https://marketplace.dify.ai`へのアクセスをサポートしていることを確認してください。`docker-api-1`コンテナ内で以下のコマンドを続けて実行します： +セルフホストデプロイと同様に、EC2インスタンス内の`.env`ファイルの環境変数を必要に応じて変更できます。その後、以下でDifyを再起動します： ```bash -# Dify v1.3.0+環境では、標準コマンドは'uv run ...'です。 -uv run flask install-plugins --workers=2 -# -# ここで説明するCommunity Edition部分のターゲット移行バージョンがDify v1.0.0からv1.3.0未満の場合は、'poetry'を使用してください： -# poetry run flask install-plugins --workers=2 +docker-compose down +docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d ``` -このコマンドは、必要なすべてのプラグインを最新のCommunity Editionにダウンロードしてインストールします。ターミナルに`Install plugins completed.`が表示されると、移行が完了します。 - - +### WebAppロゴ & ブランディング -## カスタマイズ +**設定** > **カスタマイズ**で、`Powered by Dify`ブランディングを削除するか、独自のロゴに置き換えることができます。 -セルフホストデプロイと同様に、EC2インスタンス内の`.env`の環境変数を必要に応じて変更できます。その後、以下でDifyを再起動します： +## アップグレード -```bash -docker-compose down -docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d -``` + + アップグレードする前に、GitHubの[リリースノート](https://github.com/langgenius/dify/releases)でバージョン固有のアップグレード手順を確認してください。一部のバージョンでは、データベースの移行や設定変更などの追加手順が必要な場合があります。 + -## WebAppロゴ & ブランディングのカスタマイズ +EC2インスタンスで、以下のコマンドを実行します： -設定の**カスタマイズ**でこの機能を有効にし、**Remove Powered by Dify**を有効にして独自のロゴをアップロードできます。 + + + ```bash + cd /dify + docker-compose down + ``` + + + `.env`ファイルと`volumes`ディレクトリをバックアップします。これにはデータベース、ストレージ、その他の永続データが含まれています： + + ```bash + cp /dify/.env /dify/.env.bak + tar -cvf volumes-$(date +%s).tgz volumes + ``` + + + + アップグレードプロセスは設定ファイルを上書きしますが、`.env`ファイルや`volumes/`ディレクトリ内のランタイムデータ（データベースやアップロードされたファイルなど）には影響しません。 + + `.env`以外の設定ファイルを手動で変更している場合は、アップグレード前にバックアップしてください。 + + + 最新のコードをプルし、設定ファイルを同期します： + + ```bash + git clone https://github.com/langgenius/dify.git /tmp/dify + rsync -av /tmp/dify/docker/ /dify/ + rm -rf /tmp/dify + ``` + + + 新しいバージョンでは`.env.example`に新しい環境変数が導入される場合があります。現在の`.env`と比較し、不足している変数を追加してください： + + ```bash + diff /dify/.env /dify/.env.example + ``` + + + ```bash + docker-compose pull + docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d + ``` + + diff --git a/zh/self-host/platform-guides/dify-premium.mdx b/zh/self-host/platform-guides/dify-premium.mdx index 2105dc5b1..4170264c9 100644 --- a/zh/self-host/platform-guides/dify-premium.mdx +++ b/zh/self-host/platform-guides/dify-premium.mdx @@ -6,126 +6,80 @@ title: AWS 上的 Dify Premium Dify Premium 是我们的 AWS AMI 产品，支持自定义品牌，可一键部署到你的 AWS VPC 作为 EC2 实例。前往 [AWS Marketplace](https://aws.amazon.com/marketplace/pp/prodview-t22mebxzwjhu6) 进行订阅。它在以下几种场景中很有用： -* 你是中小型企业，希望创建一个或几个应用程序，并且关心数据驻留问题。 -* 你对 [Dify Cloud](https://cloud.dify.ai) 感兴趣，但你的用例需要比 [定价计划](https://dify.ai/pricing) 支持的更多资源。 -* 你希望在组织内采用 Dify Enterprise 之前运行概念验证。 +- 你是中小型企业，希望创建一个或几个应用程序，并且关心数据驻留问题。 +- 你对 [Dify Cloud](https://cloud.dify.ai) 感兴趣，但你的用例需要比 [定价计划](https://dify.ai/pricing) 支持的更多资源。 +- 你希望在组织内采用 Dify Enterprise 之前运行概念验证。 -## 设置 - -如果这是你首次访问 Dify，请输入管理员初始化密码（设置为你的 EC2 实例 ID）来开始设置过程。 +## 访问与设置 AMI 部署后，通过 EC2 控制台中找到的实例公共 IP 访问 Dify（默认使用 HTTP 端口 80）。 -## 升级 - -在 EC2 实例中，运行以下命令： - -``` -git clone https://github.com/langgenius/dify.git /tmp/dify -mv -f /tmp/dify/docker/* /dify/ -rm -rf /tmp/dify -docker-compose down -docker-compose pull -docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d -``` - - - -> 本节描述将较旧的社区版迁移到 Dify v1.0.0+。对于 Dify Premium 或社区版到此特定迁移范围之后版本的一般升级，请参考各自的主要升级说明。 - -升级过程包括以下步骤： - -1. 备份你的数据 -2. 迁移插件 -3. 升级主要的 dify 项目 +如果这是你首次访问 Dify，请输入管理员初始化密码（你的 EC2 实例 ID）来开始设置过程。 -### 1. 备份数据 - -1.1 执行 `cd` 命令导航到你的 Dify 项目目录并创建备份分支。 - -1.2 运行以下命令备份你的 docker-compose YAML 文件（可选）。 - -```bash -cd docker -cp docker-compose.yaml docker-compose.yaml.$(date +%s).bak -``` - -1.3 运行命令停止 docker 服务，然后在 Docker 目录中执行备份数据命令。 - -```bash -docker compose down -tar -cvf volumes-$(date +%s).tgz volumes -``` - -### 2. 升级版本 - -`v1.0.0` 支持通过 Docker Compose 部署。导航到你的 Dify 项目路径并运行以下命令升级到 Dify 版本： - -```bash -git checkout 1.0.0 # 切换到 1.0.0 分支 -cd docker -docker compose -f docker-compose.yaml up -d -``` - -### 3. 将工具迁移到插件 - -> **关于命令执行和包管理的重要说明（针对 v1.0.0 迁移）：** -> * **默认容器名称：** `docker exec` 命令示例使用 `docker-api-1`。如果你的 API 容器有不同的名称或 ID（你可以使用 `docker ps` 找到），请相应调整命令。 -> * **Python 包管理器（`uv` vs. `poetry`）：** - * Dify 从版本 [v1.3.0](https://github.com/langgenius/dify/releases/tag/1.3.0) 开始将 Python 包管理器从 `poetry` 切换到 `uv` 以提高性能。对于 Dify v1.3.0 或更新版本的一般操作，标准命令是 `uv run flask ...`。 - * **本节专门针对升级到 Dify v1.0.0。** 在 Dify v1.0.0 到（但不包括）v1.3.0 期间，`poetry` 是包管理器。因此，下面示例中的 `flask` 命令正确地使用 `poetry run ...`。代码示例首先在注释中强调当前的 `uv迁移范围相关的 `poetry` 命令。 - -此步骤的目的是自动迁移之前在社区版中使用的工具和模型供应商，并将它们安装到新的插件环境中。 - -1. 运行 `docker ps` 命令检查 API 容器名称或 ID。默认通常是 `docker-api-1`。 - -示例： - -```bash -docker ps -CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES -417241cd**** nginx:latest "sh -c 'cp /docker-e…" 3 hours ago Up 3 hours 0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp docker-nginx-1 -f84aa773**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-worker-1 -a3cb19c2**** langgenius/dify-api:1.0.0 "/bin/bash /entrypoi…" 3 hours ago Up 3 hours 5001/tcp docker-api-1 -``` - -运行命令 `docker exec -it docker-api-1 bash` 进入容器终端（如果你的容器名称不同，请使用相应的名称），然后运行： - -```bash -# 对于 Dify v1.3.0+ 环境，标准命令是 'uv run ...'。 -uv run flask extract-plugins --workers=20 -# -# 如果此处描述的社区版部分的目标迁移版本是 Dify v1.0.0 到（但不包括）v1.3.0，请使用 'poetry'： -# poetry run flask extract-plugins --workers=20 -``` - -> 如果按照此 v1.0.0 迁移指南尝试执行命令时发生错误（例如，找不到 `uv` 或 `poetry`），请确保服务器上正确设置了该版本的原始先决条件的 `poetry` 环境。如果终端在运行 `poetry` 命令后要求输入，请按 **"Enter"** 键跳过。 +## 自定义 -此命令将提取环境中当前使用的所有模型和工具。workers 参数控制提取过程中使用的并行进程数，可根据需要调整。命令运行后，将生成一个 `plugins.jsonl` 文件，包含当前 Dify 实例中所有工作区的插件信息。 +### 配置 -确保你的网络可以访问公共互联网并支持访问：`https://marketplace.dify.ai`。在 `docker-api-1` 容器中继续运行以下命令： +就像自托管部署一样，你可以根据需要修改 EC2 实例中 `.env` 文件下的环境变量。然后，使用以下命令重启 Dify： ```bash -# 对于 Dify v1.3.0+ 环境，标准命令是 'uv run ...'。 -uv run flask install-plugins --workers=2 -# -# 如果此处描述的社区版部分的目标迁移版本是 Dify v1.0.0 到（但不包括）v1.3.0，请使用 'poetry'： -# poetry run flask install-plugins --workers=2 +docker-compose down +docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d ``` -此命令将下载并安装所有必要的插件到最新的社区版中。当终端显示 `Install plugins completed.` 时，迁移完成。 - - +### Web 应用标志和品牌 -## 自定义 +在**设置** > **自定义**中，你可以移除 `Powered by Dify` 品牌标识或替换为你自己的标志。 -就像自托管部署一样，你可以根据需要修改 EC2 实例中 `.env` 下的环境变量。然后，使用以下命令重启 Dify： +## 升级 -```bash -docker-compose down -docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d -``` + + 在升级之前，请查看 GitHub 上的 [Release Notes](https://github.com/langgenius/dify/releases) 了解特定版本的升级说明。某些版本可能需要额外的步骤，例如数据库迁移或配置更改。 + -## WebApp 标志和品牌自定义 +在 EC2 实例中，运行以下命令： -你可以在设置下的**自定义**中启用此功能，启用**移除 Powered by Dify**并上传你自己的标志。 + + + ```bash + cd /dify + docker-compose down + ``` + + + 备份你的 `.env` 文件和 `volumes` 目录，其中包含你的数据库、存储和其他持久化数据： + + ```bash + cp /dify/.env /dify/.env.bak + tar -cvf volumes-$(date +%s).tgz volumes + ``` + + + + 升级过程会覆盖配置文件，但不会影响你的 `.env` 文件或 `volumes/` 目录中的运行时数据（如数据库和上传的文件）。 + + 如果你手动修改过 `.env` 以外的任何配置文件，请在升级前备份它们。 + + + 拉取最新代码并同步配置文件： + + ```bash + git clone https://github.com/langgenius/dify.git /tmp/dify + rsync -av /tmp/dify/docker/ /dify/ + rm -rf /tmp/dify + ``` + + + 新版本可能会在 `.env.example` 中引入新的环境变量。将其与你当前的 `.env` 进行比较，并添加任何缺失的变量： + + ```bash + diff /dify/.env /dify/.env.example + ``` + + + ```bash + docker-compose pull + docker-compose -f docker-compose.yaml -f docker-compose.override.yaml up -d + ``` + +