From 995496c99a9aa59ee1a82abd86c17997d9000cfb Mon Sep 17 00:00:00 2001 From: Humble Chirammal Date: Tue, 31 Oct 2023 18:41:51 +0530 Subject: [PATCH] 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 --- docs/intree-migrate.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/intree-migrate.md b/docs/intree-migrate.md index 2ccb39b24d99..ebbb26e0d842 100644 --- a/docs/intree-migrate.md +++ b/docs/intree-migrate.md @@ -1,4 +1,20 @@ -# 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 below suggested method of migration of volumes +provisioned by `kubernetes.io/rbd` provisioner to Ceph CSI provisioner +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