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

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

The suggested license to apply to a non-production environment is a  Developer License , not an Evaluation license. You should only use an Evaluation license if you don't have a Developer license tied to your main license.

環境の複製

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

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

テスト環境の作成

1. データベースの複製

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

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

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

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

クラスタ

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

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

  1. Review the content of the clusternode table. This table is the reference used by Jira when it comes to Data Center operations. Execute the following command:

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

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

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

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

3. Remove DVCS accounts

By default the DVCS account info and secrets from your produstion environment will be transferred to your testing environment. This can cause confusion and performance issues.

To remove the data:

  1. Delete the organization mapping from "AO_E8B6CC_ORGANIZATION_MAPPING"

    delete from "AO_E8B6CC_ORGANIZATION_MAPPING";
  2. Delete the repository mapping from "AO_E8B6CC_REPOSITORY_MAPPING"

    delete from "AO_E8B6CC_REPOSITORY_MAPPING"

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

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

If you do not update the URL, the dashboard links on the test environment will redirect to the production environment, and users will get a dead page as a result.
Replace the old URL with the new one. For example, use the following command for PostgreSQL:

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.

5. メール サーバーのデータを削除する

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.

さらに、次のコマンドを実行して、すべてのメール ハンドラーを削除します。

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

テスト環境からメールが送信されないように、次の操作を行うこともおすすめします。

    • 次のコマンドで、Jira データベースのすべてのサブスクリプションを削除します。
delete from filtersubscription;
    • Jira データベースですべてのプロジェクトから通知スキームを削除するには、次のコマンドを実行します。
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.

7. 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 (以前のバージョン) を編集し、テスト データベースをポイントするようにします。 

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

クラスタ

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

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

9. テスト環境で 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. > [システム] > [一般設定] に進み、テスト サイトの ベース URL を変更します (例:   mysite.test.com )。
  4. > [アプリケーション] > [バージョンとライセンス] に移動し、開発ライセンスを適用します。ライセンスを更新するには、横にある編集アイコンをクリックします。
  5. Go to  > System  > System info, and check that Jira is correctly pointing to your test database, and test home directory. 

  6. Go to > 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.

10. Webhook を更新する

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

クラスタ

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

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

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

Jira と他のアトラシアン アプリケーションの間にアプリケーション リンクが存在し、それらを削除していない場合 (ステップ 5 を参照)、各テスト アプリケーションのサーバー ID を変更します。「Confluence のサーバー ID を変更する方法」および、Jira については「テスト インストールのサーバー ID の変更 」を参照してください。 

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

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

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

おつかれさまでした

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

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

最終更新日 2020 年 8 月 26 日

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

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