IMPORTANT: Due to issues with the fuse library, g8ufs should be built with golang v1.8.*. Newer versions of go will cause unexpected issues
0-fs is the fuse file system of Zero-OS.
0-fs can be mounted only using a relatively small meta data database (currently support RocksDB). On accessing
the file it fetches the required file chunks from a remote store, and cache it locally. The idea of using this file system
is to speed up container creation by just mounting the container root from any image metadata file (we call it a flist
file) and once
the container starts, it fetches only the required files from the remote store. So no need to clone large images locally.
The fuse mount point is actually a unionfs
mount of two layers:
- RW (read-write) layer that is just an actual directory on the raw file system of your hard disk
- RO (read-only) layer that is the actual fuse mount point. The read-only layer will download the files into a cache when they are opened for reading the first time
By merging
those 2 layers on top of each other, (read-write on top) the merged mount point will
expose a read-write file system where all file changes, and new files get written to the RW layer,
while reading file operations will be forwarded to the underlaying read-only layer. Once a file is opened
for writing (that is only available on the read-only layer) it will be copied (copy on write) to the
read-write layer and afterwards all read and write operations will be handled directly by the RW layer.
Make sure you have librocksdb
v5.2.1 or higher.
godep restore
make
$ ./g8ufs -h
Usage of ./g8ufs:
-backend string
Working directory of the filesystem (cache and others) (default "/tmp/backend")
-debug
Print debug messages
-meta string
Path to metadata database (rocksdb)
-reset
Reset filesystem on mount
-storage-url string
Storage url (default "ardb://hub.gig.tech:16379")
All documentation is in the /docs
directory, including a table of contents.
In Getting Started with 0-fs you find the recommended path to quickly get up and running.