Infrastructure migrations often fail in small, expensive ways: a mount option changes, a service is disabled, or disk usage moves past an operational threshold. Teams need structured evidence that the migrated host still matches the expected operating profile.

Solution Overview

This project provides a Python CLI that collects system state into JSON snapshots and compares before/after files. The output is designed for change records, migration gates, and post-cutover validation.

Architecture Overview

Operator -> CLI -> Collectors -> JSON Snapshot -> Comparator -> Diff/Report

Core components:

cli.py provides collect, compare, snapshot, list, and report commands.
collectors/ gathers mounts, services, and disk usage.
validators/compare.py identifies drift and validation failures.
reports/ contains report generation helpers.
examples/ contains realistic before/after evidence.

How to Run

cd migration-validation-framework
python3 cli.py collect --output before.json --systems web01,db01
python3 cli.py collect --output after.json --systems web01,db01
python3 cli.py compare before.json after.json --output diff.json
python3 cli.py compare examples/before.json examples/after.json --output /tmp/migration-diff.json

Legacy snapshot IDs are still supported:

python3 cli.py snapshot --env prod --label pre --systems web01,db01
python3 cli.py compare prod-pre-20260429_020000 prod-post-20260429_030000 --output change-0429

Example Output

Comparison completed: diff.json (FAIL)
Overall risk: high
Total changes: 4
Failed checks: critical_services_running
Recommendation: restore sshd before production cutover

Sample inputs and output are available in examples/before.json, examples/after.json, and examples/diff.json.

Real-World Use Case

During a data center migration, a platform team can collect baseline state before cutover, collect the same evidence after DNS or workload migration, and attach the diff to the change ticket. The framework gives reviewers a compact signal on whether the host is ready for production traffic.