Jira 用にテスト環境を作成する

Jira をアップグレードする際は、本番サイトをアップグレードする前にテスト環境でアップグレードを実施することを強くおすすめします。

非本番環境に適用するライセンスとして推奨されるのは、評価ライセンスではなく開発者ライセンスです。評価ライセンスは、メインのライセンスに紐付いた開発者ライセンスを持っていない場合にのみ使用する必要があります。

環境の複製

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

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

テスト環境の作成

1. データベースの複製

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

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

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

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

クラスタ

2. clusternode テーブルから本番環境/不要なノードを削除する

これは、本番ノードとテスト ノードが 1 つのクラスタのように動作しないようにするためのものです。この操作を行うには、次の手順を実行します。

  1. clusternode テーブルのコンテンツを確認します。このテーブルは、Jira が Data Center のオペレーションで使用するリファレンスです。次のコマンドを実行します。

    SELECT * FROM clusternode;
  2. 本番環境ノードのすべてのレコードを削除します。

  3. 不要になったノードのレコードは、あとでインデックスの再作成操作に影響を与える可能性があるため、削除します。方法については、この記事を参照してください。

    XML バックアップも、不要になったノードを clusternode テーブルに取り込みます。

さらに、本番環境とテスト環境が別のサブネット内にあることを確認します。これは、テスト環境で本番環境との通信を試みるのを防ぐためです。ネットワーク内でクラスタ同士が互いを確認できる場合、問題が発生する可能性があります。

3. テキスト ガジェットで本番環境 URL を更新する

テキスト ガジェットを使用すると、カスタムの html テキストをダッシュボードに表示できます。

URL を更新しない場合、テスト環境のダッシュボードのリンクは本番環境へのリダイレクトを行い、その結果、ユーザーにはエラー ページが表示されます。
古い URL を新しい URL に置き換えます。たとえば ProgreSQL の場合は次のコマンドを使用します。

update gadgetuserpreference set userprefvalue = REPLACE(userprefvalue, '//prod.jira.base.url/', '//test.jira.base.url/') where userprefvalue like '%//prod.jira.base.url/%';

Remember to replace the production and test.jira.base.url in the command with your production and test Jira base URLs. For example, jira.atlassian.com and jira-test.atlassian.com.

4. Delete mail server data

To prevent emails being sent from the test environment and issues being created in this environment rather than in production, delete all incoming and outgoing mail servers by truncating the mailserver table.

Additionally, remove all mail handlers by running the following command:

delete from serviceconfig where clazz='com.atlassian.jira.service.services.mail.MailFetcherService'

To make sure no email is sent from the test environment, it's also a good idea to:

  • Remove all subscriptions in Jira database with:
delete from filtersubscription;
  • Remove notification schemes from all projects in Jira database with:
delete from nodeassociation where sink_node_entity='NotificationScheme

It's a good practice to remove any application links between Jira and other Atlassian applications so that the links in production and test environment don't get confused. Alternatively, you can keep the links and just update them (see step 11) however removing them altogether is less problematic. For details, see Remove an application link from Jira server using SQL.

6. Jira の複製

Jira を複製するには、Jira インストールのコピーを作成し、それがテスト データベースをポイントするようにします。

  1. 本番環境のインストール ディレクトリ全体をテスト サーバーにコピーします。 
  2. 本番環境のホーム ディレクトリ全体をテスト サーバーにコピーします。 
  3. <installation-directory>/atlassian-jira/WEB-INF/classes/jira-application.properties を編集し、テスト ホーム ディレクトリをポイントするようにします。
    クラスタ Data Center の場合、すべてのノードでこの変更を実行します。
  4. <home-directory>/dbconfig.xmlまたは  <installation-directory>/server.xml (以前のバージョン) を編集し、テスト データベースをポイントするようにします。 

    テスト環境が本番環境のデータベースを参照していないことを確認します。

クラスタ

7. 共有ホーム ディレクトリの管理

  1. 本番環境の共有ホーム ディレクトリをテスト サーバーにコピーします。 
  2. <local-home-directory>/cluster.properties を編集し、テスト環境の共有ホーム ディレクトリをポイントするようにします。すべてのテスト ノードでこの変更を実行します。 

8. テスト環境で Jira を起動

  1. 以下のシステム プロパティで Jira を起動し、テスト サイトが通知やメールを送受信しないことを確認します。メールの無効化の詳細については、「メール送信 / 受信の無効化」を参照してください。   

    -Datlassian.notifications.disabled=true
    -Datlassian.mail.senddisabled=true
    -Datlassian.mail.fetchdisabled=true
    -Datlassian.mail.popdisabled=true

    クラスタ ノードを 1 つずつ起動します。

    テスト メール通知が必要な場合
    その場合、メール通知を有効にしたまま、環境サーバーのメール設定を準備できます。
  2.  http://localhost:<port に進み、テスト サーバーの Jira にログインします。 
  3. Go to Administration () > System > General Configuration , and change the base URL of your test site (for example  mysite.test.com ).
  4. Go to Administration () > Applications > Versions and licensesand apply your development license. To update the license, click the edit icon next to it.
  5. Go to Administration () > System > System info, and check that Jira is correctly pointing to your test database, and test home directory. 

  6. Go to Administration () > System > Look and feel, and change the colors of the test instance to make it different from the production instance. That's a small change, but it might help you avoid big mistakes.

8. Webhook を更新する

テスト環境で本番環境の Webhook をトリガーすることはできません。そのため、これらを新しい環境で編集し、無効化するかテスト用の Webhook に変更する必要があります。
Webhook を管理する方法を参照してください。

クラスタ

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

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

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

If you have application links between Jira and other Atlassian applications and you have not deleted them (see step 5), you should change the server ID on each test application. See How to change the server ID of Confluence and Changing Server ID for Test Installations for Jira. 

サーバー ID を変更せずにアプリケーション リンクを更新する場合、本番環境で新しいアプリケーション リンクを作成するとテスト サーバーを参照する可能性があります。

12. (オプション) ルック アンド フィールの変更

テスト インスタンスのルック アンド フィールを変更し、本番環境と異なるロゴや配色を使用することをおすすめします。これにより、ユーザーが、URL のみに依存せずに 2 つの環境を区別するのに役立ちます。
Jira アプリケーションのルック アンド フィール設定」を参照してください。

おつかれさまでした

ランディング ページに戻り、アップグレード前の手順を完了させましょう

ランディング ページに移動

最終更新日 2020 年 6 月 23 日

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

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