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 20, 2022 · 55bde83 · 55bde83
1 parent 9f6a75f
commit 55bde83
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 introduced as a part of the last release using the following command.
+
+> git show <NEBRASKA-VERSION>:./backend/pkg/api/db/migrations | tail -n1
+
+For example to find the migrations that were introduced as 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 0012 which is one migration less than the one introduced in the 2.4.0 release run Nebraska with the `--migrate-down-to` argument.
+
+> /nebraska/nebraska --migrate-down-to 0012