Running existing templates with Monk is very straightforward. Running them locally is useful for testing and one-off deployments on single machines.
This short tutorial shows how to run templates locally. We'll run MongoDB on Monk. Make sure you have Monk installed and
monkd running. If not, follow this guide →
There are many templates to choose from, they're all available in the Monk Hub.
To find interesting packages, browse the MonkHub.io GUI, or run:
to see a list of available ones. You can narrow down search with the following arguments:
monk list --help USAGE: monk list [command options] [arguments...] OPTIONS: --runnables, -r (default: false) --groups, -g (default: false) --local, -l (default: false) --help, -h show help (default: false)
In this example we use a MongoDB template published by Monk. It is based on Bitnami's MongoDB container image. You can pick any other template from the available ones of course.
To install MongoDB, simply run:
monk run mongodb/latest
That's it! MongoDB is running on your machine. You can connect to
localhost:27017 and put some data in it.
Let's suppose that a new version of MongoDB came out. The maintainer of
mongodb/latest will update their template to a new version and publish it to the Monk Hub.
In order to update the already running template to its newest available version you just have to do:
monk update mongodb/latest
That's it! The containers will be updated and re-spawned from the newest images, the storage associated with the template will be preserved.
In order to stop the template do:
monk stop mongodb/latest
This will stop the template but it will not touch its storage so if you decide to run
mongodb/latest again, the data will be there.
We have learned how to run, update and stop templates locally and how to browse the available ones. Monk will happily run even the largest system on your laptop if you want but its true value lies in clusters. Move to the next guide to learn how to create a Monk cluster.