From 075e2210b021475181f133783f8ab51118a32464 Mon Sep 17 00:00:00 2001
From: Justin Farmiloe <jfarmiloe@gitlab.com>
Date: Tue, 20 Sep 2022 06:44:39 +0000
Subject: [PATCH] Add note on external diff storage type change

---
 doc/administration/merge_request_diffs.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/administration/merge_request_diffs.md b/doc/administration/merge_request_diffs.md
index fe1c74b0e247b..fd0991b1771aa 100644
--- a/doc/administration/merge_request_diffs.md
+++ b/doc/administration/merge_request_diffs.md
@@ -271,3 +271,11 @@ By default, `sudo` does not preserve existing environment variables. You should
 ```shell
 sudo gitlab-rake gitlab:external_diffs:force_object_storage START_ID=59946109 END_ID=59946109 UPDATE_DELAY=5
 ```
+
+## Switching from external storage to object storage
+
+Automatic migration moves diffs stored in the database, but it does not move diffs between storage types.
+To switch from external storage to object storage:
+
+1. Move files stored on local or NFS storage to object storage manually.
+1. Run the Rake task in the [previous section](#correcting-incorrectly-migrated-diffs) to change their location in the database.
-- 
GitLab