JIRA & Confluenceの Cloud移行で苦労した点

2020年に行った社内で行った、JIRA & ConfluenceのCloud移行について苦労した点などをお話しさせていただきます。

Transcript

1. JIRA & Confluenceの Cloud移行で苦労した点 2021/03/24 #45 Tokyo Atlassian Community Online MeetUp 株式会社インタースペース システム企画開発部 鈴木拓
2. 今回LTを行おうと考えた理由について • 移行完了すると、社内で移行ナレッジは余り役に立たたない • その当時、移行に関しての情報が余りネットになかった • サーバ製品のサポートが終了 何か参考になる情報が提供でれば良いかなと考えました
3. 自己紹介 名前： 鈴木拓(すずき ひらく) 所属： 株式会社インタースペース システム企画開発部 インフラグループ 略歴： SES（プログラマー C#など）→ 今の会社 JIRA/Conflueユーザ歴：約5年（管理者は1年目）Datadog やElasticCloudなど主にSaaS製品の導入・運用
4. 事業内容
5. 移行の結果 2020年1月に無事に移行が完了しました！ コロナ前に間に合い本当に良かったです アトラシアンサポートの皆様には本当にお世話になりま した
6. アジェンダ • 移行前に困ったこと　←この話メイン • 移行時に困ったこと • 移行後に困ったこと • 移行して良かったこと • まとめ • おわりに ※2020年01月移行時の情報です
7. 事前情報 各種バージョンについて • Confluence （6.7.2） • JIRA（7.7.0） 使用人数：約４０人　→ 約５０人（一部部署で使用） 移行期間（2019年06月~2020年01月） • 10月まで特に何もやらず • 10月/11月 トライアル • 12月 社内調整（￥） • 1月　本番移行 ※作業としては2,3か月でできました
8. 移行前に困ったこと
9. まず誰が移行を行うのか？ 移行の計画自体は、2019年6月から開始されました 移行理由としては、使用者増加の影響で柔軟な料金体系に変更したい 私も担当の一員として参加してましたが、片手間で皆で調べましょうみたいな形でし た そして、何も進捗もなく10月まで過ぎました....
10. まず誰が移行を行うのか？ いざ、やらねば！！（と思いました） 管理者 2019年10月
11. まず誰が移行を行うのか？ メイン担当が私に変更になりました(合わせて管理者にもなる) 他のメンバーは、移行後の確認作業になりました 担当者が明確なことになったことで、移行が進み始めました
12. 移行方法の調査 移行方法について（2019年10月） • Confluence 　→「Confluence Cloud Migration Assistant」 • JIRA　　　　→　手動 (その当時マイグレーションツールがなかったので) 「Jira のサイト インポート機能を使用してサーバー製品からクラウド製品に移行する」 https://ja.confluence.atlassian.com/cloud/migrate-from-jira-server-to-jira-cloud-972349848.html またアドオンは自動移行できず、Cloud版で同様の機能ないか調べて導入しました 移行の順番はJIRA→Confluenceの順で行います 詳しくは、「ACE#43 Jira/Confluence Atlassian Cloudへの移行ポイント」をご確認を https://www.youtube.com/watch?v=ca00OrcEtX0
13. トライアルの方法 本番のサーバを動かすわけにはいかない ため、 一旦開発用サーバにコピーをしました Atlassian Cloud 無料トライアル申込を行い クラウド環境を確保しました production dev copy 移行を試す
14. トライアルでハマったところ Part.1 ◆JIRAのチケットのコメント時刻がUTCになっている 7.7.0　→　7.13.1 へアップグレードすることで対応できました ◆JIRAマクロのマッピングに失敗する Confluence Cloudの　設定（右上の歯車ボタン） > Jira マクロの修正　より対応
15. トライアルでハマったところ Part.2 JIRAのConfluenceのページが、リンクされなくなりました こちらは既知の問題らしく アトラシアンサポート側で対応 してもらうことになりました （今は直ってるかな？）
16. トライアルでハマったところ Part.3 一部スペースで何故か「Confluence Cloud Migration Assistant」が失敗しました 原因は、Confluenceのアドオン「Blog, Page and Template Tools」でページをブログに変換すると同様のタイトル のページとブログが共存してしまうことでした 変換前のページを削除しました
17. トライアルでハマったところ Part.4 「Confluence Cloud Migration Assistant」でゴミ箱にデータが残っていると失敗しました スペースとゴミ箱に同様なタイトルのページが存在したのが原因でした また、スペースキーに空白が入っているものはゴミ箱が画面上削除できないというものがありました 下記チケットを確認し、 「Content ID」を取得しAPIを使用してゴミ箱の中身を消しました ◆Unable to purge trash from personal space with a white space in the space key https://jira.atlassian.com/browse/CONFSERVER-56349
18. トライアルでハマったところ Part.5 Confluence の PDF エクスポートで日本語部分が空白になる 移行したConfluenceCloudより、PDFをエクスポートしたら日本語が豆腐□になっていました こちらアトラシアンのサイトにも書かれているのですが、TTF形式のフォントファイルを取得して設 定を修正する必要があります フォントに関しましては、IPAフォントの4書体パック(Ver.003.03)を使用しました リンク：Confluence の PDF エクスポートで日本語部分が空白になる
19. トライアルでハマったところ Part.6 移行手順をConfluenceに記載しているためみれない。。。 事に気づきました 事前にエクスポートしておきましょう ※その他色々ありました・・・
20. 移行時に困ったこと
21. 移行手順について 下記のような手順で行いました（ 7までは休日1日使って実施） 1. JIRAを7.13.1へアップグレード　 2. JIRA Cloud移行 3. Conflue Cloud移行 (Migrationツールは1hと予想したが、実際4hかかった) 4. アドオン・アプリの追加 5. Jiraマクロの修正 （ハマったところPart.1） 6. ユーザー権限の付与・不要なアドオン・アプリの削除 7. JIRAからConfluenceへのリンク修正をサポートに修正依頼 （ハマったところPart.2） 8. 動作確認 9. 招待メールを送る
22. 移行本番について 「トライアルでハマったところ Part.3」であった問題 が再発生。。。。 それ以外特に問題なし！
23. 移行後に困ったこと
24. 大量の質問問題 現在Cloudの機能は充実してきたのですが、その当時はサーバのみにしかないものが 多くそのため大量に質問がきました 一例を紹介します • JIRA表テンプレートで「||タイトル||備考||」が使えない • バックログのエピックリンクが表示されてない →デフォルト表示ではなくなったので設定で直る • JIRAのコメントにリンクがない →当時はなく現在対応されている 現在は、操作になれ質問がほぼないです 今思うと、多くの人が使ってくれていたのだと思います！！
25. リンク切れ問題 Confluenceのページに、ConfluenceのリンクをWebリンクとして貼ってい る場合は、Cloudの方へリンクは修正されません よってリンクをクリックすると移行前の Confluenceに飛んでしまう 結果、移行前のオンプレサーバを当分停止することができなかった またこれ以外のツールでリンクを張り付けている場合も同様 半年近く待ち、必要なもののみ更新して現在はオンプレ版は使用しない形 になっている
26. 移行していて良かったこと
27. 可用性のUP 緊急対応がなくなる 今までConfluenceやJIRAのプロセスが落ちて復旧しなかったり 手動で対応していたものが無くなりました 社内のネットワーク事情に左右されない またコロナ化によるテレワーク対応時に、 社内ネットワークが不安定で仕事にならない状態でも ConfluenceやJIRAが動いていたため仕事になるなどの事象もありました
28. 新機能の追加 以前はバージョンアップしないといけなかったのが、勝手に追加されます 導入後、1年でも結構機能が増えました • Confluenceのアーカイブ機能 • 検索窓より、ConfluenceとJIRAのどちらも検索できる • Confluenceの見出しにリンクがつく • ナビゲーションウインドウが左から上に • JIRAのコメントがソートできるようになった • などなど
29. まとめ
30. 移行に関してのまとめ • 担当者をしっかり作ろう • トライアルは失敗の連続だが、本番移行を助ける • 移行後も色々あるので準備を • Cloud化によるメリットはあります • 分からなかったらアトラシアンサポートに聞こう
31. おわりに
32. おわりに ここに記載できなかった部分も多々あるのですが、無事に移行することができました 本日はLTの機会を頂きありがとうございました