aboutsummaryrefslogtreecommitdiffstats
path: root/ops
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2022-08-19 12:53:25 +0200
committerDrew DeVault <sir@cmpwn.com>2022-08-19 12:53:25 +0200
commitf7d936f618d8727e97ebde18b4fad96097e60161 (patch)
tree228e4911b00084514793d8b4754117fd5e59255b /ops
parentd2d21535c5df0476d2ca96425057d5566f78211a (diff)
downloadsr.ht-docs-f7d936f618d8727e97ebde18b4fad96097e60161.tar.gz
Improve ID unification process
Diffstat (limited to 'ops')
-rw-r--r--ops/id-unification.md24
1 files changed, 20 insertions, 4 deletions
diff --git a/ops/id-unification.md b/ops/id-unification.md
index b0a7c65..4e08e1a 100644
--- a/ops/id-unification.md
+++ b/ops/id-unification.md
@@ -17,20 +17,36 @@ third-party instances.
## Upgrade process
+For meta.sr.ht:
+
+1. Disable automatic migrations
+1. Upgrade meta.sr.ht, restart the services, and ensure that the meta.sr.ht
+ GraphQL API is online
+1. Re-enable automatic migrations if desired
+
+Then, for each service, one at a time:
+
1. Disable automatic migrations
-1. Upgrade meta.sr.ht and ensure that the meta.sr.ht GraphQL API is online
-1. Upgrade remaining services
+1. Shut off the service
+1. Run upgrades
1. Run `$service-migrate upgrade head` (e.g. gitsrht-migrate) for each service
and monitor the migration progress
+1. Turn on the service
1. Re-enable automatic migrations if desired
## Downgrade process
1. Disable automatic migrations
-1. Downgrade meta.sr.ht
-1. Downgrade remaining services
+1. Downgrade meta.sr.ht and restart the services
+
+Then, for each service, one at a time:
+
+1. Shut off the service
+1. Downgrade the software
1. Run `$service-migrate downgrade $version`, selecting $version from the list
below, for each service
+1. Turn on the service
+1. Re-enable automatic migrations if desired
## Affected database schema revisions