minimesos 0.9.0 – new cli commands, Marathon tokens and Mesos workshop


by Frank Scholten

Apache Mesos

Last week we released minimesos 0.9.0. You can install it using the usual installer command: curl -sSL | sh. The Docker images are available on Docker Hub and the jar is available via Jitpack. Minimesos is the experimentation and testing tool for Apache Mesos and features a Vagrant-like workflow and a Java API. The main highlights of this release are new minimesos ps and minimesos uninstall command and IP address tokens for Marathon JSON files.

New cli commands

minimesos ps

The new minimesos ps command shows what is running on the cluster. It prints the framework, the task name and its state.

minimesos uninstall

Another new command is minimesos uninstall command that allows you to uninstall a Marathon app or framework.

IP tokens for Marathon JSON files

Marathon apps often require URLs or IPs of services that are needed. To simplify this process minimesos replaces tokens in Marathon JSON files with IP addresses or URLs. As an example, see this Marathon JSON file for Elasticsearch. It contains the token MINIMESOS_ZOOKEEPER. This token will be replaced by minimesos with the full Zookeeper url based on the IP of the Zookeeper container.

Note that any environment variable that is printed when running minimesos info can be used as a token inside a Marathon JSON file.

The minimesosFile is now mandatory

Another change we made since 0.9.0 is that the minimesosFile is mandatory for launching a cluster. In the past you could run minimesos up and start a default cluster but now you first have to run minimesos init.

We implemented this change because we wanted to be able to system test every configuration option in the minimesosFile. This was hard to do since most of our system tests used the ClusterArchitecture class which is separate from the configuration. This change makes our tests nice and compact because every system test is started like this:

Learning Mesos with minimesos workshop

Just after we released 0.9.0 Viktor and I organized a Software Circus workshop ‘Learning Mesos with minimesos’ at Container Solutions HQ in Amsterdam. The slide deck and exercises are available at People said they enjoyed the workshop and learned a lot. We also learned and found a few issues and got some ideas on improving minimeos. The weather that day was great so we ended the afternoon with a few beers at the rooftop terrace. Thanks everyone who participated!


Keep in touch

Thanks for reading! Keep in touch by commenting on the blog or talk to us at @minimesos and @ContainerSoluti. Check out the open issues on Github. Do you have an idea on how to improve minimesos? Please open an issue or add a PR at the minimesos Github repo. We hope you find minimesos useful. See you next time!

Leave a Reply

Your email address will not be published. Required fields are marked *