Confluence Data Center クラスタのセットアップ
AWS および Azure でのクラスタリング
AWS (Amazon Web Services) および Azure などのパブリック クラウド プロバイダーで Data Center クラスタをデプロイすることもできます。AWS または Azure でクラスタを簡単に構成できるよう、具体的なガイドとデプロイ テンプレートをご用意しています。それぞれで必要な要件をご確認ください。
はじめる前に
クラスタリングの要件
Confluence Data Center を使用するには、次の条件を満たしている必要があります。
- Data Center ライセンスを所有している (Data Center ライセンスを購入するか、my.atlassian.com で評価ライセンスを作成することが可能)。
- サポート対象となっているバージョンの外部データベース、OS、Javaを使用する。
- 他のアトラシアン製品 (Jira など) へのアプリケーション リンクがある場合は、認証方法として OAuth または OAuth (偽装) を使用していること
Confluence をクラスタで実行するには、次の条件も満たす必要があります。
Confluence クラスタの前にセッション アフィニティを使用したロード バランサを使用します。共同編集では WebSockets サポートも推奨されます。
- 同じパスですべてのクラスタ ノードにアクセス可能な共有ディレクトリ (共有ホーム ディレクトリになります) が存在する。ローカル ホームまたはインストール ディレクトリ内ではない、別のディレクトリである必要があります。
ハードウェアおよびインフラストラクチャの完全な概要については、「Confluence Data Center のクラスタ化」を参照してください。
セキュリティ
ファイアウォールやネットワーク分離の使用により、許可されたクラスタ ノードのみが次のポートに接続できるようにします。
クラスタ検出にマルチキャストを使用する場合、次の設定も確認します。
- 54327- Synchrony 用のマルチキャスト ポート (Synchrony スタンドアロン クラスタを実行している場合にのみ必要)
用語
このガイドでは以下の用語について説明します：
- インストール ディレクトリ - Confluence をインストールしたディレクトリ。
- ローカルのホーム ディレクトリ - 各クラスタ ノードにローカルで保存されているホームまたはデータ ディレクトリ (Confluence がクラスタで実行されていない場合は単に "ホーム ディレクトリ")。
- 共有ホームディレクトリ - 作成したディレクトリで、クラスタの同一パスを経由してすべてのノードにアクセス可能なディレクトリ。
クラスタのセットアップと構成
このプロセスをステージング環境で完了し、クラスタ化されたインストールをテストしてから、本番環境に移行することをおすすめします。
1. バックアップ
先に進む前に、既存の Confluence のローカルのホームおよびインストール ディレクトリとデータベースのバックアップを作成しておくことを強く推奨します。
2. クラスタ モードを有効化する
次のステップに進む前に、UI でクラスタリングを有効にします。
- Confluence を起動します。
- [管理]
> [一般設定] の順に移動します。 - サイドバーで [クラスタリング] を選択します。
- [クラスタ モードを有効にする] を選択します。
- [有効化] を選択し、続行する準備が整ったことを確認します。
3. Confluence を停止します
ホーム ディレクトリがそれ以上変更されないように Confluence を停止します。
4. 共有ホームディレクトリの作成
同一パスを経由してすべてのクラスター ノードにアクセス可能なディレクトリを作成します。これが、共有ホーム ディレクトリになります。
5. <confluence-home>/shared-home ディレクトリを新しい共有ホームにコピーする
既存の Confluence ホーム ディレクトリで、<confluence-home>/shared-home/ のコンテンツを作成した新しい共有ホーム ディレクトリにコピーします。
クラスターが完全に構成されるまで、構成のコピーを元の <confluence-home>/shared-home/ ディレクトリに残してください。
6. 添付ファイルをコピーする
<confluence-home>/attachments/ ディレクトリを新しい <shared-home>/attachments/ ディレクトリに移動します。
7. Confluence を再起動します。
Confluence を再起動してクラスタを構成します。再起動したら、セットアップ プロセスが完了するまで Confluence を利用することはできません。
8. クラスタの構成
セットアップ ウィザードから、次の情報を入力してクラスタをセットアップするように促されます。
- クラスタ名
- 作成済みの共有ホームディレクトリへのパス
- 他のノードとの通信用に Confluence が使用するネットワーク インターフェイス
Confluence によるクラスター ノードの検出方法:
- マルチキャスト - マルチキャスト アドレスを入力または自動生成します。
- TCP/IP - 各クラスタ ノードの IP アドレスを入力します。
AWS - 自分の IAM ロールまたは秘密キーと領域を入力します。
Synchrony が Confluence で管理されている場合、同じネットワーク設定が Synchrony に適用されます。
プロンプトに従ってクラスタを作成します。
再起動すると、Confluence はクラスタのセットアップを開始します。この処理には数分かかることがあります。Confluence の一部のコンポーネントも、クラスタ互換に変わります。例えば、Confluence は Hazelcast によって管理される分散キャッシュ レイヤーに切り替わります。
クラスタのセットアップが完了し、Confluence が実行されるまでは、Confluence を再起動しないでください。
9. ローカル ホームをクリーンアップする
混乱を防ぐため、クラスターを設定したら、元の <confluence-home>/shared-home ディレクトリを削除することをお勧めします。
Confluence ノードを追加する
Data Center ライセンスでは、クラスタのノード数は制限されません。高可用性などのクラスタ化のメリットを実現するには、1 つ以上のクラスタ ノードを追加する必要があります。
ほとんどの組織では一般に、2 ~ 4 ノードで十分です。小さく開始し、必要に応じて拡張することをおすすめします。
10. Confluence を 2 つめのノードにコピー
2 つ目のノードに Confluence をコピーするには：
- ノード 1 で Confluence をシャットダウンする。
- ノード 1 からノード 2 へインストール ディレクトリをコピーする。
- ノード 1 からノード 2 にローカルのホーム ディレクトリをコピーします。
ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。
ローカルのホームディレクトリをコピーすることで、確実に Confluence 検索インデックス、データベース、クラスタ設定、その他の設定をノード 2 にコピーします。
対象のノード数をサポートするために十分なコネクションがデータベースにあることを確認してください。
11. ロード バランサの構成
Confluence 用にロードバランサを設定します。ロードバランサはお好みで選択できますが、セッションアフィニティと WebSocketsのサポートが必要となります。
ご利用のロードバランサを以下の点で検証します：リクエストを送信する際、Confluence にアクセスしてロードバランサを通過し、既存の Confluence サーバーに正しく送信してページを作成し、このページがロードバランサを使用した他のマシンから閲覧・編集が可能である。
ロード バランサの詳細なガイダンスについては、「Confluence Data Center のクラスタ化」を参照してください。
12.一度に Confluence の 1 つのノードを起動する
一度に１つの Confluence ノードのみ起動する必要があります。最初のノードを立ち上げ、利用可能になってから、次のノードを起動してください。
- ノード 1 で Confluence を開始する。
- Confluence がノード 1 で使用可能になるまで待つ。
- ノード 2 で Confluence を開始する。
- Confluence がノード 2 で使用可能になるまで待つ。
クラスター監視コンソール ([管理] メニュー 
> [一般設定] > [クラスタリング]) には、アクティブなクラスターに関する情報が表示されます。
クラスタが適切に実行されていると、このページにシステムの使用状況やアップタイムなどを含む各ノードの詳細情報が表示されます。クラスタの各ノードの詳細情報については、
メニューから参照してください。
13. Confluence クラスタのテスト
コンテンツの作成をテストするには、ロード バランサの URL 経由で Confluence にアクセスする必要があります。ノードに直接アクセスする場合、ページを作成または編集することはできません。
クラスタが正しく作動しているか確認する簡単な方法は：
- ロード バランサの URL 経由でノードにアクセスし、このノードで新しいドキュメントを作成します。
- 異なるノードに直接アクセスしたときに新しいドキュメントが表示されていることを確認します。
- 元のノードで新しいドキュメントを検索し、表示されることを確認します。
- 別のノードで新しいドキュメントを検索し、表示されることを確認します。
作動していないクラスタの 2 つ以上のインスタンスがデータベースにアクセスしていることを Confluence が 検知すると、クラスタ パニックを起こし、Confluence はシャットダウンします。クラスタネットワーク接続性のトラブルシューティングから解決してください。
14. Synchrony クラスタのセットアップ (オプション)
Synchrony 1は共同編集に必要です。Data Center ライセンスでは 2 つの方法で Synchrony を実行できます。
- Confluence で管理 (推奨)
既定のセットアップです。Confluence は同じノードで Synchrony プロセスを自動的に起動して管理します。手動による操作は不要です。 - スタンドアロンの Synchrony クラスタ (ユーザーによる管理)
ユーザーはスタンドアロンな Synchrony を必要なノード数で、独自のクラスタでデプロイおよび管理します。大規模なセットアップが必要です。手順については、「Confluence Data Center 用に Synchrony クラスタをセットアップする」を参照してください。
共同編集の詳細については、「共同編集の管理」を参照してください。
トラブルシューティング
上記の手順で問題が発生した場合は、クラスタのトラブルシューティング ガイドを参照してください。
アトラシアンによる支援
クラスタのセットアップでサポートが必要な場合、クラスタ化された Data Center インストールの計画や実装に役立つ幅広いサポート サービスをご利用いただけます。
- アトラシアンのアドバイザリー サービスでは戦略的ガイダンスをご利用いただけます。クラスターで Confluence を構成、デプロイ、管理するためのベスト プラクティスの開発においてアドバイザリー サービスはお客様をサポートします。
- アトラシアンのプレミア サポートは、技術的なサポートを提供できます。また、プレミア サポートでは、お客様の環境の準備レベルを評価するヘルス チェック分析も提供しています。
- アトラシアンのエンタープライズ パートナー は、お客様がアトラシアン ツールを最大限に活用できるよう、幅広いサービスを提供します。
- また、アトラシアン コミュニティで質問することもできます。