Federation Change Management Standard

🛡️ The Prime Directive

Unverified changes cause drift. Drift causes failure. Every change to the fleet must follow this protocol.

📝 The Federation 5-Point Check

1. Pre-Flight (Backup)

• [ ] Verify Backups: Check PBS or take a manual snapshot before touching config files.
• [ ] Check Dependencies: "If I move this, what breaks?" (Cron, Systemd, Symlinks).

2. Execution (Standardization)

• [ ] Paths: Use /mnt/infra_storage/configs and /mnt/infra_storage/app_data.
• [ ] Containers: Use Docker Compose files, never raw docker run commands (unless testing).

3. Persistence (The Reboot Test)

• [ ] Docker: Ensure restart: unless-stopped is set.
• [ ] System: Check crontab -l and systemctl status for broken paths.

4. Documentation (The Source of Truth)

• [ ] Access Guide: Create/Update docs/access/<service>.md.
• [ ] Inventory: Update IP/Port in inventory.md and network.md.
• [ ] Navigation: Update mkdocs.yml.

5. Validation

• [ ] Login: Can you actually log in to the service?
• [ ] Logs: Check docker logs for errors.