summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2020-01-17 03:18:08 +0100
committerChristian Grothoff <christian@grothoff.org>2020-01-17 03:18:08 +0100
commit5e5c8815f01ab30fde53fd3ea50df6e0b1ac8f74 (patch)
treeec207b940e978a2f39a8b18a04cf20d3e46ae494
parent9401b426c6e67f539f03ec98fe7123ae96a3185f (diff)
downloaddocs-5e5c8815f01ab30fde53fd3ea50df6e0b1ac8f74.tar.gz
docs-5e5c8815f01ab30fde53fd3ea50df6e0b1ac8f74.tar.bz2
docs-5e5c8815f01ab30fde53fd3ea50df6e0b1ac8f74.zip
document DB versioning
-rw-r--r--developers-manual.rst17
1 files changed, 17 insertions, 0 deletions
diff --git a/developers-manual.rst b/developers-manual.rst
index 88671ec..0e4c555 100644
--- a/developers-manual.rst
+++ b/developers-manual.rst
@@ -443,6 +443,22 @@ prepared.
$ buildbot-worker start worker/
+Database schema versioning
+--------------------------
+
+The Postgres databases of the exchange and the auditor are versioned.
+See the 0000.sql file in the respective directory for documentation.
+
+Every set of changes to the database schema must be stored in a new
+versioned SQL script. The scripts must have contiguous numbers. After
+any release (or version being deployed to a production or staging
+environment), existing scripts MUST be immutable.
+
+Developers and operators MUST NOT make changes to database schema
+outside of this versioning.
+
+
+
Releases
========
@@ -473,6 +489,7 @@ Tag releases with an **annotated** commit, like
git tag -a v0.1.0 -m "Official release v0.1.0"
git push origin v0.1.0
+
Database for tests
------------------