注意

本文档适用于 Ceph 开发版本。

在 Windows 上挂载 CephFS

ceph-dokan可用于在Windows上挂载CephFS文件系统。

请查看安装指南以开始。

查看当前由 cephadm 使用的文件模板。

挂载文件系统

要挂载Ceph文件系统,可以使用以下命令:

ceph-dokan.exe -c c:\ceph.conf -l x

这将使用驱动器字母x. 挂载默认的Ceph文件系统。ceph.conf放在默认位置,即%ProgramData%\ceph\ceph.conf,则此参数变为可选。

The -l参数还允许使用空文件夹作为挂载点,而不是驱动器字母。

用于挂载文件系统的uid和gid默认为0,可以使用以下ceph.conf选项更改:

[client]
# client_permissions = true
client_mount_uid = 1000
client_mount_gid = 1000

如果您的Ceph集群中有多个文件系统,请使用选项--client_fs挂载非默认文件系统:

mkdir -Force C:\mnt\mycephfs2
ceph-dokan.exe --mountpoint C:\mnt\mycephfs2 --client_fs mycephfs2

当设置--root-path参数:

ceph-dokan -l y --root-path /a

如果未设置-o --removable标志时,CephFS子目录可以挂载,挂载将显示在Get-Volume结果中:

PS C:\> Get-Volume -FriendlyName "Ceph*" | `
        Select-Object -Property @("DriveLetter", "Filesystem", "FilesystemLabel")

DriveLetter Filesystem FilesystemLabel
----------- ---------- ---------------
          Z Ceph       Ceph
          W Ceph       Ceph - new_fs

请使用ceph-dokan --help获取所有参数的完整列表。

凭据

The --id选项传递我们打算用于挂载CephFS的CephX用户的密钥环的名称。以下命令等效:

ceph-dokan --id foo -l x
ceph-dokan --name client.foo -l x

卸载文件系统

可以通过发出ctrl-c或使用unmap命令(如下所示)来移除挂载:

ceph-dokan.exe unmap -l x

注意,在卸载Ceph文件系统时,必须使用与创建映射时完全相同的挂载点参数。

限制

要注意Windows ACL被忽略。Posix ACL受支持,但无法使用当前CLI修改。未来,我们可能会添加一些命令操作来更改文件所有权或权限。

另一个要注意的是,cephfs不支持强制文件锁,而Windows严重依赖于此。目前,我们让Dokan处理文件锁,这些锁仅在本地生效。

rbd-wnbd, ceph-dokan目前不提供service命令。为了让cephfs挂载在主机重启后仍然存在,请考虑使用NSSM.

故障排除

请参考Windows 故障排除页面。

由 Ceph 基金会带给您

Ceph 文档是一个社区资源,由非盈利的 Ceph 基金会资助和托管Ceph Foundation. 如果您想支持这一点和我们的其他工作,请考虑加入现在加入.