Package manager that adds commands from docker images to the host.
Prerequisites: docker, bash, curl, grep.
$ eval "$(curl -fsSL https://raw.githubusercontent.com/guziks/moor/master/install)"
$ moor selfupdate
Lets imagine you want to use asciidoctor-pdf application, but do not want to install all dependencies. Luckily there is an image for that. Here is how it can be installed with moor:
$ moor asciidoctor/docker-asciidoctor ad-pdf asciidoctor-pdf
This will create small launcher $MOORBIN/ad-pdf and finish immediately. This way asciidoctor-pdf is now awailable on the host as ad-pdf. As soon as ad-pdf is launched, docker image will get downloaded and asciidoctor-pdf will get run inside a container. Container runs with --rm option, so when asciidoctor-pdf exits, container is removed.
Updating is a breeze:
$ moor up ad-pdf
When you no longer need an app, just:
$ moor rm ad-pdf
Launcher and corresponding docker image will be removed.
For more usage information see:
$ moor --help
Before installing commands, it is convenient to install shell and explore what it is in that image. Quick way to install shell:
$ moor <image>
This will create launcher <image>-shell which will run bash. If an image does not have bash, you can always install any shell in the usual way, for example:
$ moor node:alpine node-shell ash
Once created, launchers have no dependencies but docker, so they could be copied to other systems and they'll work just fine.
Installed commands run inside a container, so file system access is limited. This directories are available:
- current working directory (determined using
$PWD) - directory specified by
~/$MOORHOME(by default:~/.moor/home)
Note: MOORHOME is part of the path, relative to users HOME.
On Linux, docker network type host is used, so all ports are automatically available. On Mac this type of network is not available, so you need to explicitly make port forwarding while launching installed command:
$ MRUN="-p <port>:<port> [-p <port>:<port> ...]" <cmd> <args>
For example:
$ MRUN="-p 8080:8080" python -m http.server 8080
Notice how docker ports syntax used inside MRUN variable.
You can use MRUN variable to supply any additional docker run options, for example:
$ MRUN="--env URL=http://example.com" node app.js
There must be no spaces inside environmnent variables supplied this way.
TIP: If you need environment variables with spaces inside, use MRUN="--env-file <file-name>".
If installed command or even shell does not work as expected, try to install the command with one or several of these options:
--privileged--keep-user--keep-home--user=<name>
If --keep-user helped then consider installing the command with both --keep-user and --chown options. See moor install --help.