Skip to main content

Function: createMigrationRunner()

createMigrationRunner(options): object

Defined in: migrations/runner.ts:102

Runs an application's migrations against a Postgres database and records each one in a ledger table, so a deploy can run migrate run on every release and only what is pending happens.

The ledger records what finished, not what half-ran: a migration that throws leaves no row and is retried from the top on the next run, which is why every migration must be idempotent as well.

Parameters

ParameterType
optionsMigrationRunnerOptions

Returns

object

baseline

baseline: (__namedParameters) => Promise<string[]>

Parameters

ParameterType
__namedParametersBaselineOptions

Returns

Promise<string[]>

close

close: () => Promise<void>

Returns

Promise<void>

run

run: (__namedParameters) => Promise<RunResult>

Parameters

ParameterType
__namedParametersRunOptions

Returns

Promise<RunResult>

status

status: () => Promise<MigrationStatusReport>

Returns

Promise<MigrationStatusReport>