PostgreSQL zero-downtime migrations made easy
Go to file
Carlos Pérez-Aradros Herce 16b1d75ee0
Add raw SQL operation (#43)
This change adds a new `sql` operation, that allows to define an `up`
SQL statement to perform a migration on the schema.

An optional `down` field can be provided, this will be used when trying
to do a rollback after (for instance, in case of migration failure).

A new trigger is installed to capture DDL events coming from direct user
manipulations (not done by pg-roll), so they are stored as a migration,
getting to know the resulting schema in all cases.
2023-08-30 11:50:59 +02:00
.github Matrix test against supported Postgres versions in CI (#46) 2023-08-17 11:13:31 +01:00
.vscode Add linter to tests (#9) 2023-06-27 16:33:50 +01:00
cmd Add raw SQL operation (#43) 2023-08-30 11:50:59 +02:00
examples Add raw SQL operation (#43) 2023-08-30 11:50:59 +02:00
pkg Add raw SQL operation (#43) 2023-08-30 11:50:59 +02:00
.golangci.yml Add linter to tests (#9) 2023-06-27 16:33:50 +01:00
docker-compose.yml Initial commit 2023-06-22 17:30:40 +02:00
go.mod Change module name (#60) 2023-08-22 09:27:58 +01:00
go.sum Upgrade to Go 1 21 (#54) 2023-08-17 07:43:41 +01:00
main.go Change module name (#60) 2023-08-22 09:27:58 +01:00
README.md Add migrations state handling (#7) 2023-06-28 11:10:03 +02:00

pg-roll

⚠️ Under development ⚠️

PostgreSQL zero-downtime migrations made easy.

Getting started (development)

  • Bring a development PostgreSQL up:

    docker compose up
    
  • Initialize pg-roll (first time only):

    go run . init
    
  • Start a migration:

    go run . start examples/01_create_tables.json
    
  • Inspect the results:

    psql postgres://localhost -U postgres
    
    \d+ public.*
    \d+ 01_create_tables.*
    
  • (Optional) Rollback the migration (undo):

    go run . rollback
    
  • Complete the migration:

    go run . complete