Confluenceの「ストレージ肥満」を外科手術する：エンジニアが挑むナレッジ管理の断捨離と最適化
長年運用されたConfluenceは、さながら「デジタルなゴミ屋敷」だ。
プロジェクトが長引くほど、誰が見るのか分からない数年前の設計図、一度しか見られなかった高解像度のスクリーンショット、そして何百回も更新されたPDFがストレージの深淵に積み重なっていく。
ストレージ容量の圧迫は単なる課金の問題ではない。「必要な情報に辿り着くためのノイズ」が増えることによる、認知負荷の増大（Cognitive Load）こそがチームのベロシティを殺す真犯人だ。
今回は、Confluence Cloudのストレージを最適化し、チームの「情報の検索コスト」を劇的に下げるための外科的アプローチを伝授する。
—
1. 敵を知る：容量を喰らっている「犯人」を特定せよ
闇雲に削除してはならない。まずは可視化だ。Atlassian管理画面の「ストレージ」セクションは最低限の道しるべだが、実務では以下のクエリやAPIを駆使して「重いページ」をランキング化する。
隠れたコマンド：CQLによる特定
Confluenceの検索バーで以下を叩き、巨大な添付ファイルを持つページをあぶり出す。
// 容量を圧迫しているであろう、大きな添付ファイルを持つページを探す
hasAttachment = true AND attachmentSize > 5MB ORDER BY attachmentSize DESC
※これで抽出された上位10ページが、君のストレージの30%を占めている可能性が高い。
—
2. 自動最適化とクリーンアップの戦略
A. 添付ファイルの「世代管理」を自動化する
Confluenceはデフォルトで添付ファイルの全履歴を保持する。これがストレージ圧迫の最大要因だ。
- 戦略: 3世代以上前の古いバージョンをアーカイブ/削除する運用ルールを徹底する。
- ツール: Atlassian Marketplaceの「Attachment Indexer」や「Smart Attachments for Confluence」は必須だ。これらは添付ファイルのメタデータ管理を強化し、自動クリーンアップポリシーを適用できる。
B. 画像の「軽量化」は文化にする
エンジニアなら知っての通り、PNGやBMPをそのまま貼るなど言語道断だ。
- 掟: ブラウザの拡張機能（例: TinyPNG や ImageOptim のCLI）を使い、貼り付け前に圧縮することをチームの標準（Definition of Done）に組み込む。
- ベストプラクティス: ページ公開前に「画像が最適化されているか」をチェックするチェックリストをテンプレートに含めよ。
—
3. ベロシティを高めるエンジニア向け「神」設定
キーボードショートカット（これを使わない奴は生産性を捨てている）
マウスに手を伸ばす時間は、集中力を切らす最大の要因だ。
- `c`: 新規ページ作成
- `e`: ページ編集
- `s`: 検索窓へフォーカス
- `m`: ページにラベルを追加
- `Ctrl/Cmd + Enter`: 編集の即時保存（公開）
チーム開発の「鉄の掟」：YAMLによる構成管理
Confluenceのページ構造やテンプレート設定を、可能な限り「コード」として管理する。以下は、チームのドキュメント運用を強制的に規律化するための設定例だ。
confluence-governance.yaml (チームのドキュメント運用規定)
document_policy:
retention_days: 365 # 1年以上更新がないページは自動アーカイブ対象
naming_convention:
- pattern: “RFC-” # RFC系は厳格なレビューフロー
- pattern: “POSTMORTEM-” # 事後検証はテンプレート必須
image_optimization:
max_width: 1200 # ピクセル単位での制限
format: “webp” # PNGではなく次世代フォーマットを推奨
labels:
required: [“project-name”, “status-draft/final”]
—
4. チームのナレッジを「資産」に変える設計思想
ストレージを軽くすることは手段であって目的ではない。目的は「必要な知識に3秒以内に到達すること」だ。
1. アーカイブ・ポリシーの徹底:
「更新停止から半年経過したページ」を定期的にアーカイブするスクリプトを、API経由で月次実行せよ。
2. インデックス・ページの活用:
検索に頼るな。各スペースのトップページに、そのプロジェクトの「全体地図（インデックス）」を置く。これだけでメンバーの迷いが消える。
3. 情報のライフサイクル:
「ドラフト(Draft)」「進行中(In-Progress)」「完了(Done)」「アーカイブ(Archived)」のステータスをラベルで強制し、自動的にアーカイブへ飛ばすワークフローを組む。
—
最後に：テックリードとしての提言
Confluenceが重いのは、君のチームが活発に活動している証拠でもある。しかし、その成長痛を放置すれば、やがてドキュメントの山に埋もれて身動きが取れなくなる。
「整理」とは、単に捨てることではない。「次に何が必要かを明確にすること」だ。
ストレージを最適化し、不要なファイルと古い履歴をパージせよ。その空いたスペースにこそ、チームの新しい知見と、未来のベロシティが刻み込まれるはずだ。
さあ、今すぐその巨大な「設計図.pdf」からメスを入れてくれ。