本页面介绍了如何使用 Cloud Storage FUSE 配置文件以永久性的方式配置 Cloud Storage FUSE 的行为。如需使用配置文件,请在装载命令的 --config-file
标志中指定配置文件的路径。
配置文件是一个 YAML 文件,使用以下格式和字段。部分字段还可使用命令行选项指定。
write: create-empty-file: boolean logging: file-path: "string" format: enum severity: enum log-rotate: max-file-size-mb: integer backup-file-count: integer compress: boolean file-cache: max-size-mb: integer cache-file-for-range-read: boolean metadata-cache: stat-cache-max-size-mb: integer ttl-secs: integer type-cache-max-size-mb: integer cache-dir: integer
配置字段
下表介绍了您可以在配置文件中指定的字段。除非另有说明,否则所有字段均为可选字段。
字段 | 说明 |
---|---|
create-empty-file |
一个布尔值,用于指定在开始向装载的存储桶中的新文件写入数据时,是否在 Cloud Storage 中创建零字节文件。如果未指定此字段,则值默认为 false 。 |
file-path |
日志写入的日志文件的路径,以字符串形式指定。例如 /var/log 。如果未指定此字段,则当 Cloud Storage FUSE 在前台模式下运行时,日志会路由到 stdout;当 Cloud Storage FUSE 在后台模式下运行时,日志会路由到 syslogs。 |
format |
生成日志的格式,以枚举表示。
值为 text 或 json 。如果未指定此字段,则值默认为 json 。 |
severity |
您希望 Cloud Storage FUSE 生成的日志的严重级别,以枚举表示。严重级别按照从最低严重级别到最高严重级别的顺序排列:
指定严重级别时,Cloud Storage FUSE 会生成严重级别相同或更高的日志。例如,如果指定
如果未指定此字段,则值默认为 |
max-file-size-mb |
日志文件在轮替之前可以达到的大小上限,以兆字节 (MB) 为单位。最小值为 1 。如果未指定此字段,则值默认为 512 。 |
backup-file-count |
要保留的轮替日志文件数上限,不包括日志写入的活跃文件。如果该值设置为 0 ,则系统会保留所有轮替的日志文件。如果未指定此字段,则值默认为 10 。 |
compress |
一个布尔值,用于指定是否使用 gzip 压缩轮替的日志文件。如果未指定此字段,则值默认为 true 。 |
max-size-mb |
文件缓存可以使用的大小上限(以 MiB 为单位)。
如果未指定此字段,则值默认为 |
cache-file-for-range-read |
一个布尔值,用于确定在从非零偏移处完成首次读取时,是否应异步下载完整对象并将其存储在 Cloud Storage FUSE 缓存目录中。如果您计划执行多次随机读取或部分读取,则应将其设置为 请注意,如果您从偏移量 |
stat-cache-max-size-mb |
统计信息缓存可以使用的大小上限(以 MiB 为单位)。统计信息缓存始终完全保留在内存中。
如果未指定此字段,则值默认为 |
ttl-secs |
定义缓存的元数据条目的存留时间 (TTL)(以秒为单位)。
如果未指定此字段,则值默认为 |
type-cache-max-size-mb |
类型缓存可以使用的每个目录的大小上限(以 MiB 为单位)。 类型缓存始终完全保留在内存中。
如果未指定此字段,则值默认为 |
cache-dir |
指定用于存储文件缓存数据的目录。必须指定此字段才能启用文件缓存。 |