openeuler/3fs repository overview

⁠Quick reference

• The official Fire-Flyer File System (3FS) docker image.

• Maintained by: openEuler CloudNative SIG⁠.

• Where to get help: openEuler CloudNative SIG⁠, openEuler⁠.

⁠Fire-Flyer File System (3FS) | openEuler

Current 3FS docker images are built on the openEuler⁠. This repository is free to use and exempted from per-user rate limits.

The Fire-Flyer File System (3FS) is a high-performance distributed file system designed by DeepSeek to address the challenges of AI training and inference workloads. It leverages modern SSDs and RDMA networks to provide a shared storage layer.

Learn more on 3FS Documentation⁠.

⁠Supported tags and respective Dockerfile links

The tag of each 3fs docker image is consist of the version of 3fs and the version of basic image. The details are as follows

⁠Usage

In this usage, users can select the corresponding {Tag} based on their requirements.

• Pull the openeuler/3fs image from docker

  docker pull openeuler/3fs:{Tag}
  

  Copy

• View available 3fs binaries

  docker run --rm openeuler/3fs:{Tag} ls /opt/3fs/bin/
  

  Copy

• Start a 3fs management service (mgmtd)

  docker run -d \
  	--name 3fs-mgmtd \
  	-p 8000:8000 \
  	-v /path/to/config:/opt/3fs/etc \
  	-v /path/to/logs:/var/log/3fs \
  	openeuler/3fs:{Tag}
  

  Copy

• Start a 3fs metadata service

  docker run -d \
  	--name 3fs-meta \
  	-v /path/to/config:/opt/3fs/etc \
  	openeuler/3fs:{Tag} \
  	/opt/3fs/bin/meta_main --cfg /opt/3fs/etc/meta_main_launcher.toml
  

  Copy

• Start a 3fs storage service

  docker run -d \
  	--name 3fs-storage \
  	-v /path/to/config:/opt/3fs/etc \
  	-v /path/to/data:/opt/3fs/data \
  	openeuler/3fs:{Tag} \
  	/opt/3fs/bin/storage_main --cfg /opt/3fs/etc/storage_main_launcher.toml
  

  Copy

• Check container logs

  docker logs -f 3fs-mgmtd
  

  Copy

• Access container shell

  docker exec -it 3fs-mgmtd /bin/bash
  

  Copy

The configuration files (mgmtd_main_launcher.toml, meta_main_launcher.toml, storage_main_launcher.toml, fdb.cluster) must be prepared and mounted to /opt/3fs/etc before starting the services.

⁠Question and answering

If you have any questions or want to use some special features, please submit an issue or a pull request on openeuler-docker-images⁠.