Implement the migration lifecycle
Compose source tools, adapters, governed actions, evidence, and cutover effects into a complete Databricks migration.
Implement the migration lifecycle
Airlift is the system of record and assurance plane around migration tools. Each phase has an executable integration boundary and a governed exit condition.
Start by generating the source-specific version of this lifecycle:
fa source plan <source>
fa source plan <source> --json > .airlift/plan.json| Phase | Developer integration | Governed result |
|---|---|---|
| Assess | Lakebridge Profiler/Analyzer job adapter | accepted estate run and inventory/dependency digests |
| Inventory | normalizer plus dependency builder | scoped objects, exclusions, complexity, residue lane |
| Convert | Morpheus/BladeBridge job and optional bounded repair | immutable conversion attempt and artifact digest |
| Transfer | source-specific checkpointed driver | watermark, lag, restart, counts, reconciliation |
| Validate | Reconcile, Experiments testkit, or admitted runner | provider run plus object-profile readiness observations |
| Cut over | Temporal worker plus certified effector | approvals, checkpoint, apply-once, verify, rollback evidence |
| Modernize | separate Runway release or project backlog | native Databricks disposition without rewriting parity history |
| Build an operational application | Databricks Apps, Lakebase, Synced Tables, Platform, and family handoffs | portable application-kit plan, synthetic BDD, preview/restore, and same-digest evidence |
Runtime rule
Workers and server handlers do not write projected state. They invoke the action named in
the source plan through runtime.invokeAction(...) with an authenticated tenant and
principal. Adapters return immutable references, digests, versions, verdicts, and
watermarks; Airlift validates and records those claims.
Definition of done
The success metric is the percentage of in-scope objects deployed and certified against their object-type evidence profile, with provenance and a tested rollback path. “Converted” is an intermediate state, not a cutover claim.