アップグレード

このページでは、本番サーバーのアップグレード手順を説明します。dagu upgrade コマンド自体については、セルフアップグレードを参照してください。

修正が提供されるのは、最新の安定版リリース系列のみです。サポートポリシーを参照してください。

アップグレードの前に

現在のバージョンから目的のバージョンまでの間にある、すべてのバージョンのリリースノートを確認します。https://github.com/dagucloud/dagu/releases
設定、DAG、データディレクトリをバックアップします。
ワークフローが重要な場合は、先にステージングサーバーへ目的のバージョンをインストールします。マルチ環境へのデプロイを参照してください。

単一サーバー

bash

dagu upgrade --version v2.26.0
sudo systemctl restart dagu
dagu version

インターネットに接続できない場合は、閉域網の説明に従って、バイナリを手動で置き換えてください。

進行中の実行は、プロセスマネージャーが実行を残す設定になっている場合を除き、サービスの再起動時に終了します。重要な実行が進行していないときに再起動するか、高可用性の説明のとおり KillMode=process を設定してください。

アクティブ/スタンバイのペア

スタンバイを先にアップグレードします。こうすると、アップグレード済みのインスタンスが 1 回だけ引き継ぎを行い、古いバージョンが新しいバージョンから引き継ぐことはありません。

スタンバイを特定します。

bash

curl -s http://host-a:8090/health
curl -s http://host-b:8090/health

スタンバイのホストで Dagu を停止し、バイナリを置き換えて、起動します。スタンバイとして復帰します。

bash

sudo systemctl stop dagu-scheduler dagu-server
# install the new binary at /usr/local/bin/dagu
sudo systemctl start dagu-scheduler dagu-server

アクティブなホストでも同じ手順を実行します。スケジューラは停止時にロックを解放するため、アップグレード済みのスタンバイは、scheduler.lock_retry_interval に起動処理の時間を加えた時間以内にアクティブになります。

すべてのホストが新しいバージョンを報告し、アクティブなホストがちょうど 1 台であることを確認します。

bash

dagu version
curl -s -o /dev/null -w '%{http_code}\n' 'http://host-a:8090/health?role=active'
curl -s -o /dev/null -w '%{http_code}\n' 'http://host-b:8090/health?role=active'

2.26.0 以前からのアップグレード

それより後のリリースでは、スケジューラの動作が 4 点変更されています。

cron スロットの実行 ID の形式が変更されました。 新しいバージョンは、古いバージョンが開始した実行を認識できません。そのため、引き継ぎと同じ分に実行されたスロットが、再度実行される場合があります。スケジュールの実行予定がない分を選んで引き継いでください。
データディレクトリは、すべてのホストで同じパスでなければなりません。 データディレクトリが各スロットの実行 ID の一部になったためです。
ロックを失ったスケジューラは、0 ではなくステータス 1 で終了します。 再起動の仕組みが必要です。
スケジューラを停止しても、そのスケジューラがキューから開始した実行は停止しなくなりました。 scheduler.failover_recovery_window が新たに追加され、デフォルトで有効(2 分)です。

Kubernetes

Kubernetes を参照してください。新しいチャートのバージョンではデフォルトのイメージが変わることがあるため、先に appVersion を確認してください。

bash

helm repo update
helm show chart dagu/dagu | grep -E '^(version|appVersion):'

ロールバック

Dagu は、新しいバージョンが書き込んだ状態を古いバージョンが読み取れることを保証しません。また、ダウングレードはテストされていません。ロールバックするには、次の手順を実行します。

すべてのホストで Dagu を停止します。
アップグレード前に取得したバックアップをリストアします。
以前のバイナリをインストールし、Dagu を起動します。

バックアップ以降の実行は、履歴から失われます。

アップグレード ​