本页面介绍用来与 Cloud Storage FUSE 交互的 gcsfuse 命令行选项。
摘要
gcsfuse GLOBAL_OPTIONS BUCKET_NAME MOUNT_POINT
其中：
GLOBAL_OPTIONS是用于控制装载的设置方式以及 Cloud Storage FUSE 行为方式的选项。BUCKET_NAME是要装载的存储桶的名称。例如my-mount-bucket。可选。从此命令中排除存储桶名称以执行动态装载。MOUNT_POINT是装载存储桶的本地目录。例如/path/to/mount/point。
说明
gcsfuse CLI 用于将 Cloud Storage 存储桶作为文件系统装载到本地机器上。
全局选项
| 全局选项 | 说明 |
|---|---|
--anonymous-access BOOLEAN |
停用请求的身份验证。如果您使用的自定义端点不支持身份验证，则应设置此标志。如果您将 Cloud Storage FUSE 与公共存储桶搭配使用，也应设置此标志。默认值为 false。 |
--app-name VALUE |
装载的应用名称。 |
--billing-project VALUE |
指定在访问已装载的存储桶时要用于结算的项目。在装载启用了请求者付款功能的存储桶时，此标志通常是必需的。 默认项目为无。 |
--client-protocol VALUE |
指定用于与 Cloud Storage 后端进行通信的协议。该值可以是 http1（对于 HTTP/1.1）或 http2（对于 HTTP/2）。默认值为 http1。 |
--config-file VALUE |
指定要用于配置 Cloud Storage FUSE 行为的配置文件的路径。例如 --config-file /etc/gcsfuse.yaml |
--custom-endpoint VALUE |
指定用于提取数据的备用自定义端点。
自定义端点必须支持与 Cloud Storage JSON 端点 https://storage.googleapis.com/storage/v1 等效的资源和操作。如果未指定自定义端点，Cloud Storage FUSE 会使用全球 Cloud Storage JSON API 端点 https://storage.googleapis.com/storage/v1。如果您指定的自定义端点不支持身份验证，请将 --anonymous-access 标志设置为 true 以绕过身份验证。
|
--debug_fuse_errors |
如果不包含此选项，则求值结果为 False，防止 FUSE 错误记录到控制台（如果使用 --foreground）或日志文件（如果使用 --log-file）中。 |
--debug_fuse |
启用 与 FUSE 相关的调试输出。 如果指定了此选项，日志的严重级别会自动设置为 trace，这包括轨迹日志、调试日志、信息日志、警告日志和错误日志。 |
--debug_gcs |
输出 Cloud Storage 请求和时间信息。 如果指定了此选项，日志的严重级别会自动设置为 trace，这包括轨迹日志、调试日志、信息日志、警告日志和错误日志。 |
--debug-invariants |
违反内部不变时发生崩溃。 |
--debug_mutex |
当互斥锁持续时间过长时，输出调试消息。 如果指定了此选项，日志的严重级别会自动设置为 trace，这包括轨迹日志、调试日志、信息日志、警告日志和错误日志。 |
--dir-mode VALUE |
目录的权限位，以八进制表示。默认值为 755。 |
--enable-nonexistent-type-cache |
如果在 Cloud Storage 中找不到某个文件，则会创建一个类型为 NonexistentType 的类型缓存条目。如果文件是在 Cloud Storage 中创建的，但文件的 NonexistentType 条目已缓存，则在从类型缓存中移除 NonexistentType 条目之前，Cloud Storage FUSE 无法请求该文件。 |
--experimental-enable-json-read |
指定 Cloud Storage FUSE 使用 Cloud Storage JSON API 执行读取操作。默认情况下，读取操作使用 Cloud Storage XML API 执行。 |
--experimental-opentelemetry-collector-address VALUE |
将指标导出到指定地址的 OpenTelemetry 收集器。实验性。 |
--file-mode VALUE |
指定文件的权限位，以八进制表示。默认值为 644。 |
--foreground |
在前台运行 gcsfuse 命令。 |
--gid VALUE |
指定所有 inode 的群组标识符 (GID) 所有者。默认 GID 值为 -1。 |
--help 或 -h |
显示有关 Cloud Storage FUSE 的帮助。 |
--http-client-timeout VALUE |
指定 Cloud Storage FUSE HTTP 客户端在超时之前等待多长时间才能收到来自服务器的响应。默认值为 0s，表示无超时。 |
--implicit-dirs |
如需了解详情，请参阅 GitHub 中的文件和目录文档。 |
--key-file VALUE |
指定用于对发送到 Cloud Storage 的请求进行身份验证的凭据 JSON 密钥文件的绝对路径。默认情况下，Cloud Storage FUSE 使用应用默认凭据对请求进行身份验证。 |
--limit-bytes-per-sec VALUE |
指定供 Cloud Storage FUSE 可从 Cloud Storage 中读取数据的带宽限制（根据 30 秒的时间段计量得出）。默认限制值为 -1，指定无限制。 |
--limit-ops-per-sec VALUE |
指定每秒执行的操作数限制（根据 30 秒的时间段计量得出）。默认限制值为 -1，指定无限制。 |
--log-file VALUE |
指定用于存储可由 Fluentd 解析的日志的文件。如果未提供，则当 Cloud Storage FUSE 在前台运行时，纯文本日志会输出到 stdout；如果 Cloud Storage FUSE 在后台运行，则输出到 syslog。 |
--log-format VALUE |
指定日志文件的格式。值可以是 text 或 json。默认值为 json。 |
--max-conns-per-host VALUE |
指定每个服务器允许的 TCP 连接数上限。此选项在 --client-protocol 设置为 http1 时生效。 默认值为 0，指定 TCP 连接数量不受限制，机器规范设置的限制除外。 |
--max-idle-conns-per-host VALUE |
指定每个服务器允许的空闲连接数上限。默认值为 100。 |
--max-retry-sleep VALUE |
使用指数退避算法指定在重试循环中允许 Cloud Storage FUSE 休眠的时长上限。退避时长超过指定的时长上限后，重试会继续指定的时长上限。默认限制值为 30s（30 秒）。 |
-o VALUE |
指定其他系统特定的装载选项。 FUSE 中的大多数通用装载选项（例如 |
-o ro |
以只读形式装载存储桶。 |
--only-dir VALUE |
仅在存储桶中装载特定目录。 |
--rename-dir-limit VALUE |
允许重命名包含的后代目录少于指定限制的目录。默认限制值为 0。 |
--retry-multiplier VALUE |
指定连续两次重试之间的等待时间。 |
--reuse-token-from-url |
如果包含此选项，则求值结果为 True，指定使用从 --token-url 获取的令牌。如果不包含此选项，则求值结果为 False，指定不应重复使用从 --token-url 获取的令牌。 |
--sequential-read-size-mb VALUE |
指定要从 Cloud Storage 下载的数据的区块大小，以兆字节 (MB) 为单位。 |
--stackdriver-export-interval VALUE |
以指定的时间间隔将指标导出到 Stackdriver。默认值为 0s，指定无导出。 |
--stat-cache-capacity VALUE |
已弃用。指定统计信息缓存可以包含的条目数。这会影响内存消耗量。默认值为 4096。
请使用配置文件中的 metadata-cache: stat-cache max-size 字段（而非此标志）来设置统计信息缓存的最大大小。如需了解详情，请参阅 Cloud Storage FUSE 配置文件。
|
--stat-cache-ttl VALUE |
已弃用。指定缓存 StatObject 结果和 inode 属性的时长。默认值为 60s。
请使用配置文件中的 metadata-cache: ttl-secs 字段（而非此标志）来指定统计信息和类型缓存的元数据条目的存留时间 (TTL)。如需了解详情，请参阅 Cloud Storage FUSE 配置文件。 |
--type-cache-ttl VALUE |
已弃用。指定缓存目录 inode 中的名称与文件或目录之间的映射的时长。默认值为 60s。
请改用 metadata-cache: ttl-secs 字段指定统计信息和类型缓存的元数据条目的存留时间 (TTL)。如需了解详情，请参阅 Cloud Storage FUSE 配置文件。 |
--temp-dir value VALUE |
指定在上传到 Cloud Storage 之前用于暂存写入数据的临时目录的路径。默认值为系统默认值，最有可能是 /tmp。 |
--token-url VALUE |
指定不存在 --key-file 时用于获取访问令牌的网址。 |
--uid VALUE |
指定所有 inode 的用户标识符 (UID) 所有者。默认 UID 值为 -1。 |
--version 或 -v |
显示您已安装的 Cloud Storage FUSE 版本。 |