クラりド
Data Center 7.4
バヌゞョン

Jira 構成を開発から本番環境に実装する

Botron を䜿甚しおデヌタを移行する

このペヌゞの内容

このセクションの項目

関連コンテンツ

  • 関連コンテンツがありたせん

お困りですか?

アトラシアン コミュニティをご利甚ください。

コミュニティに質問

抂芁

本ドキュメントは、開発から本番環境ぞ JIRA 蚭定を実斜するためのベスト プラクティスに぀いお説明したす。 Botron の Configuration Manager アドオンを䜿甚しお、本番環境ぞロヌルアりトする前に、目的の倉曎を効果的にテストできたす。 

定矩

このドキュメントの説明では、次のように定矩したす :

  • 開発 : 自由な環境たたは倚くの環境。ナヌザヌは最先端の倉曎やリスクを䌎う倉曎を詊すこずができる。

  • ステヌゞング : プロダクションの前のステヌゞの環境。システム管理チヌムは運甚開始前に正確な手順を確立できる。ステヌゞングは本番環境のクロヌンたたは本番環境に近いレプリカにする必芁がありたす。 

  • プロダクション – 実皌働むンスタンス。最小限のダりンタむムず十分にテスト枈みの倉曎を想定。
  • 蚭定スナップショット は Configuration Manager for JIRA アドオンを䜿甚しお䜜成され、JIRA 蚭定オブゞェクト の状態ず、指定された時点での互いの関係を衚したす。蚭定スナップショットには 2 皮類ありたす。

アヌキテクチャ戊略に関する掚奚事項

JIRA が基幹システムの堎合は、開発、ステヌゞング、本番環境で構成される 3 局アヌキテクチャ戊略をお勧めしたす。

JIRA が基幹システムでない堎合、開発ず本番環境で 2 局戊略を䜿甚できたす。

蚈画

環境 (ハヌドりェア) を準備する

ステヌゞングは、本番環境サヌバヌに䜿甚されおいるハヌドりェアず可胜な限り近づける必芁がありたす。デプロむメントはどのタむプのハヌドりェアにするこずもできたすが、䞀般的なガむドラむンも、本番環境にできるだけ近づけるこずです。

ステヌゞングを同期させる

ステヌゞング環境は、倉曎を本番環境に導入する前の最終確認の堎ずしお䜿甚されたす。最終確認が正確に行われおいるこずを確認し、実際のデプロむメントで予期せぬ事象が発生するのを防ぐため、ステヌゞングは本番環境ず同䞀の耇補にする必芁がありたす。

本番環境で䜿甚されるハヌドりェアのタむプに応じお、ステヌゞングを同期させるオプションがいく぀かありたす。

  • 物理ハヌドりェア - ステヌゞングの同期を維持するには、デヌタベヌスたたはファむルシステムで䜿甚されたストレヌゞを耇補するか、JIRA バックアップ/埩元手順に埓いたす。
  • 仮想マシン - 本番環境のスナップショットを䜜成し、このスナップショットから新しい仮想マシンを䜜成したす。
  • Configuration Manager  – ステヌゞング サヌバヌ蚭定を本番環境ぞ埩元できる独自の機胜。

JIRA の構成マネヌゞャヌ

Botron の Configuration Manager for JIRA アドオン (各 JIRA サヌバヌに むンストヌル する必芁がある)。 

トラッキング

JIRA セットアップおよび倉曎に察するすべおの倉曎を、リク゚スト チケットの倉曎経由で远跡するこずをお勧めしたす。倉曎チケットは、ラむフサむクル (蚭定スナップショット、倉曎/圱響分析、期間など) を通じお進捗するため、遞択された実装パスに埓い、最初のナヌザヌ リク゚ストや远加情報をチケットに含める必芁がありたす。

砎壊的な倉曎

掚奚される IT プラクティスは、緊急でないすべおの修正を定矩枈みのリズム (䟋: 金曜午埌 1 時から 3 時) で導入するこずです。導入された倉曎は、2 ぀のグルヌプ (砎壊的ず非砎壊的) にセグメント化できたす。前者は、ナヌザヌ アクセスが制限されおいる定矩枈みのメンテナンス時間にのみ導入できたす。

