こんにちは。あなたのチームのベロシティを最大化するためにやってきた、シニア・アジャイルコーチの「ナレッジ・ドクター」です。
今日は、Confluence Cloud（コンフルエンス・クラウド）を使い始めたばかりのあなた、あるいは「最近Confluenceが重いな」「ストレージ制限の警告が来た」と頭を抱えている管理者の卵であるあなたに、非常に大切な話をします。
Confluenceは、チームの知恵を蓄積する「第2の脳」です。しかし、何も考えずに画像や動画、ファイルを放り込み続けると、この脳はあっという間に「情報のメタボリックシンドローム」に陥ります。
ストレージ容量の枯渇は、単なるコストの問題ではありません。ページの読み込みを遅延させ、検索性を低下させ、最終的にはチームの「書こう」という意欲を削ぎ取ります。
今回は、初心者の方でも今日から実践できる、Confluenceを常にサクサク・軽量に保つための「極限の最適化戦略」を伝授しましょう。これをマスターすれば、あなたはチームから「ドキュメント管理の魔術師」と呼ばれるようになりますよ。
—
1. なぜConfluenceの容量は「いつの間にか」なくなるのか？
まず、敵を知ることから始めましょう。Confluence Cloudのストレージを圧迫する最大の要因は、実は「最新のファイル」ではありません。
「隠れたバージョン履歴」です。
Confluenceには、同じ名前のファイルをアップロードすると、古いファイルを自動的に「履歴」として保存する機能があります。
- 10MBの資料を5回修正してアップロードしたとします。
- 画面上に見えているのは1つ（10MB）だけですが、裏側では合計50MBの容量を消費しています。
これが数百ページで繰り返されるとどうなるか、想像がつきますよね？
—
2. 【基礎編】まずは現状を「可視化」しよう
闇雲に消すのは危険です。まずは、どこに「重いデータ」が潜んでいるか特定する「Hello World」的な第一歩を踏み出しましょう。
ステップ：スペース統計を確認する
1. 調査したい「スペース」に移動します。
2. 左サイドメニューの [スペース設定] ＞ [コンテンツの管理] ＞ [スペース統計] をクリックします。
3. ここで、そのスペースがどれくらいの添付ファイルを持っているか一目で分かります。
> Pro Tip: もし特定のページが異常に重いと感じたら、ページ右上の `…` メニューから [添付ファイル] を開いてみてください。そこには過去の遺産（古いバージョン）がズラリと並んでいるはずです。
—
3. 【実践編】画像の「自動最適化」という考え方
エンジニアとして、最も避けるべきは「手動で1枚ずつ画像を縮小すること」です。そんな退屈な作業は、設計思想で解決しましょう。
画像アップロードの「黄金律」
Confluenceに貼る画像は、以下のルールを徹底するだけで容量を80%削減できます。
- スクリーンショットは「PNG」ではなく「WebP」や「JPEG」を検討する： RetinaディスプレイのMacで撮ったスクリーンショットは、驚くほど高解像度で巨大です。
- 解像度を意識する： 横幅1200pxあれば、ドキュメントとしては十分すぎます。
ツールで自動化する
VS Codeなどのエディタでドキュメントを書く習慣があるなら、画像を貼り付ける前に自動で圧縮するスクリプトを噛ませるのがプロの仕業です。
—
4. 【上級編】APIを使って「古いバージョン」を一掃する
さて、ここからが伝説のエンジニアとしての本領発揮です。UIから一つずつ古いバージョンを消すのは時間がもったいない。ConfluenceのAPIを使って、添付ファイルの「古い履歴だけ」を削除する自動化の考え方を紹介します。
以下のPythonスクリプト（概念）は、Confluenceのメンテナンスを自動化する際の「Hello World」となる強力な武器です。
import requests
from requests.auth import HTTPBasicAuth
import json
— 設定情報 —
DOMAIN = “your-domain.atlassian.net”
USER_EMAIL = “your-email@example.com”
API_TOKEN = “your-api-token” # Atlassianアカウントから発行
SPACE_KEY = “TEAM”
auth = HTTPBasicAuth(USER_EMAIL, API_TOKEN)
def cleanup_old_versions(content_id):
“””
特定のページの添付ファイルをチェックし、
最新バージョン以外の履歴を削除する（ロジックの骨子）
“””
# 添付ファイル一覧を取得
url = f”https://{DOMAIN}/wiki/rest/api/content/{content_id}/child/attachment”
response = requests.get(url, auth=auth)
attachments = response.json().get(‘results’, [])
for attachment in attachments:
version_number = attachment[‘version’][‘number’]
attachment_id = attachment[‘id’]
# バージョンが1より大きい（＝履歴が存在する）場合
if version_number > 1:
print(f”Cleaning up {attachment[‘title’]}… version {version_number}”)
# ここで古いバージョンを特定して削除するAPIを叩く
# 注: 実際の削除には、各バージョンごとのID指定が必要です
このスクリプトを定期実行（Cronなど）させることで、
ストレージの「肥大化」を未然に防ぐことができます。
> 注意： 削除APIは強力です。実行前に必ず「本当に履歴が必要ないか」をチームで合意形成してくださいね。
—
5. 究極のクリーンアップ戦略：アーカイブの極意
「いつか使うかもしれない」という不安が、ストレージを圧迫します。そこで、「アーカイブ機能」を賢く使いましょう。
1. 「賞味期限」を決める： 1年以上更新がないページは、自動的に「アーカイブスペース」へ移動させる運用ルールを作ります。
2. PDF化して外部へ： 法律的に保管が必要だがConfluenceで見る必要がないものは、PDFとしてエクスポートし、安価なクラウドストレージ（AWS S3のGlacierなど）へ逃がします。
—
最後に：綺麗なナレッジベースは、健康なチームの証
Confluenceのストレージ掃除は、単なるメンテナンスではありません。それは「情報の鮮度を保ち、チームの思考のノイズを取り除く儀式」です。
- 不要な添付ファイルのバージョンを削る。
- 巨大な画像は適切なサイズにリサイズする。
- 使わなくなったページは勇気を持ってアーカイブする。
これらを習慣化すれば、あなたのConfluenceは常に光り輝き、必要な情報がすぐに見つかる最高の武器であり続けるでしょう。
「ツールに使われるのではなく、ツールを乗りこなす」。
この精神で、今日からあなたのConfluenceをダイエットさせてみませんか？
もし手順で迷ったら、いつでも聞いてくださいね。あなたの挑戦を応援していますよ！