Parameters

JUICE module parameters (2 total).

JUICE module has 2 parameters:

juice_cache: shared cache directory
juice_instances: instance definition dict

Parameter Overview

Parameter	Type	Level	Description
`juice_cache`	`path`	`C`	JuiceFS shared cache directory
`juice_instances`	`dict`	`I`	JuiceFS instance definition dict (can be empty)

Level: C = cluster level, I = instance level.

Default Parameters

Defined in roles/juice/defaults/main.yml:

#-----------------------------------------------------------------
# JUICE
#-----------------------------------------------------------------
juice_cache: /data/juice
juice_instances: {}

`juice_cache`

Parameter: juice_cache, type: path, level: C

Shared local cache directory for all JuiceFS instances, default /data/juice. JuiceFS isolates caches by filesystem UUID under this directory.

juice_cache: /data/juice

`juice_instances`

Parameter: juice_instances, type: dict, level: I

Instance definition dict, usually defined at instance level. Default is an empty dict (meaning no instances are deployed). Key is filesystem name, value is instance config object.

juice_instances:
  jfs:
    path: /fs
    meta: postgres://u:p@h:5432/db
    data: --storage postgres --bucket ...
    port: 9567

Instance fields:

Field	Required	Default	Description
`path`	Yes	-	Mount point path
`meta`	Yes	-	Metadata engine URL (PostgreSQL recommended)
`data`	No	`''`	`juicefs format` options (only effective on first creation)
`unit`	No	`juicefs-<name>`	systemd service name
`mount`	No	`''`	Extra `juicefs mount` options
`port`	No	`9567`	Metrics port (unique per node)
`owner`	No	`root`	Mount point owner
`group`	No	`root`	Mount point group
`mode`	No	`0755`	Mount point permissions
`state`	No	`create`	`create` / `absent`

Note

data is only used by juicefs format, it will not update an existing filesystem.
Multiple instances on the same node must use different port values.