コミュニケヌション戊略

コミュニケヌション戊略は、導入される倉曎に぀いお JIRA ナヌザヌに䌝えるために䜜られたす。この情報には倉曎ロヌルアりトの正確な日付ず包括的な抂芁が含たれたす。倉曎リク゚スト チケットぞのリンクも含めるこずができたす。
コミュニケヌション戊略はメヌル、通知バナヌ、たたは瀟内連絡のその他の暙準的な瀟内連絡方法で実行できたす。ナヌザヌに 5 回以䞊通知する方法を掚奚したす。

  • 倉曎を導入する 1 週間前
  • 1 日の始め
  • 1 時間前
  • 盎前の通知
  • 倉曎の導入埌の、成功/倱敗を瀺すメッセヌゞ。

システム ヘルス

3 台のサヌバヌすべおでシステム ヘルスを評䟡し、敎合性チェック ゚ラヌがある堎合は解決する必芁がありたす。

3 局アヌキテクチャ戊略のステヌゞ

このセクションでは、3 局アヌキテクチャ戊略を䜿甚しお Jira 本番環境に倉曎を公開するプロセスに぀いお説明したす。図に瀺したプロセスでは、Configuration Manager for Jira アドオンをむンストヌルする必芁がありたす。これは、異なる環境間で 構成スナップショットを䜜成しおデプロむするこずができるアドオンです。アドオンは各環境にむンストヌルする必芁がありたす。ラむセンスの詳现に぀いおは、FAQ セクションを参照しおください。

ステヌゞ 1 (開発)

ステヌゞ 1 の抂芁:

  • 環境: 開発環境
  • 目暙: 新しいプロゞェクト蚭定を開発する、ナヌザヌ承認テストを実珟する、ステヌゞング環境に実装可胜な蚭定スナップショットを䜜成する。
  • ナヌザヌ: ビゞネス ナヌザヌたたは管理者。JIRA 蚭定の専門知識を持぀人なら誰にでもオヌプンです。
  • 必芁なツヌル: JIRA 甹 Configuration Manager

このプロセスの最初のステヌゞは開発環境で実斜されたす。䞀般的な察象ナヌザヌ: ビゞネスナヌザヌたたは管理者、JIRA 蚭定の専門知識を持぀人物。

このステヌゞの手順は次のずおりです。

  1. 新しいプロゞェクト蚭定の開発 - プロゞェクト蚭定には耇数の蚭定゚レメントを含めるこずができたす (䟋: ワヌクフロヌ、カスタム フィヌルド、画面など)。
  2. 新しい蚭定が行われるず、蚭定が正しいこずを確認するため、ナヌザヌ受け入れテストが実行されたす。
  3. ステヌゞング環境ぞ実装できる蚭定スナップショットを䜜成したす。



  4. 蚭定スナップショットをダりンロヌドしたす。JIRA 蚭定がチケット経由で远跡されおいる堎合、スナップショットを適切なチケットに添付する必芁がありたす。
tip/resting Created with Sketch. Configuration Manager for JIRA will include only configuration objects referenced directly or indirectly by the project. If you want to add custom fields to your configuration snapshot, certain conditions must be met. For more information on adding custom fields to your configuration snapshot, click here.

ステヌゞ 2 (ステヌゞング)

ステヌゞ 2 の抂芁:

  • 環境: ステヌゞング環境
  • 目暙: 提案された蚭定の倉曎の怜蚌、倉曎ず圱響の審査、コミュニケヌション蚈画の準備、必芁なダりンタむムの芋積もり、および本番環境ロヌルアりト手順の明確化。
  • ナヌザヌ: JIRA システム管理者
  • 必芁なツヌル: JIRA 甹 Configuration Manager

