在 Docker 中使用 JuiceFS

最简单的用法是卷映射，在宿主机上挂载 JuiceFS，然后映射进容器里即可，假定挂载点为 /jfs：

docker run -d --name nginx \
  -v /jfs/html:/usr/share/nginx/html \
  -p 8080:80 \
  nginx

如果你对挂载管理有着更高的要求，比如希望通过 Docker 来管理挂载点，方便不同的应用容器使用不同的 JuiceFS 文件系统，还可以通过卷插件（Docker volume plugin）与 Docker 引擎集成。

卷插件

在 Docker 中，插件也是一个容器镜像，JuiceFS 卷插件镜像中内置了 JuiceFS 社区版以及 JuiceFS 云服务客户端，安装以后，便能够运行卷插件，在 Docker 中创建 JuiceFS Volume。

通过下面的命令安装插件，按照提示为 FUSE 提供必要的权限：

docker plugin install juicedata/juicefs

你可以使用以下命令管理卷插件：

# 停用插件
docker plugin disable juicedata/juicefs

# 升级插件（需先停用）
docker plugin upgrade juicedata/juicefs
docker plugin enable juicedata/juicefs

# 卸载插件
docker plugin rm juicedata/juicefs

创建 Volume

创建新的 Volume 时需要提供 JuiceFS 文件系统名称、密钥以及对象存储的访问凭据（如果不确定从哪里获取这些认证信息，可以重温创建文件系统），例如：

docker volume create -d juicedata/juicefs \
  -o name=$VOL_NAME -o token=$JFS_TOKEN \
  -o accesskey=$ACCESS_KEY -o secretkey=$SECRET_KEY jfsvolume

如果需要在认证、挂载文件系统时传入额外的环境变量（比如 Google Cloud Platform），可以对上方命令追加类似 -o env=FOO=bar,SPAM=egg 的参数。

使用和管理存储卷

# 创建容器时挂载卷
docker run -it -v jfsvolume:/opt busybox ls /opt

# 删除存储卷，注意这仅仅是删除 Docker 中的对应资源，并不影响 JuiceFS 中存储的数据
docker volume rm jfsvolume

通过 Docker Compose 挂载

下面是使用 docker-compose 挂载 JuiceFS 文件系统的例子：

version: '3'
services:
busybox:
  image: busybox
  command: "ls /jfs"
  volumes:
    - jfsvolume:/jfs
volumes:
  jfsvolume:
    driver: juicedata/juicefs
    driver_opts:
      name: ${VOL_NAME}
      token: ${JFS_TOKEN}
      access-key: ${ACCESS_KEY}
      secret-key: ${SECRET_KEY}
      # 如有需要，可以用 env 传入额外环境变量
      # env: FOO=bar,SPAM=egg

配置文件撰写完毕，可以通过下方命令创建和管理：

docker-compose up

# 关闭服务并从 Docker 中卸载 JuiceFS 文件系统
docker-compose down --volumes

在 Docker Swarm 中使用

JuiceFS 文件系统支持多节点的 Docker Swarm 集群。你需要确保 juicedata/juicefs 插件在所有工作节点上安装并启用。

JuiceFS 的挂载参数通过 --mount 指定，如下面的例子所示。

docker service create --name nginx --mount \
  type=volume,volume-driver=juicedata/juicefs,source=jfsvolume,destination=/jfs, \
  volume-opt=name=$VOL_NAME,volume-opt=token=$JFS_TOKEN,volume-opt=accesskey=$ACCESS_KEY,volume-opt=secretkey=$SECRET_KEY nginx:alpine

排查

无法正常工作时，推荐先升级卷插件，然后根据问题情况查看日志。

• 收集 JuiceFS 客户端日志，日志位于 Docker 卷插件容器内，需要进入容器采集：

  # 确认 docker plugins runtime 目录，根据实际情况可能与下方示范不同
  # ls 打印出来的目录就是容器目录，名称为容器 ID
  ls /run/docker/plugins/runtime-root/plugins.moby
  
  # 打印 plugin 容器信息
  # 如果打印出的容器列表为空，说明 plugin 容器创建失败
  # 阅读下方查看 plugin 启动日志继续排查
  runc --root /run/docker/plugins/runtime-root/plugins.moby list
  
  # 进入容器，打印日志
  runc --root /run/docker/plugins/runtime-root/plugins.moby exec 452d2c0cf3fd45e73a93a2f2b00d03ed28dd2bc0c58669cca9d4039e8866f99f cat /var/log/juicefs.log

  如果发现容器不存在（ls 发现目录为空），或者在最后打印日志的阶段发现 juicefs.log 不存在，那么多半是挂载本身就失败了，继续查看 plugin 自身的日志寻找原因。

• 收集 plugin 日志，以 systemd 为例：

  journalctl -f -u docker | grep "plugin="

  如果 plugin 调用 juicefs 发生错误，或者 plugin 自身报错，均会在日志里有所体现。