From e8594f43cc70feb0fb0ad420787ec8cf65b2b796 Mon Sep 17 00:00:00 2001 From: zhijian Date: Fri, 16 Sep 2022 15:57:55 +0800 Subject: [PATCH] doc: improve Storj doc (#2775) --- docs/en/guide/how_to_set_up_object_storage.md | 4 ++++ docs/zh_cn/guide/how_to_set_up_object_storage.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/en/guide/how_to_set_up_object_storage.md b/docs/en/guide/how_to_set_up_object_storage.md index 0665b1c68cca..d661cda0e21f 100644 --- a/docs/en/guide/how_to_set_up_object_storage.md +++ b/docs/en/guide/how_to_set_up_object_storage.md @@ -411,6 +411,10 @@ juicefs format \ myjfs ``` +:::caution +Storj DCS [ListObjects](https://github.com/storj/gateway-st/blob/main/docs/s3-compatibility.md#listobjects) API is not fully S3 compatible (result list is not sorted), so some features of juicefs do not work. For example, `juicefs gc`, `juicefs fsck`, `juicefs sync`, `juicefs destroy`. And when using `juicefs mount`, you need to disable [automatic-backup](../administration/metadata_dump_load.md#automatic-backup) function by adding `--backup-meta 0`. +::: + ## Vultr Object Storage Vultr Object Storage is an S3-compatible storage, using `s3` for `--storage` option. The format of the option `--bucket` is `https://..vultrobjects.com/`. For example: diff --git a/docs/zh_cn/guide/how_to_set_up_object_storage.md b/docs/zh_cn/guide/how_to_set_up_object_storage.md index 19c838e7d4db..d479c49757cd 100644 --- a/docs/zh_cn/guide/how_to_set_up_object_storage.md +++ b/docs/zh_cn/guide/how_to_set_up_object_storage.md @@ -411,6 +411,10 @@ juicefs format \ myjfs ``` +:::caution 特别提示 +因为 Storj DCS 的 [ListObjects](https://github.com/storj/gateway-st/blob/main/docs/s3-compatibility.md#listobjects) API 并非完全 S3 兼容（返回结果没有实现排序功能），所以 juicefs 的部分功能无法使用，比如 `juicefs gc`，`juicefs fsck`，`juicefs sync`，`juicefs destroy`。另外，使用 `juicefs mount` 时需要关闭[元数据自动备份](../administration/metadata_dump_load.md#自动备份)功能，即加上 `--backup-meta 0`。 +::: + ## Vultr 对象存储 Vultr 的对象存储兼容 S3 API，存储类型使用 `s3`，`--bucket` 格式为 `https://..vultrobjects.com/`。例如：