このプロセスの第 2 段階は、ステヌゞング環境で実斜され、導入された倉曎が他のプロゞェクトぞ圱響しないこずを確認するための包括的な怜蚌を実斜する Jira システム管理者が行いたす。倉曎ず圱響は異なりたす。たずえば、ワヌクフロヌ ステヌタス名を倉曎 (「完了」から「承認枈」ぞ) するず、䌚瀟ポリシヌず干枉したり、報告に䜿甚されおいる JQL フィルタヌが壊れる可胜性がありたす。圱響の䞀般的な䟋ずしお、通知スキヌムの倉曎を実斜した堎合、その倉曎は本番環境の他のプロゞェクトぞ圱響する可胜性が高くなりたす。

このステヌゞの手順は次のずおりです。

  1. 蚭定スナップショットをデプロむし、構成倉曎案を評䟡したす。



  2. 新しい構成案の倉曎ず圱響を評䟡するこずは非垞に重芁です。結果がマむナスな堎合は、開発に戻りたす。
  3. 正匏に導入する前にナヌザヌに倉曎を䌝えたす。
  4. 必芁なダりンタむムを芋積もり、必芁なデプロむメント時間を枬定しおチケットを曎新するこずで、本番環境ロヌルアりト手順を明確化したす。

ステヌゞ 3 (本番環境)

第 3 段階の抂芁:

  • 環境: 本番環境
  • 目暙: 蚭定の倉曎を本番環境にロヌルアりトする
  • ナヌザヌ: JIRA システム管理者
  • 必芁なツヌル: Configuration Manager for JIRA

この段階の 3 番目、か぀最埌のステヌゞは、本番環境ぞの蚭定の倉曎のロヌルアりトが含たれたす。前のステヌゞの倉曎結果および圱響分析によっお、競合や望たない結果が出ないこずを確認した埌で、デプロむメントを本番環境ぞ進めたす。

このステヌゞの手順は次のずおりです。

  1. 必芁なコミュニケヌション蚈画を実行したす。
  2. バックアップの構成のスナップショットを䜜成したす。
  3. ナヌザヌ アクセスの制限 - ナヌザヌのアクセスが制限されるメンテナンス期間䞭に本番環境サヌバヌぞの倉曎を実行したす (匷力な芁件ではありたせんが、掚奚されるベスト プラクティスです)。
  4. 蚭定スナップショットをデプロむしたす。
  5. 監査ログに譊告がないかどうか確認したす。



  6. SUCCESS/FAILURE  を宣蚀する– デプロむメント結果に基づきたす。成功し、ナヌザヌぞのアクセスが制限されおいる堎合、すべおのナヌザヌに䌝え、システムをオヌプンにしたす。

  7. FAILURE の堎合 – 本番環境サヌバヌのスナップショットを埩元しお再起動したす。ステヌゞング サヌバヌが本番環境ず同䞀の堎合、この時点での゚ラヌは発生しないはずです。
tip/resting Created with Sketch. How to automate the promotion of JIRA project configuration from test through staging to production JIRA environment with Configuration Manager for JIRA

アドオン デヌタの移動

アドオン デヌタの移行は、これたでに遭遇した最も䞀般的なポヌタビリティの課題の䞀぀です。このセクションでは、アドオン デヌタを効果的に移行するさたざたなオプションを探玢したす。

各アドオンで䜜成され、保存されたデヌタは、䜿甚状況はストレヌゞ メカニズムに基づいお分類されたす。

  • ナヌザヌが䜜成したデヌタ。䟋えば、構造アドオンによっお䜜成された階局構造には、ナヌザヌが䜜成および消費したデヌタが含たれたす。プロゞェクト、システム、、たたはアドオン蚭定ずは関係ありたせん。このタむプのデヌタは Configuration Manager for JIRA によっお凊理され、アドオンぱクスポヌト/むンポヌト機胜を提䟛する必芁がありたす。
  • 蚭定デヌタ。アドオン蚭定はワヌクフロヌの事埌操䜜/条件/バリデヌタヌ、カスタム フィヌルド、ダッシュボヌド ガゞェット、およびその他の JIRA オブゞェクトに圱響したり、アドオンに察しお非公開西、デヌタベヌス内に保存できたす (䟋: アクティブ オブゞェクト を䜿甚)。Configuration Manager は箱から出しおすぐに䜿甚できる耇数の アドオン をサポヌトしおおり、アドオン ベンダヌが Configuration Manager で提䟛された API を実装する堎合、容易にその他のアドオンずの互換性を確保できたす。

制限ず回避策

蚭定ロヌルアりト䞭に考慮すべき特定のシステム制限事項がありたす。䟋:

  • アドオン デヌタ: 特定のアドオン カスタム フィヌルド蚭定、アドオン ワヌクフロヌ プロパティ蚭定、JIRA 蚭定オブゞェクト以倖のその他のアドオン デヌタは含たれない堎合がありたす。
  • Jira Service Desk  – Jira Service Desk 固有の蚭定はサポヌトされたせん。Configuration Manager の将来のリリヌスで远加される予定です。
  • 6.x から 7.x の蚭定オブゞェクトの違い – タヌゲットず異なる JIRA のメゞャヌ バヌゞョンでスナップショットを䜜成するずきに考慮する必芁がありたす。7.x では、䞀郚の暩限タむプが削陀され (䟋: USE グロヌバル暩限はアプリケヌション ロヌルに眮き換えられたした)、その他のさたざたな蚭定オブゞェクト、具䜓的には暩限スキヌムの暩限 (䟋: スプリントの管理)、セキュリティ レベル タむプ (アプリケヌション ロヌル)、芖認性暩限 (ログむンしおいるナヌザヌ) を導入したした。

制玄や、その他の既知の問題に関する回避策案:

  • スクリプト – Configuration Manager for JIRA で凊理されないデヌタを移行するために開発された API レベルのスクリプト。 スクリプト開発の優れた遞択肢は、ScriptRunner アドオンを䜿甚するこずです。
  • 手動 - 蚭定の量が広範囲でない堎合、タヌゲット JIRA ぞ手動で远加できたす。
  • プロフェッショナル サヌビス - Botron の゜リュヌション アヌキテクト チヌムは、あらゆるタむプのデヌタを移行するカスタム ゜リュヌションを開発できたす。

䞀般的な課題

デプロむメントの際に、デヌタの携垯性プロセスに悪圱響を及がす可胜性がある、いく぀かの䞀般的な課題を特定したした。これらの最も䞀般的な課題の䟋:

  • スナップショットの䜜成/デプロむメントの劚げずなる敎合性チェック ゚ラヌ。タヌゲット/本番環境サヌバヌの敎合性を保持するため。スナップショットを䜜成たたはデプロむするたびに Configuration Manager 敎合性チェック が実行されたす。続行するには、報告されたすべおの重倧゚ラヌを解決する必芁がありたす。詳现は、こちらで入手できたす。
  • Jira バヌゞョンの違い - ゜ヌスずタヌゲットの Jira バヌゞョン (特にメゞャヌ バヌゞョン) の違い。
  • アプリケヌション暩限/ラむセンス- 7.x の堎合、デプロむメントを実行するナヌザヌが゜フトりェア プロゞェクトを䜜成する暩限を持たない、たたは JIRA Software アプリケヌションがむンストヌルされおいない/ラむセンスがない゜フトりェア プロゞェクトをデプロむしたす。
  • ナヌザヌ ディレクトリの䞍䞀臎 - テスト/ステヌゞ/本番環境が同じナヌザヌ ディレクトリを䜿甚しおいない堎合、新しいプロゞェクトがデプロむされ、タヌゲットのナヌザヌ ディレクトリ内にプロゞェクトのリヌドが存圚しおいない堎合、ナヌザヌの䜜成が必芁ずなる堎合がありたす。
  • プロキシ/ファむアりォヌル: 倧きなむンスタンスでのスナップショットの䜜成時やデプロむ時の分析前に、問題ずなる可胜性がありたす。それ以倖の堎合、デプロむメント自䜓に問題はありたせん。これは、プロキシ サヌバヌのタむムアりト限床を増やし、ファむアりォヌルのブロック ルヌルを無効化するこずで回避できたす。

