ダウンタイムなしで AWS で Confluence クラスタをアップグレード

このドキュメントでは、CloudFormation によってオーケストレーションされた AWS デプロイでのローリング アップグレードの実行のステップバイステップの手順について説明します。特に、これらの手順は、AWS クイック スタートに基づく Confluence Data Center デプロイに適しています。

ステップ 1 - アップグレード モードの有効化

ステップ 2: スタック内の現在のすべてのアプリケーション ノードを見つける

AWS で、スタック内で実行中のすべてのアプリケーション ノードの Instance ID を記録します。これらはすべて、現在のバージョンを実行しているアプリケーション ノードです。後の手順でこれらの ID が必要となります。

1. AWS コンソールで、[Services] > [CloudFormation] に移動します。デプロイメントのスタックを選択してスタックの詳細を表示します。

2. [Resources] ドロップダウンを展開します。[ClusterNodeGroup] を探し、その Physical ID をクリックします。Jira アプリケーション ノードの Auto Scaling Group の詳細を示すページが開きます。
3. Auto Scaling Group の詳細で、[Instances] タブをクリックします。ここに表示されているすべての Instance ID を記録します。これらを以降のステップで終了します。

ステップ 3: CloudFormation テンプレートの更新

デプロイでは、環境の各コンポーネントを定義する CloudFormation テンプレートを使用します。この場合、Confluence をアップグレードすることは、テンプレートで使用されている Confluence のバージョンを更新することを意味します。アップグレード時には、クラスタにノードを一時的に追加することを強くお勧めします。

1. AWS コンソールで、[Services] > [CloudFormation] に移動します。デプロイメントのスタックを選択してスタックの詳細を表示します。
2. スタックの詳細画面で、[Update Stack] をクリックします。
3. [Select Template] 画面で、[Use current template] を選択してから、[Next] をクリックします。
4. Version パラメーターを、更新先のバージョンに設定します。これはローリング アップグレードなので、これより後のバグ修正バージョンにしか設定できません。 
5. 新しい Jira ノードをクラスタに追加します。これによって、クラスタでユーザー トラフィックに対するノードの不足が発生しにくくなります。これを行うには、次のパラメーターの値を 1 増やします。
   • Maximum number of cluster nodes
   • Minimum number of cluster nodes
     
6. 次へ をクリックします。 以降のページをクリックして進み、[Update] ボタンを使用して変更を適用します。

スタックを更新すると、新しい Confluence バージョンを実行している追加ノードが 1 つ作成されます。アップグレード モードを有効にすると、そのノードはクラスタに参加して作業を開始できます。他のノードはまだアップグレードされません。

アップグレードした新しいノードをアクティブ状態で実行すると、そのノードのアプリ ログをチェックしてノードの Confluence にログインし、すべてが機能していることを確認する必要があります。この時点ではアップグレードをまだロール バックできるので、念のためにテストを行うことをお勧めします。 

最初のノードをテストすると、別のノードのアップグレードを開始できます。これを実行するには、ノードをシャットダウンして終了します。AWS は、このノードをアップデート済みの Confluence バージョンを実行している新しいノードに置き換えます。

ステップ 4: 他のノードをアップグレードする

ステップ 2 では、クラスタ内の各ノードのインスタンス ID を記録しました。Confluence を正常にシャットダウンしたノードを終了します。この操作を行うには、次の手順を実行します。

1. AWS コンソールで、[Services] > [EC2] に進みます。[Running Instances] をクリックします。
2. Confluence を正常にシャットダウンしたノードと一致するインスタンスを確認します。 
3. [Actions] ドロップダウンから、[Instance State] > [Terminate] を選択します。 
4. クリック スルーして、インスタンスを終了します。 

ノードを終了するたびに、AWS は自動的にそれを交換します。置換では、新しいバージョンの Confluence が実行されます。新しいノードのステータスが [Active] になったら、別のノードのアップグレードに進むことができます。

ステップ 5: 残りのノードを個別にアップグレードする

この時点で、クラスタには新しいバージョンの Confluence を実行する 2 つのノードが必要です。これで、他のノードをアップグレードできます。これを行うには、別のノードで前の手順を繰り返します。通常通り、毎回、実行するタスクの数が最も少ないノードをアップグレードすることをお勧めします。

ステップ 6. アップグレードを完了する

ステップ 7: クラスタをスケール ダウンする

ステップ 3 では、終了した各ノードの置き換えとして、ノードをクラスタに一時的に追加しました。これは、通常のユーザー トラフィックを処理するのに十分なノードがあることを確認するためでした。アップグレードを完了したら、そのノードを削除できます。

1. AWS コンソールで、[Services] > [CloudFormation] に移動します。デプロイメントのスタックを選択してスタックの詳細を表示します。
2. スタックの詳細画面で、[Update Stack] をクリックします。
3. [Select Template] 画面で、[Use current template] を選択してから、[Next] を選択します。
4. 次のパラメーターの値を 1 減らします。
   • Maximum number of cluster nodes
   • Minimum number of cluster nodes
5. 次へ をクリックします。 以降のページをクリックして進み、[Update] ボタンを使用して変更を適用します。

AWS を置き換えることなく、クラスタから 1 つのノードを削除できるようになりました。この操作を行うには、次の手順を実行します。

• 実行中のタスクの数が最も少ないノードを選択します。 
• ノードで Confluence をグレースフル シャットダウンします。  
• ノードを終了します。 

詳細な手順については、ステップ 4 を参照してください。

トラブルシューティング

ロード バランサーを使用してクラスタからノードを切断する

エラーによってノードを終了できない場合は、ロード バランサーを使用してクラスタからノードを切断してみてください。AWS Application Load Balancer では、各ノードがターゲットとして登録されているため、ノードを切断するには、登録を解除する必要があります。これを行う方法の詳細については、Application Load Balancers のターゲット グループと登録済みターゲットを参照してください。

アップグレード中またはアップグレード後にトラフィックが不均一に分散しています

ローリング アップグレード中のノード エラー

元のバージョンにロール バックする

ノードが起動しません