やあ、こんにちは。アジャイルコーチとして数多くの現場を見てきたけれど、組織再編やM&Aという「荒波」に揉まれるチームをいくつも救ってきた経験から、今日は君に「Confluenceの統合」という、エンジニアにとって最も胃の痛くなる、しかし最も価値ある技術について話そうと思う。
組織が統合されるとき、ナレッジの断絶は致命的なミスを生む。別々に育った文化をひとつの「情報の聖域」にまとめる。これは単なるデータ移行じゃない。組織の「脳」を移植する作業なんだ。
今日は、その魂の移植を失敗させないための極意を伝授するよ。
—
1. なぜ「力技」での移行が破滅を招くのか？
多くの現場で、無計画な「エクスポート/インポート」が悲劇を引き起こす。
- ページIDの衝突: 異なるインスタンスで同じIDが発行されていると、リンクが死ぬ。
- ユーザー権限の崩壊: ユーザー名やメールアドレスの不一致により、誰がどのページを書いたか分からなくなる。
- 添付ファイルの消失: ファイルパスの不整合は、開発の歴史を闇に葬る。
これらを防ぐために、我々プロは「Atlassian Cloud Migration Assistant (ACMA)」を唯一の正攻法として推奨する。これはAtlassianが公式に提供している「移行の専門家」だ。
—
2. 移行の「HelloWorld」：最小限の検証環境で手順を確立する
いきなり本番環境を動かしてはいけない。まずは「最小限の構成」で、移行の流れを身体に覚え込ませるんだ。これが君のエンジニアとしての生存戦略になる。
手順の要点：
1. アセスメント: まず、移行元（Source）のインスタンスに「Migration Assistant」アプリをインストールする。
2. 接続設定: 移行先（Destination）のクラウド環境と認証を確立する。
3. ユーザーのクレンジング: ここが重要だ。重複するユーザーをメールアドレスでマッピングし、統合する戦略を立てる。
精度を高める「HelloWorld」的チェックリスト
初めての移行では、この3点だけは必ず確認してほしい。
- [ ] 添付ファイルの整合性: 移行後、ランダムに5つのページを選び、画像やPDFが正常に表示されるか。
- [ ] 権限継承: グループ設定が引き継がれ、正しいメンバーが閲覧できるか。
- [ ] 外部アプリの互換性: 使っていたマクロ（Draw.ioやGliffyなど）が、移行先でもライセンス・有効化されているか。
—
3. 現場で震えるほど役立つ「黄金のルール」
ルール1：ユーザー統合は「メールアドレス」を正とする
組織再編時、IDがバラバラになることは避けられない。だが、メールアドレスは一意のキーだ。統合前に、Active DirectoryやGoogle Workspace側でメールアドレスの正規化を済ませておくこと。これだけで、移行後の「ログインできない」という問い合わせを9割減らせる。
ルール2：スペースの「断捨離」を恐れるな
古い環境には「もう誰も見ていないゴミデータ」が眠っている。移行は、最高の「棚卸し」のチャンスだ。全スペースを移行するのではなく、「過去1年更新がないスペースはアーカイブ化して別ストレージへ」というルールを決めよう。情報の密度を高めることが、チームのベロシティを上げる。
ルール3：ダウンタイムは「儀式」にする
移行当日は、必ず移行元のインスタンスを「読み取り専用」にする。
移行中のステータス変更用設定（イメージ）
maintenance_mode:
enabled: true
message: “組織統合のため、ナレッジの聖域を移動中です。作業終了まで少々お待ちください。”
redirect_url: “https://new-confluence.example.com”
ユーザーに対して、いつ終わるのか、どこへ行けばいいのかを明示する。この透明性が、変化に対するチームの不安を解消するんだ。
—
4. 最後に：君が明日からできること
まずは、現在のConfluenceで「Migration Assistant」をインストールし、どんなデータが移行対象として認識されているか、眺めてみてほしい。
ツールを恐れる必要はない。大切なのは、「情報は生き物である」という視点だ。移行とは、単なるファイルのコピーではなく、チームのナレッジという「脈動」を新しい環境へ繋ぐ作業なんだよ。
これをマスターすれば、君は「ただのエンジニア」から、組織の「ナレッジデザイナー」へと進化できる。毎日の作業が、単なる入力から、価値ある資産の構築へと変わるはずだ。
困ったときはいつでも聞いてくれ。君の挑戦を心から応援しているよ。