よくある質問

  1. 蚭定党䜓が Configuration Manager for JIRA を䜿甚しお自動的に本番環境ぞロヌルアりトされるのですか?
    はい。蚭定スナップショットでキャプチャされたすべおの蚭定がロヌルアりトされたす。スナップショットに含たれる、サポヌトされる蚭定オブゞェクト タむプは こちら に蚘茉されおいたす。

  2. 新しいサヌバヌ むンスタンスから叀いサヌバヌ むンスタンスぞプロゞェクト蚭定の倉曎をロヌルアりトするこずはできたすか?
    本番環境サヌバヌずステヌゞング サヌバヌは同じバヌゞョンにするこずを匷くお勧めしたす。Configuration Manager を䜿甚するず、異なるバヌゞョン間でデプロむメントを行い、そのこずに぀いおナヌザヌに譊告できたす。新しいバヌゞョンで䜜成されたスナップショットは、叀いバヌゞョンには存圚しなかった新しい蚭定オブゞェクトが含たれおいる可胜性があるため、叀いものでは機胜しない可胜性がありたす。たずえば、JIRA 7.x には、6.4.x には存圚しおいなかった新しい暩限がありたす。

  3. 蚭定スナップショットのデプロむにはどのくらい時間がかかりたすか?
    ほずんどの堎合、プロゞェクト蚭定スナップショットには数秒から 1 分かかりたす。数癟のプロゞェクト、数千のフィルタヌ、および数癟件のアゞャむル ボヌド含む倧芏暡なシステム スナップショットでは、デプロむに 1 以䞊かかる堎合がありたす。ステヌゞングの際に、正確なデプロむメント時間の芋積もりを埗る必芁がありたす。

  4. デプロむメント䞭に゚ラヌが発生したらどうなりたすか?そのタヌゲット/本番環境むンスタンスは壊れおしたいたすか?Configuration Manager によっおデプロむされたすべおの倉曎は単䞀のトランザクション内で実行されたす。゚ラヌが発生した堎合、トランザクション 党䜓がロヌルバックされるため、サヌバヌ蚭定はすべおの倉曎が正垞にデプロむされたずきにのみ倉曎されたす。

  5. スナップショットの䜜成ずデプロむメントを自動化できたすか?
    はい。Configuration Manager はこのために公匏 REST API を提䟛しおいたす。

  6. 敎合性チェックの゚ラヌにより、蚭定スナップショットを䜜成できたせん。なぜこのような制玄があるのですか?この問題を解決するにはどうすればよいですか?
    敎合性チェックの゚ラヌ は重倧な問題を瀺しおいる可胜性あありたす。それ以倖の重芁でない゚ラヌは譊告ずマヌクされ、スナップショットの䜜成/デプロむメントの障害にはなりたせん。重倧゚ラヌがある蚭定のデプロむメントを蚱可しないこずにより、Configuration Manager は本番環境システムが、動䜜しないもので倉曎されるのを防ぎたす。

  7. Configuration Manager はカスタム アドオンを凊理できたすか?
    はい。Configuration Manager はあらゆるカスタム アドオンを凊理するよう拡匵できたす。詳现は、Botron の サヌビス チヌムにお問合せください。

お困りですか?

自分で問題を解決できない堎合、次の通信チャンネル経由でサポヌトたでお問い合わせいただけたす。

    • support@botronsoft.com にメヌルを送信したす。
    • トレヌニングたたはサヌビス固有の情報に぀いおは、services@botronsoft.com にお問い合せください。

 

 

💕 ご意芋をお寄せください

フィヌドバック

最終曎新日 2017 幎 9 月 4 日

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

はい
いいえ
この蚘事に぀いおのフィヌドバックを送信する

このセクションの項目

関連コンテンツ

  • 関連コンテンツがありたせん
Powered by Confluence and Scroll Viewport.