[pve-devel] [PATCH docs v2 6/6] pveceph: add section for rbd namespaces

[Aaron Lauterer]

thanks. I can send a follow-up if the rest of the series does not 
require a v3

On  2025-01-02  14:46, Alexander Zeidler wrote:
> On Mon Dec 23, 2024 at 5:00 PM CET, Aaron Lauterer wrote:
>> and a few basic examples on how to manage them.
>>
>> Signed-off-by: Aaron Lauterer <a.lauterer at proxmox.com>
>> ---
>> changes since v1: none
>>
>>   pveceph.adoc | 41 +++++++++++++++++++++++++++++++++++++++++
>>   1 file changed, 41 insertions(+)
>>
>> diff --git a/pveceph.adoc b/pveceph.adoc
>> index da39e7f..a90a6e1 100644
>> --- a/pveceph.adoc
>> +++ b/pveceph.adoc
>> @@ -760,6 +760,47 @@ You can find a more in-depth introduction to the PG autoscaler on Ceph's Blog -
>>   https://ceph.io/rados/new-in-nautilus-pg-merging-and-autotuning/[New in
>>   Nautilus: PG merging and autotuning].
>>   
>> +[[pve_ceph_rbd_namespaces]]
>> +RBD Namespaces
>> +~~~~~~~~~~~~~~
>> +
>> +Namespaces in the rados block device (RBD) layer can be used to have multiple
>> +Proxmox VE clusters using the same pool, but still be logically separated.
> {pve}
> 
>> +Namespaces can be managed in the web UI in the 'Node -> Ceph -> Pools' panel.
>> +
>> +Alternatively, the `pveceph` or Ceph's `rbd` footnote:[https://docs.ceph.com/en/latest/man/8/rbd/]
>> +utility can be used too. To list all RBD namespaces of the pool `vmstore`, run the
>> +following command:
>> +[source, bash]
>> +----
>> +pveceph pool namespace ls vmstore
>> +----
>> +The result will be for example:
>> +[source, bash]
>> +----
>> +┌───────────┐
>> +│ Namespace │
>> +╞═══════════╡
>> +│ bar       │
>> +├───────────┤
>> +│ foo       │
>> +└───────────┘
>> +----
>> +
>> +To create a new RBD namespace `baz` in the pool `vmstore`, run:
>> +[source, bash]
>> +----
>> +pveceph pool namespace create vmstore baz --add-storage 1
>> +----
>> +The `--add-storage` parameter is optional an when set, will create a new
> s/an/and/
> 
>> +storage configuration with the new namespace.
>> +
>> +To delete the `baz` RBD namespace in pool `vmstore`:
> Maybe:
> To delete the empty `baz` RBD namespace in pool `vmstore`, run:
> 
>> +[source, bash]
>> +----
>> +pveceph pool namespace destroy vmstore baz
>> +----
>> +
>>   
>>   [[pve_ceph_device_classes]]
>>   Ceph CRUSH & device classes
> 
> 
> 
> _______________________________________________
> pve-devel mailing list
> pve-devel at lists.proxmox.com
> https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel