About

MAIO - MogileFS All In One for developers ✨🐳✨


About

MAIO - MogileFS All In One provides a way to set up a minimal MogileFS cluster without pain. Tracker, stored and tracker DB are instantiated in a single container. It is suitable for testing and developing scenarios.

Highlight

  • Based on the latest version: MogileFS-Server 2.73 / MogileFS-Utils 2.30 / MogileFS-Network 0.06
  • All in one. No additional dependency.
  • The domain/class is configurable.
  • Quality and compatibility - Continuous test and build against the latest Docker version
  • Contributor friendly - typical contribution process, no weird policies

How to use this image

Starting a MogileFS instance is simple:

$ sudo docker run -t -d -p 7001:7001 -p 7500:7500 --name maio hrchu/mogilefs-all-in-one

That’s it! Now MogileFS is ready to war on port 7001/7500! 😎

You can confirm it by either:

$ echo '!jobs' |nc localhost 7001 
delete count 1
delete desired 1
delete pids 402
fsck count 1
fsck desired 1
fsck pids 405
job_master count 1
job_master desired 1
job_master pids 404
monitor count 1
monitor desired 1
monitor pids 399
queryworker count 5
queryworker desired 5
queryworker pids 406 407 408 409 410
reaper count 1
reaper desired 1
reaper pids 401
replicate count 1
replicate desired 1
replicate pids 403
.

or

$ sudo docker exec -it maio mogadm check
Checking trackers...
  127.0.0.1:7001 ... OK

Checking hosts...
  [ 1] mogilestorage ... OK

Checking devices...
  host device         size(G)    used(G)    free(G)   use%   ob state   I/O%
  ---- ------------ ---------- ---------- ---------- ------ ---------- -----
  [ 1] dev1           478.225     60.039    418.186  12.55%  writeable   N/A
  [ 1] dev2           478.225     60.039    418.186  12.55%  writeable   N/A
  ---- ------------ ---------- ---------- ---------- ------
             total:   956.450    120.078    836.372  12.55%

Caveats

Domain/Class configuration

As shown in the previous example, you can use environment variables to specify MogileFS domain and classes:

$ sudo docker run -t -d -p 7001:7001 -p 7500:7500 -e DOMAIN_NAME=testdomain -e CLASS_NAMES="testclass1 testclass2" --name maio hrchu/mogilefs-all-in-one`

Persistent data store

You can let Docker manage the storage of your data by writing the mysql/mogstored files to disk on the host system using its own internal volume management. In this way, you can recreate the container without lossing data. An example:

$ sudo mkdir -p /opt/maio-mysql/ /opt/mogdata/
$ sudo docker run -t -d -p 7001:7001 -p 7500:7500 -v /opt/mogdata:/var/mogdata -v /opt/maio-mysql:/var/lib/mysql --name maio mogilefs-all-in-one

K8s deployment

We don’t recommand you to use this in production environment. However, it might be suitable to run it on some lightweight k8s alternatives, e.g., k3s, for development use. Ref wiki for example yaml configurations.

Contributing

All contributions are welcome. Nothing else special.

Acknowledgement

The work is based on Jeffutter’s contribution. I enjoy his work for many years. However, he does not maintain it anymore. Besides, he removed all source code, so I decided to build a new one with significant improvements.