notation deploy
notation deploy <entryPoint>Compiles and deploys the stack to AWS.
notation deploy infra/api.tsWhat happens
- Compile — esbuild compiles infra and runtime modules to
dist/. - Build resource graph — imports the compiled output, calls
register(collector), returns the resource graph. - Reconcile — the reconciler compares desired state (graph) against current state (
.notation/state.json):- New resources → create
- Changed params → update
- No changes → noop
- Orphaned resources (in state but not in graph) → delete
- Topological deployment — resources deploy in dependency order (levels). Resources at the same level deploy concurrently.
- Drift detection — enabled by default. Reads actual AWS state and compares against stored state. If drifted, Notation updates to match your definition.
State is persisted to .notation/state.json after each operation. Configurable via NOTATION_STATE_PATH.