注意

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

在 Windows 上挂载 CephFS

使用 ceph-dokan 在 Windows 上挂载 CephFS 文件系统。它利用 Dokany,这是一个 Windows 驱动程序,允许以类似于 FUSE 的方式在用户空间中实现文件系统。

请参阅安装指南以开始使用。

注意

有关客户端软件包支持的信息,请参阅操作系统建议

用法

挂载文件系统

运行以下命令来挂载 Ceph 文件系统

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

此命令使用驱动器号 x 挂载默认的 Ceph 文件系统。如果 ceph.conf 存在于默认位置 (%ProgramData%\ceph\ceph.conf),则此参数是可选的。

-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 参数挂载 CephFS 子目录

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

如果设置了 -o --removable 标志,挂载将显示在 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 以获取完整的参数列表。

凭证

--id 选项传递 CephX 用户的名称,在挂载 CephFS 文件系统时使用其密钥环。以下命令是等效的

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

卸载文件系统 -----------------=-----

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

ceph-dokan.exe unmap -l x

注意

卸载 CephFS 文件系统时,您必须指定创建映射时使用的挂载点参数。

限制

Windows ACL 被忽略。支持 Posix ACL,但不能使用当前的 CLI 进行修改。将来,我们可能会添加更改文件所有权或权限的命令操作。

CephFS 不支持强制文件锁,而 Windows 非常依赖它。Ceph 依赖 Dokan 来处理文件锁,这些锁仅在本地强制执行。

rbd-wnbd 不同,ceph-dokan 不提供 service 命令。要确保 CephFS 挂载在其主机重启后仍然存在,请使用 NSSM

故障排除

请参阅Windows 故障排除页面。

由 Ceph 基金会为您呈现

Ceph 文档是由非营利性 Ceph 基金会 资助和托管的社区资源。如果您希望支持这项工作和我们的其他努力,请考虑 立即加入