From 74a522774b34a72d627d294255f581b28e2947cc 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 2ccb39b24d9..164b9a264ff 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 +been developed to facilitate the migration process and ensure a smoother +transition from in-tree and flex provisioner volumes to Ceph CSI provisioner +Volumes. It's essential to follow the updated recommendations and utilize +the provided utility for a successful migration due to the deprecation of +the method described in this document.** 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