docs(deployment): rewrite migration prose for goose adoption
Update the deployment book and glossary to reflect the goose-based schema migration flow shipped in 12b2f9d/0f7450a: - ch07: clarify startup probe assumes migrations ran out-of-band - ch08: drop AutoMigrate-with-advisory-lock prose; describe goose Job - ch12: pod startup checks goose_db_version, no longer runs migrations - ch14: document the Job→wait→roll deploy gate and how to debug failures - ch16: add "Migrate Job fails during deploy" + "Schema precondition failed" failure modes - ch17: new runbook entries §26 (run migrations manually), §27 (recover from failed/dirty migration), §28 (bootstrap goose on fresh clone) - ch19: postscript on §13 noting MigrateWithLock approach is superseded - ch20: mark "Migration Job for schema changes" task done - glossary: add `goose` and `goose_db_version`; flag AutoMigrate as tests-only - references: add goose links; flag AutoMigrate as tests-only
This commit is contained in:
@@ -65,7 +65,9 @@ Every external link cited anywhere in this book, grouped by topic.
|
||||
- [Neon usage-based pricing announcement][neon-blog]
|
||||
- [Neon connect from any app][neon-connect]
|
||||
- [Postgres advisory locks][pg-locks]
|
||||
- [GORM AutoMigrate][gorm-automigrate]
|
||||
- [GORM AutoMigrate][gorm-automigrate] (tests only — production migrations use goose)
|
||||
- [pressly/goose — SQL migration tool][goose]
|
||||
- [Goose documentation][goose-docs]
|
||||
|
||||
## Backblaze B2
|
||||
|
||||
@@ -168,6 +170,8 @@ Every external link cited anywhere in this book, grouped by topic.
|
||||
[neon-connect]: https://neon.com/docs/connect/connect-from-any-app
|
||||
[pg-locks]: https://www.postgresql.org/docs/current/explicit-locking.html#ADVISORY-LOCKS
|
||||
[gorm-automigrate]: https://gorm.io/docs/migration.html
|
||||
[goose]: https://github.com/pressly/goose
|
||||
[goose-docs]: https://pressly.github.io/goose/
|
||||
|
||||
<!-- B2 -->
|
||||
[b2-docs]: https://www.backblaze.com/docs/
|
||||
|
||||
Reference in New Issue
Block a user