doc: add/mark the in-tree migration path to deprecation

The in-tree migration path in Kubernetes has been deprecated in v1.28 and this has to be marked in ceph csi docs too. The alternative mechanism to use here is the persistent-volume-migrator Signed-off-by: Humble Chirammal <[email protected]>
ceph · Oct 31, 2023 · ffd2341 · ffd2341
1 parent 879a8d4
commit ffd2341
Showing 1 changed file with 16 additions and 1 deletion.
diff --git a/docs/intree-migrate.md b/docs/intree-migrate.md
@@ -1,4 +1,19 @@
-# In-tree storage plugin to CSI Driver Migration
+
+# In-tree storage plugin to CSI Driver Migration  [DEPRECATED]
+
+:warning: **The functionality mentioned, regarding the migration of
+PVCs (Persistent Volume Claims) from the in-tree provisioner of Kubernetes to
+Ceph CSI Volumes, has been deprecated as of
+[Kubernetes v1.28](https://kubernetes.io/docs/concepts/storage/volumes/#rbd-csi-migration)
+This means that the previously suggested method of migration using
+the `kubernetes.io/rbd` approach is no longer recommended. To assist in
+converting volumes from the old provisioner to Ceph CSI Volumes, a utility
+is available. You can access this utility by visiting
+[this](https://github.com/ceph/persistent-volume-migrator). This utility has
+likely been developed to facilitate the migration process and ensure a smoother
+transition from the deprecated method to Ceph CSI Volumes.> It's essential
+to follow the updated recommendations and utilize the provided utility for
+a successful migration due to the deprecation of the previous method.**
 
 This document covers the example usage of in-tree RBD storage plugin to CSI
 migration feature which can be enabled in a Kubernetes cluster. At present, this