ダウンタイムなしで API によって Confluence クラスタをアップグレード
このドキュメントでは、API 呼び出しを使用してローリング アップグレードを開始および確定する方法について説明します。このアップグレード方法は、メンテナンス タスク (アップグレードなど) を調整するためのスキルと自動化ツールを持つ管理者に適しています。
API のリファレンス
ローリング アップグレード プロセス全体は、次の API によって管理されます。
http://<host>:<port>/rest/zdu/cluster/zdu/
この API では、次の呼び出しを使用します。
| クラスタのステータスの概要を確認します。 | |
| アップグレード モードを有効化します。 | |
| クラスタのステータスを取得します。 | |
| 実行中のタスクの数を含む、ノードのステータスの概要を取得します。 | |
| アップグレード モードを無効化します。このコールは、アップグレードの進捗が MIXED でない場合にのみ使用できます。 | |
| すべてのノードがアップグレードされたら、ローリング アップグレードを終了します。これにより、アップグレード モードが無効化されます。 |
各 API 呼び出しの詳細については、Confluence REST API ドキュメントを参照してください。
ローリング アップグレードの開始
ローリング アップグレードを開始するには、最初にローリングアップ グレードを有効にします。これを行うには、次のものを使用します。
http://<host>:<port>/rest/zdu/cluster/zdu/start
各ノード個別アップグレード
ノードをアップグレードする前に、そのノードの Confluence をグレースフル シャットダウンする必要があります。これを行うには、オペレーティング システムと設定に対応する停止スクリプトを実行します。グレースフル Confluence シャットダウンの詳細については、こちらをご覧ください。
たとえば、Linux に Confluence をサービスとしてインストールしている場合は、次のコマンドを実行します。
$ sudo /etc/init.d/confluence stop
ノードで Confluence をアップグレードした後、ノードが Active ステータスに移行するまで待ってから、別のノードをアップグレードします。
ノード ステータス
ノードのステータスを取得するには、次のものを使用します。
http://<host>:<port>/rest/zdu/cluster/zdu/nodes/<nodeID>
| ACTIVE | Confluence はクラスタに接続され、エラーなしで実行されます。 |
|---|---|
| STARTING | Confluence はまだロード中であり、完了したら Active に移行する必要があります。 |
| TERMINATING | Confluence がグレースフル シャットダウンされ、完了したら Offline に移行する必要があります。 |
| OFFLINE | Confluence がどのノードでも応答していません。アップグレード モードが無効になった後もオフラインのままであれば、このノードはクラスタから完全に削除されます。 |
| エラー | ノード上の Confluence で何か問題ありました。 |
クラスタ ステータス
クラスタのステータスを取得するには、次のものを使用します。
http://<host>:<port>/rest/zdu/cluster/zdu/state
| STABLE | アップグレード モードをオンにできます。 |
|---|---|
| READY_TO_UPGRADE | アップグレード モードは有効ですが、まだアップグレードされたノードはありません。最初のノードのアップグレードを開始できます。 |
| mixed | 少なくとも 1 つのノードがアップグレードされていますが、アップグレードが完了していないノードがあります。クラスタに、異なる Confluence バージョンを実行しているノードがあります。次のステータス (READY_TO_RUN_UPGRADE_TASKS) に移行するには、すべてのノードを同じバグ修正バージョンにアップグレードする必要があります。 |
| READY_TO_RUN_UPGRADE_TASKS | すべてのノードがアップグレード済みです。ローリング アップグレードを完了できます。
|
アップグレード モードを有効化または無効化する