from contextlib import contextmanager from .template import SubvolumeOpType from .versions import loaded_subvolumes def create_subvol(mgr, fs, vol_spec, group, subvolname, size, isolate_nspace, pool, mode, uid, gid): """ create a subvolume (create a subvolume with the max known version). :param fs: ceph filesystem handle :param vol_spec: volume specification :param group: group object for the subvolume :param size: In bytes, or None for no size limit :param isolate_nspace: If true, use separate RADOS namespace for this subvolume :param pool: the RADOS pool where the data objects of the subvolumes will be stored :param mode: the user permissions :param uid: the user identifier :param gid: the group identifier :return: None """ subvolume = loaded_subvolumes.get_subvolume_object_max(mgr, fs, vol_spec, group, subvolname) subvolume.create(size, isolate_nspace, pool, mode, uid, gid) def create_clone(mgr, fs, vol_spec, group, subvolname, pool, source_volume, source_subvolume, snapname): """ create a cloned subvolume. :param fs: ceph filesystem handle :param vol_spec: volume specification :param group: group object for the clone :param subvolname: clone subvolume nam :param pool: the RADOS pool where the data objects of the cloned subvolume will be stored :param source_volume: source subvolumes volume name :param source_subvolume: source (parent) subvolume object :param snapname: source subvolume snapshot :return None """ subvolume = loaded_subvolumes.get_subvolume_object_max(mgr, fs, vol_spec, group, subvolname) subvolume.create_clone(pool, source_volume, source_subvolume, snapname) def remove_subvol(mgr, fs, vol_spec, group, subvolname, force=False, retainsnaps=False): """ remove a subvolume. :param fs: ceph filesystem handle :param vol_spec: volume specification :param group: group object for the subvolume :param subvolname: subvolume name :param force: force remove subvolumes :return: None """ op_type = SubvolumeOpType.REMOVE if not force else SubvolumeOpType.REMOVE_FORCE with open_subvol(mgr, fs, vol_spec, group, subvolname, op_type) as subvolume: subvolume.remove(retainsnaps) @contextmanager def open_subvol(mgr, fs, vol_spec, group, subvolname, op_type): """ open a subvolume. This API is to be used as a context manager. :param fs: ceph filesystem handle :param vol_spec: volume specification :param group: group object for the subvolume :param subvolname: subvolume name :param op_type: operation type for which subvolume is being opened :return: yields a subvolume object (subclass of SubvolumeTemplate) """ subvolume = loaded_subvolumes.get_subvolume_object(mgr, fs, vol_spec, group, subvolname) subvolume.open(op_type) yield subvolume