JIRA アプリケーション用ステージング サーバー環境の構築
JIRA をアップグレードする際は、本番サイトをアップグレードする前に、テスト環境でアップグレードを実施することを強くお勧めします。このガイドでは、テスト環境をステージングと読んでいます。
JIRA のサーバーライセンスには、ステージング環境用に無料の開発ライセンスが含まれています。ライセンスにアクセスする方法については、「JIRA 開発者用ライセンスの取得方法」を参照してください。
このページの内容:
アーキテクチャ方針
このページでは、アップグレードをテストするために 1 つのステージング環境を作成する方法について説明します。ただし、Atlassian アプリケーションが組織の基幹システムの場合、さらに開発環境を含める 3 層アーキテクチャをお勧めします。このアーキテクチャは、新しい変更のテストについてさらに柔軟で、それらを本番環境へロールアウトする必要がある場合、これらの変更が安全であることを確認できます。3 層アーキテクチャには次の環境が含まれます。
- プロダクション : 実稼働インスタンス。最小限のダウンタイムと十分なテスト済みの変更を要求。
- ステージング : プロダクションの前段階の環境。システム管理チームは運用開始前に正確な手順を確立できる。
- 開発 : 自由な環境。ユーザーは最先端の変更やリスクを伴う変更を試すことができる。
以下の手順は、ステージング環境と開発環境の両方の作成に適用できます。両方とも、本番環境の同一コピーですが、使用方法は異なります。
ステージング環境の作成
1. 環境の複製
ステージング環境は、リバース プロキシ、SSL 設定、またはロードバランサ（データセンターの場合）を含めて、実環境（本番）環境を厳密に複製する必要があります。異なる物理サーバーまたは仮想ソリューションを使用することもできます。重要なことは、本番環境の適切なレプリカとすることです。
以下の説明では、ステージング環境が物理的に本番環境と分離されており、同じオペレーティングシステム を備えていることを前提としています (JIRA を手動でインストールした場合には、同一の Java バージョンであることも前提となります)。
2. データベースの複製
データベースを複製する手順
- 本番環境データベースをバックアップします。バックアップの最良の方法の詳細については、データベースのドキュメントを参照してください。
- ステージング サーバーにデータベースをインストールし、バックアップをリストアします。
データベース バックアップのリストア手順は、選択したデータベースとバックアップ ツールによって異なります。以下を確認してください。
- 新しいステージング データベースが本番環境データベースと異なる名前であること。
- ステージング データベースのユーザーアカウントは、本番データベースのユーザーアカウントと同じユーザー名およびパスワードです。
- 文字エンコードおよびその他の設定は本番データベースと同じです (たとえば、Oracle データベースの場合、文字エンコードは Unicode UTF-8 (または AL32UTF8 のはずです)。
3. Jira のレプリケート
JIRA を複製するには、ご使用の JIRA インストールのコピーを作成し、ステージング データベースをポイントするようにします。以下の説明は、JIRA サーバー 向けです (Data Center の場合、JIRAを起動する前にいくつか追加手順があります)。
- 本番環境のインストール ディレクトリ全体をステージング サーバーにコピーします。
- 本番環境のホーム ディレクトリ全体をステージング サーバーにコピーします。
<installation-directory>/atlassian-jira/WEB-INF/classes/jira-application.propertiesを編集し、ステージング ホーム ディレクトリを指定します。<home-directory>/dbconfig.xmlまたは<installation-directory>/server.xml(古いバージョン) が、ステージング データベースを指すように編集します。非常に重要です!ステージング環境がプロダクション データベースを参照しないようにしてください。
以下のシステムプロパティで JIRA を起動し、ステージングサイトが通知やメールを送受信信しないことを確認します。メールの無効化の詳細については、「メール送信/受信の無効化」を参照してください。
-Datlassian.notifications.disabled=true -Datlassian.mail.senddisabled=true -Datlassian.mail.fetchdisabled=true -Datlassian.mail.popdisabled=true- Head to
http://localhost:<port>and log in to JIRA on your staging server. - Go to
> System > General Configuration , and change the base URL of your staging site (for example mysite.staging.com). - Go to > Applications > Versions and licenses, and apply your development license. To update the license, click the edit icon next to it.
Go to
> System > System info, and check that JIRA is correctly pointing to your staging database, and staging home directory. Go to
> System > Look and feel, and change the colors of the staging instance to make it different from the production instance. That's a small change, but it might help you avoid big mistakes.
データセンター用の追加手順
JIRA Data Center を持っている場合、このプロセスは上述した Confluence サーバー とほぼ同じです。各ローカルのホームディレクトリとインストールディレクトリを各ステージングノードにコピーして、次の操作を実行します。
- 本番環境の共有ホーム ディレクトリをステージング サーバーにコピーします。
<local-home-directory>/cluster.propertiesを編集し、ステージングの共有ホーム ディレクトリを指定します。この変更は、すべてのステージング ノードで実施する必要があります。
<installation-directory>/jira-atlassian/WEB-INF/classes/jira-application.properties および <local-home-directory>/cluster.properties に対する変更は、すべてのステージング ノードで実施する必要があります。
JIRA を起動するときは、通常どおり、一度に1つのノードを起動してください。
4. (オプション) 外部ユーザー管理の複製
Crowd または外部 LDAP ディレクトリでユーザーを管理している場合、以下が可能です。
- ステージング環境の Crowd または外部ディレクトリを複製し、JIRA ステージング サイトがステージング外部ディレクトリを使用するように指定しすることができます (推奨)。
- ステージング用サーバーをネットワークに接続するか、本番用サーバーと同じホストにローカルからアクセスします。
5. アプリケーション リンクの変更
JIRAと他のアトラシアン アプリケーションの間にリンクが存在する場合、各ステージングアプリケーションでサーバー ID を変更する必要があります。「Confluence のサーバー ID を変更する方法」および JIRA については「テストインストールのサーバー ID の変更 」を参照してください。
サーバー ID を変更せず、アプリケーション リンクを更新する場合、本番環境で新しいアプリケーション リンクを作成すると、代わりにステージング サーバーを指すことになります。
ステージング環境のアップグレード
ステージング環境を作成したら、本番環境を同じ方法で更新することができます。
アップグレードの所要時間をメモします。この情報は、本番システムの停止を計画したり、ユーザーと連絡を取ったりする際に役立ちます。
ステージング環境を使用して、カスタマイズやサイトの必須アドオンをテストすることができます。