docs: Add docs for migrating to older version

this patch adds documentation for migrating to a older version of Nebraska. Signed-off-by: Santhosh Nagaraj S <[email protected]>
flatcar · May 25, 2022 · 316bb53 · 316bb53
1 parent 6d9064a
commit 316bb53
Showing 1 changed file with 21 additions and 0 deletions.
diff --git a/docs/migrate-to-older-version.md b/docs/migrate-to-older-version.md
@@ -0,0 +1,21 @@
+---
+title: Migrating to older version of Nebraska.
+weight: 11
+---
+
+
+When migrating down to an older version of Nebraska one might have to rollback database migrations that were applied as a part of the release. 
+
+First get the migrations that were part of the version that you want to downgrade to using the following command. 
+
+> git show <NEBRASKA-VERSION>:./backend/pkg/api/db/migrations | tail -n1
+
+For example to find the migrations that were part of `2.4.0` release clone the Nebraska repo and run.
+
+> git show 2.4.0:../backend/pkg/api/db/migrations | tail -n1
+>
+> 0013_add_stats_indexes.sql
+
+To rollback to 0013_add_stats_indexes.sql use the following command
+
+> /nebraska/nebraska --migrate-down-to 0013