Penpotセルフホスト運用論：PostgreSQLを支配し、デザインデータを永遠に守るアーキテクチャ設計
テックリードの皆さん、こんにちは。
私たちは日々、デザインシステムをコードに落とし込み、UI/UXの精度を極限まで高めることに心血を注いでいます。しかし、その源泉である「デザインデータ」がどこに、どう保存されているか、そしてインフラストラクチャの障害やバージョンアップの際にどう守られるべきか、そこまで深く目を向けているチームはどれほどあるでしょうか。
SaaS版ではなくセルフホスト版Penpotを選択したということは、「データの完全な主権」を握っていることを意味します。SVGベースのオープンスタンダードなフォーマットを操るPenpotにおいて、その永続化レイヤーを担うのがPostgreSQLです。
今回は、Penpotのデータベース内部構造を解き明かし、ゼロダウンタイムに近い安全なバックアップ戦略、そしてチームの開発生産性を爆発的に高める実践的テクニックを網羅した「プロのための運用マニュアル」を伝授します。
—
1. 内部構造の理解：PenpotはPostgreSQLに何を保存しているのか？
Penpotのバックアップ戦略を立てるには、まず敵（＝データの構造）を知る必要があります。Penpotは、フロントエンドが生成するSVG/CSSの抽象構文木（AST）や、コンポーネントのツリー構造、ユーザー権限、チームスペースのメタデータをPostgreSQLに集約しています。
特筆すべきは、Penpotが扱うデータの多くがJSONB型としてリレーショナルデータベース内にリッチに格納されている点です。つまり、単なる「行と列のバックアップ」ではなく、デザインシステムの構造そのものをスナップショットとして抑える必要があります。
データの主要なドメイン
- Users & Auth: ユーザープロフィール、認証情報、チームメンバーシップ
- Teams & Projects: ワークスペースの論理分離
- Files (The Core): ページ、ボード、そしてコンポーネントの構造定義（ここが最も重要）
- Palettes & Typography: デザイントークンの実体
このデータ層の整合性を一瞬たりとも崩さずにスナップショットを取得することが、私たちインフラ/UIエンジニアの責務です。
—
2. 堅牢なバックアップ戦略：安全なダンプ取得と自動化スクリプト
Docker Composeで稼働するセルフホスト環境において、適当な `docker exec` による `pg_dump` は、トランザクションの整合性を損なうリスクがあります。コンテナのライフサイクルと調和した、実用的な自動バックアップ体制を構築しましょう。
以下のシェルスクリプトは、日次でPostgreSQLコンテナから一貫性のあるバイナリダンプ（カスタムフォーマット）を取得し、世代管理を行いながらS3互換ストレージ等へ転送するためのプロダクションレディな構成です。
実用的な自動バックアップスクリプト (`penpot-backup.sh`)
!/bin/bash
set -euo pipefail
— 設定エリア —
CONTAINER_NAME=”penpot-postgres”
DB_USER=”penpot”
DB_NAME=”penpot”
BACKUP_DIR=”/var/backups/penpot”
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_FILE=”$BACKUP_DIR/penpot_db_$DATE.dump”
RETENTION_DAYS=7
バックアップディレクトリの作成
mkdir -p “$BACKUP_DIR”
echo “==> [$(date)] Penpot PostgreSQLのバックアップを開始します…”
1. PostgreSQLのカスタムフォーマット(-F c)でダンプを取得
圧縮率が高く、復元時にオブジェクト単位の取捨選択が可能なためカスタムフォーマットを推奨
docker exec -t “$CONTAINER_NAME” pg_dump -U “$DB_USER” -d “$DB_NAME” -F c > “$BACKUP_FILE”
if [ $? -eq 0 ]; then
echo “==> [$(date)] ダンプの取得に成功しました: $BACKUP_FILE”
else
echo “==> [$(date)] 【エラー】ダンプの取得に失敗しました。” >&2
exit 1
fi
2. 権限の厳格化
chmod 600 “$BACKUP_FILE”
3. 古いバックアップの削除（世代管理）
echo “==> [$(date)] ${RETENTION_DAYS}日よりも古いバックアップを削除します…”
find “$BACKUP_DIR” -name “penpot_db_.dump” -type f -mtime +$RETENTION_DAYS -exec rm -f {} \;
echo “==> [$(date)] バックアッププロセスが正常に完了しました。”
これをホスト側の `crontab` に登録し、深夜帯に実行させます。
0 2 /usr/local/bin/penpot-backup.sh >> /var/log/penpot-backup.log 2>&1
—
3. メジャーバージョンアップ時のマイグレーション手法とリスクヘッジ
Penpotの進化スピードは凄まじく、新機能やパフォーマンス改善の恩恵を受けるためにはメジャーバージョンアップが不可欠です。しかし、データベーススキーマの変更を伴うアップデートでは、手順を誤るとデザインデータが破損するリスクがあります。
黄金のマイグレーション手順
1. 完全なバックアップの取得（前述のスクリプトを実行）
2. 既存サービスの停止
docker compose down
3. データディレクトリの物理バックアップ（念のため）
cp -r ./vol/postgres ./vol/postgres_bak_$(date +%Y%m%d)
4. `docker-compose.yml` のイメージタグを更新
# 例: プレースホルダーではなく具体的なバージョンを指定する（本番の鉄則）
image: penpotapp/backend:v1.19.0
5. マイグレーションを含めた起動
Penpotのバックエンドコンテナは起動時に自動的にスキーママイグレーション（Flywayや自社製マイグレーターなど）を実行します。
docker compose up -d
6. ログの監視
マイグレーションエラーやコネクションエラーが発生していないか、リアルタイムで追跡します。
docker compose logs -f backend postgres
万が一マイグレーションに失敗した場合は、速やかにコンテナを停止し、物理バックアップをリストアした上で、以前のイメージバージョンにロールバックできる体制を維持してください。
—
4. プロの生産性を引き上げる：開発・デザイン環境の最適化
ここからは、インフラレイヤーから一歩踏み込み、開発者とデザイナーのシームレスな連携と開発生産性を劇的に高める実践テクニックを公開します。
隠れたキーボードショートカット（知る人ぞ知る効率化）
Penpotの操作スピードをSaaSの主要デザインツール並み、あるいはそれ以上に引き上げるショートカットです。
- `Shift + R`: レスポンシブ/グリッドアライメントの切り替え（開発者視点のレイアウト検証に必須）
- `V`: セレクターツールとアートボードツールの素早いトグル
- `Ctrl / Cmd + Shift + L`: レイヤーパネルのフォーカス
チーム開発で絶対に共有すべき設定ルール（デザインシステム運用の核心）
セルフホスト環境では、チーム全体で「共通のパレット」や「タイポグラフィトークン」を強制することが可能です。これをコードベース（CSS Variables / Tailwind config）と同期させるためのベストプラクティス構成例を提示します。
デザインシステム共有設定のJSON構造（例：デザイントークン出力用）
Penpotからエクスポート、あるいはAPI経由で同期するデザイントークンのベース構造です。これをCI/CDパイプラインで自動的にフロントエンドのコード（`tailwind.config.js` 等）に変換します。
{
“$schema”: “https://json.schemastore.org/designtokens.json”,
“color”: {
“brand”: {
“primary”: { “value”: “#0D9488”, “type”: “color”, “description”: “メインブランドカラー (Teal 600)” },
“secondary”: { “value”: “#4F46E5”, “type”: “color”, “description”: “アクセントカラー (Indigo 600)” }
},
“surface”: {
“default”: { “value”: “#FFFFFF”, “type”: “color” },
“muted”: { “value”: “#F3F4F6”, “type”: “color” }
}
},
“spacing”: {
“tight”: { “value”: “4px”, “type”: “dimension” },
“base”: { “value”: “16px”, “type”: “dimension” },
“loose”: { “value”: “32px”, “type”: “dimension” }
}
}
チーム開発を加速させる `docker-compose.yml` のベストプラクティス構成例
チームメンバー全員が同一のローカルPenpot環境を数秒で立ち上げ、データベースの初期シードまで共有するための設定ファイルです。
version: ‘3.8’
services:
penpot-postgres:
image: postgres:15-alpine
restart: always
environment:
- POSTGRES_DB=penpot
- POSTGRES_USER=penpot
- POSTGRES_PASSWORD=penpot_secure_password_local
volumes:
- postgres-data:/var/lib/postgresql/data
ports:
- “5432:5432”
healthcheck:
test: [“CMD-SHELL”, “pg_isready -U penpot -d penpot”]
interval: 5s
timeout: 5s
retries: 5
penpot-redis:
image: redis:7-alpine
restart: always
ports:
- “6379:6379”
penpot-frontend:
image: penpotapp/frontend:latest
restart: always
ports:
- “9001:8080”
depends_on:
- penpot-backend
penpot-backend:
image: penpotapp/backend:latest
restart: always
ports:
- “6001:6001”
volumes:
- penpot-assets:/opt/penpot/assets
environment:
- PENPOT_PUBLIC_URI=http://localhost:9001
- PENPOT_DATABASE_URI=postgresql://penpot:penpot_secure_password_local@penpot-postgres/penpot
- PENPOT_REDIS_URI=redis://penpot-redis:6379
- PENPOT_TELEMETRY_ENABLED=false
depends_on:
penpot-postgres:
condition: service_healthy
penpot-redis:
condition: service_healthy
volumes:
postgres-data:
penpot-assets:
—
結びに：インフラへの理解が、デザインの信頼性を担保する
セルフホスト版Penpotの運用において、データベース（PostgreSQL）の挙動を完全に掌握することは、単なる「データ消失を防ぐ保険」にとどまりません。
それは、デザイナーが創り出すアイディア、チームが築き上げるデザインシステム、そしてエンジニアが実装するプロダクトのすべての信頼性の土台を築く行為です。
堅牢なバックアップ体制を構築し、インフラとデザインの境界線をシームレスに繋ぐことで、あなたのチームの開発生産性は次のステージへと飛躍します。さあ、今すぐバックアップスクリプトを仕込み、真のコントロールを手に入れましょう。