How to deploy JuiceFS¶

JuiceFS is quite easy to deploy with the following steps:

Create a file system in juicefs web console
Download juicefs command line tool
Mount juicefs file system

You may do it manually following the [Getting Started](./getting_started.html) guide.

Alternatively, you may automate it with DevOps tools such as Ansible, Salt and etc.

Manual¶

Use the following command to download and mount JuiceFS.

curl -L juicefs.com/static/juicefs -o juicefs && chmod +x juicefs
sudo ./juicefs auth --token $JFS_TOKEN --accesskey $ACCESSKEY --secretkey $SECRETKEY $JFS_NAME
sudo ./juicefs mount $JFS_NAME $JFS_MOUNTPONT

Add a line to /etc/fstab so that it will be mounted automatically after booting. For example:

JFS_NAME  /jfs     juicefs    _netdev   0 0

Note

By default, CentOS 6 will NOT mount network filesystem after boot, run sudo chkconfig --add netfs to enable it.

Using Shell Script¶

#!/bin/sh
cd /tmp
curl -L juicefs.com/static/juicefs -o juicefs && chmod +x juicefs
sudo ./juicefs auth "$1" --token "$2" --accesskey "$3" --secretkey "$4"
sudo ./juicefs mount "$1" "$5"

Save the above content as a shell script setup-juicefs.sh and mount JuiceFS with one-line command:

./setup-juicefs.sh $JFS_NAME $JFS_TOKEN $ACCESSKEY $SECRETKEY $JFS_MOUNTPONT

Note

For environment that does not require accesskey or secretkey, e.g. using AWS IAM role for authentication, put a placeholder '' for the corresponding arguments.

Using Salt¶

Example state snippets to deploy JuiceFS with Salt.

/root/juicefs:
    file.managed:
        - source: https://juicefs.com/static/juicefs
        - mode:  0755
        - skip_verify: True

juicefs auth:
    cmd.run:
        - name: /root/juicefs auth {{jfs_name}} --token {{jfs_token}} --accesskey={{accesskey}} --secretkey={{secretkey}}
        - creates: /root/.juicefs/{{jfs_name}}.conf
    require:
        - file: /root/juicefs

/jfs:
    mount.mounted:
        - device: {{jfs_name}}
        - fstype: juicefs
        - mkmnt: True
        - opts: _netdev
        - device_name_regex:
            - JuiceFS:{{jfs_name}}
    require:
        - cmd: juicefs auth

Note

juicefs command line tool will automatically add prefix JuiceFS: to the device name. Therefore, you need to apply a regex match for it.

Using Ansible¶

Example for mounting JuiceFS on localhost using Ansible playbook

- hosts: localhost
  tasks:
    - set_fact:
        jfs_bin: /usr/local/bin/juicefs

    - get_url:
        url: https://juicefs.com/static/juicefs
        mode: 0755
        dest: "{{jfs_bin}}

    - command: {{jfs_bin}} auth {{jfs_name}} --token {{jfs_token}} --accesskey={{accesskey}} --secretkey={{secretkey}}
      args:
        creates: /root/.juicefs/{{jfs_name}}.conf

    - mount:
        path: "{{jfs_path}}"
        src: "{{jfs_name}}"
        fstype: juicefs
        opts: _netdev
        state: mounted