From cf5493c082e613c4fd7d9b8e6417c91a148d7f6b Mon Sep 17 00:00:00 2001 From: Blaine Gardner Date: Tue, 11 May 2021 16:30:54 -0600 Subject: [PATCH] docs: design to block delete of dependent resources Add a design for blocking deletion of Rook-Ceph custom resources whenever there are other resources which refer to them. Signed-off-by: Blaine Gardner --- design/ceph/resource-dependencies.md | 318 ++++++++++++++++++++++++++ design/ceph/resource-dependencies.png | Bin 0 -> 40967 bytes 2 files changed, 318 insertions(+) create mode 100644 design/ceph/resource-dependencies.md create mode 100644 design/ceph/resource-dependencies.png diff --git a/design/ceph/resource-dependencies.md b/design/ceph/resource-dependencies.md new file mode 100644 index 000000000..9d52da16c --- /dev/null +++ b/design/ceph/resource-dependencies.md @@ -0,0 +1,318 @@ +# Resource dependency relationships +**Targeted for v1.7** + +## Goal +Custom Resources in Rook-Ceph can act as data/storage "providers" for other Resources in the +Kubernetes cluster which may be "dependent" on the data/storage provided to them. This dependency +relationship is not codified in Rook, and it is possible for Custom Resources which have dependents +to be deleted, removing the underlying data that dependents need. This leaves those resources +orphaned and could destroy valuable end-user data. + +An example of this is a user needing NFS storage from Rook-Ceph. The user needs to create a +CephCluster. They also need a CephFilesystem. Finally, they need a CephNFS which references the +CephFilesystem. In this example, the CephNFS is dependent on the data pool created by the +CephFilesystem which is in turn dependent on the underlying CephCluster. + +It should not be possible for an administrator to delete the CephFilesystem until the CephNFS +resource is deleted because a user may be using the CephNFS resource. Similarly, it should not be +possible for an administrator to delete the CephCluster while the CephFilesystem exists because the +filesystem could be in use. It is up to the administrator to ensure users no longer need storage +before they delete resources like CephNFS or CephFilesystem. + +The goal of this design is to add safety measures into Rook to help prevent accidental destruction +of end-user data. This design proposes to enable this by tracking resource dependency relationships +and block deletion of any given Rook-Ceph Custom Resource when it is referenced by another resource +in the Kubernetes cluster. + +### Summary of changes + +1. Block deletion of a CephCluster when there are other Rook-Ceph resources in the same namespace +1. Block deletion of a CephBlockPool, CephFilesystem, CephObjectStore, or CephObjectZone when a + CephNFS or CephClient uses one of its pools. +1. Block deletion of a CephObjectStore when there is a user bucket present in the store. + - This allows Rook to block deletion when lib-bucket-provisioner or COSI Bucket resources exist + without having to probe an external API. + - This already has an implementation, but it blocks for unrelated lib-bucket-provisioner OBs. +1. Block deletion of a CephBlockPool or CephFilesystem when there is a PersistentVolume reliant on it. +1. Block deletion of a CephObjectStore when there is a CephObjectStoreUser reliant on it. +1. Block deletion of a CephRBDMirror if a CephBlockPool has mirroring enabled. +1. Block deletion of a CephFilesystemMirror if a CephFilesystem has mirroring enabled. +1. Block deletion of object "multisite" resources with their hierarchy: + CephObjectRealm -> CephObjectZoneGroup -> CephObjectZone -> CephObjectStore + + +## Inventory of resources that could have dependency relationships +All Rook-Ceph CRDs: +- CephCluster +- CephBlockPool +- CephFilesystem +- CephObjectStore +- CephObjectStoreUser +- CephNFS +- CephClient +- CephRBDMirror +- CephFilesystemMirror +- CephObjectRealm +- CephObjectZoneGroup +- CephObjectZone + +Resources for which Rook-Ceph acts as a driver/provisioner: +- ObjectBucket (lib-bucket-provisioner) +- Bucket (COSI) + +Kubernetes resources which can depend on Rook: +- StorageClass (Kubernetes) +- PersistentVolume (Kubernetes) + + +## Proposed dependency relationships +A graph of proposed dependency relationships is shown below with more detail to follow. +![Graph view of resource dependencies](resource-dependencies.png) + +#### `CephCluster` +A CephCluster does not create pools itself, but the Ceph cluster it represents houses pools, and +users can manually create pools using Ceph tooling outside of Kubernetes manifests. It is useful but +not critical to understand which resources interact with pools and in what ways. + +Dependents which can create/delete pools: +- CephBlockPools in the same namespace +- CephFilesystems in the same namespace +- CephObjectStores in the same namespace +- CephObjectZones in the same namespace + +Dependents which can consume arbitrary pools including user-created pools: +- CephNFSes in the same namespace +- CephClients in the same namespace + +Dependents that do not interact with pools: +- CephRBDMirrors in the same namespace +- CephFilesystemMirrors in the same namespace +- CephObjectRealms in the same namespace +- CephObjectZoneGroups in the same namespace + +It is most safe if the `CephCluster` treats all possible Rook-Ceph CRs besides itself as simple +dependents. If a dependent exists in the same namespace, block deletion. In this way, CephCluster +is the most protected provider resource. It also acts as a root for preserving deletion ordering. + +#### `CephBlockPool` +Dependents which can consume this provider's pools: +- CephNFSes in the same namespace that have `spec.pool == ` +- CephClients in the same namespace that have any `spec.caps` value with the string `pool=` + +Dependents via CSI: +- StorageClasses that have: + - `provisioner == .rbd.csi.ceph.com` AND + - `parameters.clusterID == ` AND + - `parameters.pool` OR `parameters.dataPool` references a `CephBlockPool` pool +- PersistentVolumes that have: + - `spec.CSI.Driver` == `.rbd.csi.ceph.com` AND + - `spec.CSI.VolumeAttributes["clusterID"] == ` AND + - `spec.CSI.VolumeAttributes["pool"]` OR `spec.CSI.VolumeAttributes["journalPool"]` references a `CephBlockPool` pool + - OR + - `spec.storageClassName == ` + - NOTE: dependents should continue to be ignored if `spec.cleanupPolicy.allowUninstallWithVolumes == true` + +Dependents via FlexVolume: +- Unnecessary because Rook plans to deprecate FlexVolume support for v1.7 + +#### `CephFilesystem` +Dependents which can consume this provider's pools: +- CephNFSes in the same namespace that have `spec.pool == ` +- CephClients in the same namespace that have any `spec.caps` value with the string `pool=` + +Dependents via CSI: +- StorageClasses that have: + - `provisioner == .cephfs.csi.ceph.com` AND + - `parameters.clusterID == ` AND + - `parameters.pool` OR `parameters.dataPool` references a `CephBlockPool` pool +- PersistentVolumes that have: + - `spec.CSI.Driver` == `.cephfs.csi.ceph.com` AND + - `spec.CSI.VolumeAttributes["clusterID"] == ` AND + - `spec.CSI.VolumeAttributes["pool"]` OR `spec.CSI.VolumeAttributes["journalPool"]` references a `CephBlockPool` pool + - OR + - `spec.storageClassName == ` + - NOTE: dependents should continue to be ignored if `spec.cleanupPolicy.allowUninstallWithVolumes == true` + +Dependents via FlexVolume: +- Unnecessary because Rook plans to deprecate FlexVolume support for v1.7 + +#### `CephObjectStore` +Dependents which can consume this provider's pools: +- CephNFSes in the same namespace that have `spec.pool == ` +- CephClients in the same namespace that have any `spec.caps` value with the string `pool=` + +Dependents which reference this provider by name: +- CephObjectStoreUsers in the same namespace that have `spec.store == ` + +Dependents via lib-bucket-provisioner: +- ObjectBucketClaims that have: + - `spec.endpoint.bucketHost == ..svc` AND + - `spec.endpoint.bucketName == ` + +Dependents via COSI: +- Buckets with a reference to a provider's service and bucket (specific paths TBD by COSI design) + +#### `CephObjectZone`, `CephObjectZoneGroup`, and `CephObjectRealm` +These resources are all part of Rook-Ceph's multi-site object storage strategy. + +`CephObjectZone` creates pools. A zone can be effectively thought of as the "object store" itself. +Dependents which can consume this provider's pools: +- CephObjectStores in the same namespace that have `spec.zone.name == CephObjectZone.metadata.name` +- CephNFS in the same namespace that have `spec.pool = ` +- CephClient in the same namespace that has an `spec.caps` value with the string `pool=` + +`CephObjectRealm` has dependents: +- CephObjectZoneGroups in the same namespace that have `spec.realm == CephObjectRealm.metadata.name` + +`CephObjectZoneGroup` has dependents: +- CephObjectZones in the same namespace that have `spec.zoneGroup == CephObjectZoneGroup.metadata.name` + +#### Mirroring resources +CephRBDMirror has dependents: +- CephBlockPools in the same namespace that have `spec.mirroring.enabled == true` + +CephFilesystemMirror has dependents: +- CephFilesystems in the same namespace that have `spec.mirroring.enabled == true` + + +## Analysis and discussion +### Reusable patterns +We can identify some common metrics for determining whether a resource is a dependent of a given +"provider" resource. Not all metrics are always applicable, but each these metrics appear more than +once. It should be possible to design reusable patterns/methods for reusing logic. +- Is a dependent in the same namespace as the provider? +- Does a dependent reference the current Rook-Ceph operator? +- Does a dependent reference the Ceph cluster namespace of the provider? +- Does the dependent reference pools created by provider? +- Does the dependent reference the provider by name? (e.g., CephObjectZone references CephObjectZoneGroup) + +### User feedback +It will be important for the user to understand why resources are not being deleted if Rook is +blocking the deletion. This design proposes that the Rook operator report to the user when it is +blocking deletion of a resource due to dependents in two ways: +- report it in a status condition of the resource object being deleted +- report a Kubernetes Event ([reference](https://kubernetes.io/blog/2018/01/reporting-errors-using-kubernetes-events/)) + +Using both of these methods will maximize user visibility. + +**Status:** +Reported statuses will be modified as follows: +1. Object's status.phase should be changed to "Deleting" as soon as a deletion timestamp is detected + and never changed +1. A status.condition should be added if the operator is blocking deletion: + - Type: "BlockingDeletion" + - Status: "True" + - Reason: "ObjectHasDependents" + - Message: "object deletion is blocked because it has dependents:" followed by a full list of + which dependents exist of which Kubernetes Object Kinds (e.g., CephBlockPools or + PersistentVolumes) or of which Ceph kinds (e.g., pools or buckets). + +**Event:** +Reported events will have the following content: +- Type: "Warning" +- Reason: "ObjectHasDependents" +- Message: "object deletion is blocked because it has dependents:" followed by a full list of which + dependents exist of which Kubernetes Object Kinds (e.g., CephBlockPools or PersistentVolumes) or + of which Ceph kinds (e.g., pools or buckets). + +### Detecting PersistentVolume dependents +Rook currently inspects Kubernetes PersistentVolume (PV) resources when deleting CephClusters. This +provides protection from deleting the backing Ceph cluster when user applications are using it. + +With the changes proposed here, it would be more specific to block deleting CephBlockPool resources +when there are PVs referencing the specific CephBlockPool. Similarly, it would be more specific to +block deleting CephFilesystem resources when there are PVs referencing the specific CephFilesystem. + +Kubernetes APIs are quite stable, and it is unlikely that the methods Rook uses to inspect +PersistentVolumes will require changes with any regularity. If changes are necessary, Kubernetes +will likely give well over a year of time to migrate away from deprecated API elements. + +Removing a Ceph cluster that is hosting PVs in use by Kubernetes applications could be disastrous +for users. Therefore, this document proposes to continue checking for PersistentVolumes that depend +on Ceph storage. The document further proposes to increase protection of user data by detecting +dependencies for specific CephBlockPools and CephFilesystems when they are deleted rather than +checking when the CephCluster is deleted. Detecting the existence of PVs when the CephCluster is +deleted then becomes redundant and should be removed. + +### Detecting StorageClass dependents +As a note, StorageClasses (SCs) are only used during initial creation of a +PersistentVolume based on the StorageClass. + +It may not be a good idea to block deletion when there are StorageClasses that reference Rook-Ceph +block/file storage. An admin may at times wish to leave StorageClasses +(a more user-focused API point) and replace the Rook-Ceph resources providing the storage +represented by the SC without disturbing users' ability to reference the SC. Any user that tried to +use the StorageClass while the cluster was down would merely fail until a replacement cluster came +online. + +This document outlines the steps needed to treat StorageClasses as a dependent but proposes not to +implement the dependency at this time. If we get more information in the future that provides a +compelling use-case for treating StorageClasses as dependencies, this functionality can be +implemented at that time. + +### Detecting object bucket dependents without querying lib-bucket-provisioner or COSI resources +Detecting lib-bucket-provisioner ObjectBuckets that are dependent on a given CephObjectStore +requires inspecting ObjectBuckets for a reference to a bucket found in the object store as well as a +reference to the address of the Kubernetes Service created for access to RGWs +(`..svc`). Detecting COSI Buckets will be similar. + +This detection does require accessing external APIs (lib-bucket-provisioner and COSI). This is +non-ideal for COSI whose APIs will be progressing from v1alpha1, through beta stages, and then into +v1 in the coming months/years. Rook can merely check for the existence of buckets in order to +support lib-bucket-provisioner and COSI simultaneously with the same code. This would also remove +any need for Rook to update its COSI API for dependency checking though it will still need to +update its API to continue operating as a COSI driver. This would allow Rook to block deletion of +CephObjectStores without care for who has "claimed" a bucket. + +Given that a Kubernetes cluster might have many hundreds of ObjectBuckets, or COSI Buckets, having a +simpler way of querying for dependents can lighten the load on the Kubernetes API server and reduce +Rook's resource usage. + +Since OBs and COSI Buckets both result in buckets being created in a CephObjectStore, Rook can query +the object store and block deletion if buckets exist. + +This is an elegant solution for blocking when buckets are claimed by these outside resources. It +does mean that CephObjectStores that have had buckets created in them directly (by admins or users) +will block until the buckets are manually deleted. An admin may need to request that users remove +unneeded buckets or may instead remove the buckets themselves. + +If the admin wishes to preserve the CephObjectStore's pools on deletion along with their data, the +admin may merely remove the finalizer on the CephObjectStore. + +While this requires more steps to delete the CephObjectStore, it provides additional safety for user +data by requiring users or admins to inspect and clean up unneeded buckets. + +The main downside to this approach is that Rook will not be able to report if there are specific +OBs or COSI Buckets consuming storage from the CephObjectStore. An admin would need to examine the +resources in their cluster to determine if there are claims to the storage manually. A diligent +admin will likely have done this work beforehand. + +This document proposes to implement this strategy to avoid reliance on external APIs. Rook +developers should revisit the decision at a later date to discuss whether the strategy is continuing +to adequately meet users' needs and whether the drawbacks noted are causing any issues. + +### Implementation in stages +This design will result in changes to every major Rook-Ceph controller. However, it should be quite +easy to tackle these changes in stages so that changes can be more easily implemented and reviewed. + +Stages by priority: +1. Block deletion of a CephCluster when there are other Rook-Ceph resources in the same namespace +1. Block deletion of a CephBlockPool, CephFilesystem, CephObjectStore, or CephObjectZone when a CephNFS uses one of its pools. +1. Block deletion of a CephObjectStore when there is a user bucket present in the store. + - This already has an implementation, but it blocks for unrelated OBs +1. Block deletion of a CephBlockPool or CephFilesystem when there is a PersistentVolume reliant on it. +1. Block deletion of a CephObjectStore when there is a CephObjectStoreUser reliant on it. +1. Block deletion of a CephRBDMirror if a CephBlockPool has mirroring enabled, AND + Block deletion of a CephFilesystemMirror if a CephFilesystem has mirroring enabled. + - These are such similar checks that they should be simple to do at the same time. +1. Block deletion of object multisite resources with their hierarchy: + - CephObjectRealm -> CephObjectZoneGroup -> CephObjectZone -> CephObjectStore +1. Block deletion of a CephBlockPool, CephFilesystem, CephObjectStore, or CephObjectZone when a CephClient uses one of its pools. + - CephClients are seldom used, and few users will be affected if this is not in place. + +### Future work +Immediate feedback is always more helpful to users when possible. It should be possible to implement +dependency checks in a validating admission controller quite easily, but we don't currently know if +the controller is able to validate delete requests. This design leaves this investigation for the +future, but implementation of the design can strive to make dependency checking code easily reusable +for the admission controller when work on that might begin. diff --git a/design/ceph/resource-dependencies.png b/design/ceph/resource-dependencies.png new file mode 100644 index 0000000000000000000000000000000000000000..fec032d6195e50412bef7d216420db0c1cdbe943 GIT binary patch literal 40967 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