はじめに

こんにちは！Dify便利ですねー。今回は、Windows環境でDifyをアップグレードする方法をご紹介します。Linux版の手順は以下に執筆したのですが、Windows版もほしいよね！ということで書いてみました。

この記事の対象者

Windows上でDocker Desktopを使ってDifyを動かしている方
Difyをアップグレードしたいけど、ちょっと不安な方
コマンドラインは使えるけど、そんなに詳しくない方

アップグレード手順

1. PowerShellを管理者として起動

スタートメニューでPowerShellを右クリック→「管理者として実行」を選択します。

2. 現在の変更状態を確認

# Difyのディレクトリに移動（インストール場所に応じて変更してください）
> cd C:\path\to\dify

# 変更状態の確認
> git status

3. バックアップを取る（大事！）

> cd docker

# 設定ファイルのバックアップ
# 単純に.oldという拡張子をつけてバックアップします
> copy docker-compose.yaml docker-compose.yaml.old
> copy .env .env.old

Point：Docker Volumeのバックアップ

Docker Desktopならボリュームのバックアップも簡単です！

Docker Desktopを開く
左メニューの「Volumes」をクリック
必要なボリュームを右クリック→「Export」でバックアップ完了！

こんなかんじです。便利な機能ですね。。

4. 変更を一時退避

> cd C:\path\to\dify
> git stash

5. 最新版を取得

# mainブランチに切り替え
> git checkout main

# 最新のコードを取得
> git pull origin main
（ガッツリ結果が並びます、略します）

6. サービスを停止

コマンドラインで停止する場合：

> cd docker
> docker-compose down
[+] Running 11/11
 ✔ Container docker-sandbox-1         Removed                                                                                  1.2s
 ✔ Container docker-weaviate-1        Removed                                                                                  0.7s
 ✔ Container docker-nginx-1           Removed                                                                                 11.1s
 ✔ Container docker-ssrf_proxy-1      Removed                                                                                 11.4s
 ✔ Container docker-worker-1          Removed                                                                                 12.6s
 ✔ Container docker-web-1             Removed                                                                                 10.6s
 ✔ Container docker-api-1             Removed                                                                                 13.0s
 ✔ Container docker-db-1              Removed                                                                                  0.7s
 ✔ Container docker-redis-1           Removed                                                                                  0.7s
 ✔ Network docker_ssrf_proxy_network  Removed                                                                                  0.3s
 ✔ Network docker_default             Removed

これが終わると、Docker Desktop上のContainersもスッキリと、何もなくなります。

Docker Desktop GUIで停止する場合：

Docker Desktopを開く
「Containers」をクリック
Dify関連のコンテナを選択
「Stop」ボタンをクリック

どっちが簡単かは、判断わかれるでしょうね。お好きな方で。

7. 設定ファイルを更新

# バックアップと新しい設定を比較（fcはWindows版のdiff）
> Compare-Object (Get-Content docker-compose.yaml.old) (Get-Content docker-compose.yaml)
> Compare-Object (Get-Content .env.old) (Get-Content .env)

必要な変更を反映します。VSCodeなどのエディタで編集すると楽ですよ！

8. サービスを再起動

> docker-compose up -d
[+] Running 28/28
 ✔ api Pulled                                                                                                                101.7s
   ✔ a480a496ba95 Already exists                                                                                               0.0s
   ✔ 9555349e8380 Already exists                                                                                               0.0s
   ✔ 1c161e44b06b Already exists                                                                                               0.0s
   ✔ 417516d8bb61 Already exists                                                                                               0.0s
   ✔ d197aa066fee Pull complete                                                                                                4.1s
   ✔ 2e3a189d6ded Pull complete                                                                                                8.5s
   ✔ 4f4fb700ef54 Pull complete                                                                                                8.5s
   ✔ a85ccdde7f53 Pull complete                                                                                               46.6s
   ✔ 33fbb0aac3f9 Pull complete                                                                                               95.3s
   ✔ 16a8041c47d4 Pull complete                                                                                               96.3s
   ✔ fd8313391acd Pull complete                                                                                               97.3s
   ✔ 94bc503e60f9 Pull complete                                                                                               97.4s
 ✔ worker Pulled                                                                                                             101.7s
 ✔ web Pulled                                                                                                                 26.3s
   ✔ 4abcf2066143 Already exists                                                                                               0.0s
   ✔ 9f16480e2ff5 Already exists                                                                                               0.0s
   ✔ 092226d52cac Already exists                                                                                               0.0s
   ✔ 0493dfb2ff9c Already exists                                                                                               0.0s
   ✔ 32cdc670699a Pull complete                                                                                                1.0s
   ✔ 8b3c0aa85eca Pull complete                                                                                                1.0s
   ✔ af3000ec4d41 Pull complete                                                                                                1.1s
   ✔ 5d6f0ea61668 Pull complete                                                                                                2.0s
   ✔ b169f7bdc92a Pull complete                                                                                                5.5s
   ✔ 035dcc618757 Pull complete                                                                                                5.7s
   ✔ 0b201a402996 Pull complete                                                                                                5.8s
   ✔ 1ab40d49a6cb Pull complete                                                                                                5.8s
   ✔ b8b6ee54ae2c Pull complete                                                                                               22.0s
[+] Running 11/11
 ✔ Network docker_default             Created                                                                                  0.1s
 ✔ Network docker_ssrf_proxy_network  Created                                                                                  0.0s
 ✔ Container docker-weaviate-1        Started                                                                                  3.2s
 ✔ Container docker-redis-1           Started                                                                                  3.1s
 ✔ Container docker-sandbox-1         Started                                                                                  3.2s
 ✔ Container docker-db-1              Started                                                                                  3.2s
 ✔ Container docker-web-1             Started                                                                                  3.3s
 ✔ Container docker-ssrf_proxy-1      Started                                                                                  3.3s
 ✔ Container docker-api-1             Started                                                                                  3.6s
 ✔ Container docker-worker-1          Started                                                                                  3.6s
 ✔ Container docker-nginx-1           Started

Docker Desktopの画面でもいい感じに立ち上がっていることが確認できますよ！

9. 動作確認

ブラウザで http://localhost （または設定したポート）にアクセスして、ちゃんと動いているか確認しましょう！

トラブルシューティング

未検証ですが、参考のために以下の方法を書いておきます。

ログを確認したい場合

> docker-compose logs -f

バックアップから戻したい場合

サービスを停止

> docker-compose down

バックアップを復元

> copy "docker-compose.yaml.*.bak" docker-compose.yaml
> copy ".env.*.bak" .env

Docker Desktopから以前エクスポートしたボリュームをインポート
サービスを再起動

> docker-compose up -d

まとめ

Windows環境でもDifyのアップグレードは怖くありません！ポイントは、

必ずバックアップを取る
Docker Desktopの便利な機能を活用する
問題があったらすぐに戻せるように手順を理解しておく

これで皆さんも安全にDifyをアップグレードできますね！新機能を楽しみましょう！最後まで読んでいただき、ありがとうございました！この記事が皆さんのお役に立てば幸いです。