Confluence アップグレード用にステージング環境を作成する

Confluence をアップグレードする際は、本番サイトをアップグレードする前に、テスト環境でアップグレードを実施することを強くお勧めします。このガイドでは、テスト環境をステージングと読んでいます。 

ほとんどの Confluence ライセンスには、ステージング環境用に無料の開発ライセンスが含まれています。ライセンスにアクセスする方法については、「ステージング環境用ライセンスの取得方法」を参照してください。 

このページの内容:

ステージング環境の作成

1 環境の複製

ステージング環境は、リバース プロキシ、SSL 設定、またはロードバランサ(データセンターの場合)を含めて、実環境(本番)環境を厳密に複製する必要があります。異なる物理サーバーまたは仮想ソリューションを使用することもできます。重要なことは、本番環境の適切なレプリカとすることです。 

以下の説明では、ステージング環境が物理的に本番環境と分離されており、同じオペレーティングシステム を備えていることを前提としています (Confluence を手動でインストールした場合には、同一の Java バージョンであることも前提となります)。 

2 データベースの複製

データベースを複製する手順

  1. 本番環境データベースをバックアップします。バックアップの最良の方法の詳細については、データベースのドキュメントを参照してください。 
  2. ステージング サーバーにデータベースをインストールし、バックアップをリストアします。 

データベース バックアップのリストア手順は、選択したデータベースとバックアップ ツールによって異なります。以下を確認してください。

  • 新しいステージング データベースが本番環境データベースと異なる名前であること。
  • ステージング データベースのユーザーアカウントは、本番データベースのユーザーアカウントと同じユーザー名およびパスワードです。
  • 文字エンコードおよびその他の設定は本番データベースと同じです (たとえば、Oracle データベースの場合、文字エンコードは Unicode UTF-8 (または AL32UTF8 のはずです)。 

3 Confluence の複製

Confluence を複製するには、ご使用の Confluence インストールのコピーを作成し、ステージング データベースをポイントするようにします。以下の説明は、Confluence Server 向けです (Data Center の場合、Confluence を起動する前にいくつか追加手順があります)。 

  1. 本番環境のインストール ディレクトリ全体をステージング サーバーにコピーします。 
  2. 本番環境のホームディレクトリ全体をステージングサーバーにコピーします。 
  3. <installation-directory>/confluence/WEB-INF/classes/confluence-init.properties を編集し、ステージング ホーム ディレクトリを指定します。 
  4. <home-directory>/confluence.cfg.xmlまたは  <installation-directory>/server.xml を編集し、ステージング データベースを指すようにします。

    JDBC 直接接続を使用している場合、confluence.cfg.xml で更新する必要がある行は、次のようになります。
    <property name="hibernate.connection.url">jdbc:postgresql://localhost:5432/confluencestaging</property>
    データソース接続を使用している場合、server.xml で更新する必要がある行は、次のようになります。
    <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource"
         username="postgres"
         password="postgres"
         driverClassName="org.postgresql.Driver"
         url="jdbc:postgresql://localhost:5432/confluencestaging"
         maxTotal="60"
         maxIdle="20"
         validationQuery="select 1" />
  5. 以下のシステムプロパティで Confluence を起動し、ステージングサイトが実際のユーザーに通知を送信しないことを確認します。   

    -Datlassian.notifications.disabled=true
    -Datlassian.mail.senddisabled=true
  6. http://localhost:<port>  に進み、ステージング サーバーの Confluence にログインします。 
  7. 移動

     > General Configuration

     and change the base URL of your staging site (for example mysite.staging.com)
  8. 移動 

     > General Configuration

     > ライセンス詳細に移動し、開発ライセンスキーを入力します。
  9. 移動 

     > General Configuration

     > システム情報 に進み、Confluence がステージング データベース、およびステージング ホームディレクトリを正しくポイントしていることを確認します。

    本番環境データベースにまだ接続されていないことを確認するのは必須です。

データセンター用の追加手順

Confluence Data Center を持っている場合、このプロセスは上述した Confluence Server とほぼ同じです。各ローカルのホームディレクトリとインストールディレクトリを各ステージングノードにコピーして、次の操作を実行します。   

  1. 本番環境の共有ホーム ディレクトリをステージング サーバーにコピーします。 
  2. <local-home-directory>/confluence.cfg.xml を編集し、ステージングの共有ホーム ディレクトリを指定します。この変更は、すべてのステージング ノードで実施する必要があります。 

<installation-directory>/confluence/WEB-INF/classes/confluence-init.properties および <home-directory>/confluence.cfg.xml に対する変更は、すべてのステージング ノードで実施する必要があります。

Confluence を起動するときは、通常どおり、一度に1つのノードを起動してください。 

4 外部ユーザー管理の複製(オプション)

JIRA、Crowd、または外部 LDAP ディレクトリでユーザーを管理している場合、以下が可能です。

  • ステージング環境の JIRA、Crowd、または外部ディレクトリを複製し、Confluence ステージング サイトがステージング外部ディレクトリを使用するように指定しすることができます(推奨)。
  • ステージング用サーバーをネットワークに接続するか、本番用サーバーと同じホストにローカルからアクセスします。 

5 アプリケーション リンクの変更(オプション)

If you have application links between Confluence and other Atlassian applications you should change the server ID on each staging application. See How to change the server ID of Confluence and Change the server ID for an instance of Jira server for JIRA. 

サーバー ID を変更せず、アプリケーション リンクを更新する場合、本番環境で新しいアプリケーション リンクを作成すると、代わりにステージング サーバーを指すことになります。

ステージング環境のアップグレード

ステージング環境を作成したら、本番環境を同じ方法で更新することができます。 

アップグレードの所要時間をメモします。この情報は、本番システムの停止を計画したり、ユーザーと連絡を取ったりする際に役立ちます。 

ステージング環境を使用して、カスタマイズやサイトの必須アドオンをテストすることができます。 

最終更新日 2017 年 9 月 5 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.