🍊DFS

Intro

Fiat dfs commands overview

Format command

Users can use the command to format a Fiat DFS. It is based on JuiceFS.

fiat dfs format \
    name-of-dfs \
    --store obs \ # Supported types: [s3|oss|obs|cos|sftp]
    --bucket https://bucket-name.obs.cn-north-4.myhuaweicloud.com \ # bucket domain
    --meta redis://:[email protected]:6379/1 \         # metaengine db url
    --access-key your_access_key \ # access key of your object storage
    --secret-key your_secret_key \ # secret key of your object storage
    --password your_password       # your fiat backend account password

And user also needs to specify relevant Fiat backend information within the fiat.json config -

"server": {
    "host": "https://{you-fiat-backend-host}/fiat",
    "info": {
        "username": "your-user-name",
        "email": "[email protected]"
    }
}

Then we can format our own DFS!

Format a new DFS

For the details of format command, please refer to JuiceFS' official document.

JuiceFS 简介 | JuiceFS Document Centerjuicefs.com

Please check the Object Storage and Metadata Engine configuration sections.

Status command

Users can check their DFSs' status after they have formatted them.

fiat dfs status \
    --meta your-meta-engine-url

Check your pre-configured dfs status

Mount command

Thanks to JuiceFS POSIX compatibility, we can easily mount our pre-configured DFS onto our machines or development container. Here's the command structure -

fiat dfs mount \
    --meta your-metaengine-url \
    --path target-mounting-path

It's as simple as creating a new folder within our local file system! And you can achieve this mounting function of DFS on any FUSE available environment.

Mount our pre-configured DFS onto our development machine!

Un-mount command

To umount a mounted DFS, simply run -

fiat dfs unmount --path your-mounted-path

Umounted a DFS.

Delete command

This is a dangerous command. Please make sure you know what you are doing.

This is the command to destroy a formatted DFS.

fiat dfs delete \
    --meta your-metaengine-url \
    --uuid your-dfs-uuid \ # you can check this info by running 'fiat dfs status'
    --id the-record-id-of-dfs # you can get the record id by accessing the Fiat Dash

Destroy a DFS