1. 概要

AWS EC2 上で Docker Compose を用いて稼働している Dify アプリケーションを、安全にアップデート・運用するための手順をまとめている。

2. 構成前提

EC2 に SSH 接続

ssh -i ~/.ssh/your-key.pem ec2-user@<EC2_PUBLIC_IP>

リポジトリへ移動 & ソース取得

cd dify/docker
git pull origin <main | tag>

コンテナ停止（Volume は温存）

docker compose down       # --volumes は付けない！

イメージ更新

docker compose pull       # 最新イメージ取得

動作確認

docker compose ps         # ステータス確認
docker compose logs -f <service>  # 必要に応じてログ監視

docker compose down
sudo tar -cvf dify-volumes-$(date +%Y%m%d).tar \
  /var/lib/docker/volumes/dify_*

または EC2 停止前に EBS スナップショット / AMI を取得。

アップデート後は .env.example と既存 .env を比較し、新規変数を追記する。

diff -u .env.example .env

git checkout <previous-tag>   # 直前の安定版へ戻す
docker compose pull
docker compose up -d

なお、それでも復旧しない場合は Volume バックアップまたは AMI を戻す。

EC2 インスタンスから抜けたい場合は次のいずれかで OK。

exit      # 一般的
logout    # シェル依存
Ctrl + D  # EOF 送信