使用说明
zosfs是一个轻量化工具,无需安装直接执行操作命令即可,以下说明介绍挂载bucket、卸载已挂载bucket等操作。
使用限制
zosfs为特定挂载场景优化,因此存在一定的使用限制,请使用前仔细阅读zosfs使用限制章节,了解工具的限制条件。
注意我们建议您在使用zosfs工具前,了解工具的使用限制,并对工具进行使用测试,避免对您的业务产生影响。
挂载bucket
1.创建 ~/.aws/credentials
文件,内容如下,需填入AccessKey与SecretKey。
[default]
aws_access_key_id = <your-accesskey>
aws_secret_access_key = <your-secretkey>
2.通过zosfs将您的ZOS bucket挂载到指定目录。
zosfs --profile {aksk_group_name} --log-file {logfile_path} --endpoint {endpoint} {bucket_name} {mount_point}
{aksk_group_name}: ~/.aws/credentials中所使用的aksk组名,默认为default
{logfile_path}: 日志文件的保存路径
{endpoint}: 服务端点地址
{bucket_name}: 如果挂载桶,则为“存储桶名称”;如果挂载桶下某目录,则为“存储桶名称:/桶内目录路径”
{mount_point}: 挂载点
示例:
zosfs --profile default --log-file /var/log/zosfs.log --endpoint http://127.0.0.1:8081/ my-bucket /mnt/my-mount-point
zosfs --profile default --log-file /var/log/zosfs.log --endpoint http://127.0.0.1:8081/ my-bucket:/mydir /mnt/my-mount-point
卸载已挂载bucket
1.卸载 zosfs,可以使用以下命令,若由于device busy卸载失败,建议稍后重试,避免数据丢失。
umount {mount_point}
2.执行以下命令可以强制卸载挂载目录。
umount -l {mount_point}
参数说明
S3参数
--endpoint
默认值:无
用途:s3的endpoint,可能值为http://127.0.0.1:8081/
--storage-class
默认值:STANDARD
用途:存储类型
合法值:STANDARD,STANDARD_IA
--profile
默认值:无
用途:使用$HOME/.aws/credentials中的命名配置文件,而不是“default”
合法值:$HOME/.aws/credentials配置文件中写明的aksk组名
--shared-config
默认值:无
用途:使用不同的共享配置文件,而不是$HOME/.aws/credentials和$HOME/.aws/config
--use-content-type
默认值:无
用途:根据文件扩展名和/etc/mime.types设置内容类型,默认关闭
--no-checksum
默认值:无
用途:禁用内容的MD5和SHA256校验和
--acl
默认值:””
用途:要应用于对象的canned ACL。
合法值:"private","public-read","public-read-write","authenticated-read",""
--subdomain
默认值:无
用途:启用S3的子域模式
--skip-cert-verify
默认值:无
用途:控制客户端是否验证服务器的证书链和主机名
Tuning
--memory-limit
默认值:1000
用途:用于数据缓存的最大内存(MB)
合法值:大于等于128的整数
--entry-limit
默认值:100000
用途:内存中缓存的最大元数据条目数(1个条目使用约1KB的内存)
合法值:大于等于10000的整数
--gc-interval
默认值:250
用途:在此数量的数据buffer被分配后强制执行垃圾回收
合法值:非负整数
--single-part
默认值:5
用途:单文件上传的最大大小(MB),如果超过该值则分段上传,不能少于5MB
合法值:5~5120的整数
--part-sizes
默认值:"5:1000,25:1000,125"
用途:分片的大小(MB),s3的总分片数为10000,默认为1000个5MB,1000个25MB,剩余为125MB
--disable-xattr
默认值:无
用途:禁用扩展属性
--stat-cache-ttl
默认值:time.Minute
用途:缓存文件元数据的时间
File system
--o
默认值:无
用途:系统额外的挂载选项
--dir-mode
默认值:0755
用途:目录的权限
--file-mode
默认值:0644
用途:文件的权限
--uid
默认值:当前用户uid
用途:所有inode的uid
--gid
默认值:当前用户gid
用途:所有inode的gid
--setuid
默认值:当前用户uid
用途:放弃当前root权限,设置成uid
--setgid
默认值:当前用户gid
用途:放弃当前root组,设置成gid
Debug
--debug
默认值:无
用途:允许通用的debug输出
--debug_fuse
默认值:无
用途:允许fuse相关的debug输出
--debug_s3
默认值:无
用途:允许s3相关的debug输出
--pprof
默认值:“”
用途:指定“端口”或“主机:端口”以在该端口上启用pprof HTTP分析器
--f
默认值:无
用途:在前台执行zosfs
--log-file
默认值:“”
用途:将日志重定向到文件,“stderr”(前台默认)或“syslog”(后台默认)
--print-stats
默认值:30 * time.Second
用途:I/O统计打印间隔,设置为0以禁用