Home

Awesome

zsh-docker-run

Run commands naturally, forgetting all about Docker

Run commands "naturally" without having them installed, using Docker.

Why?

As we adopt Docker more, we install a whole lot less on our machines. Instead of installing node, php, ruby - we pull their latest Docker images. This means that simple commands, such as npm install and irb become more cumbersome, such as:

docker run --rm -it --entrypoint=irb ruby:latest

It'd be much better if we could work as we used to, keeping our simple commands. Your first thought might be "use an alias" ... but we want to be better than that. What if we're inside of a project that's using docker-compose and we want to update our node packages?

Normally, this is just npm update; but instead, we now need to use docker-compose run --rm node npm update

Using this plugin, we can detect these situations for you. Go back to using npm update. Just add a simple function and call run_with_docker :smile:

How?

Install this plugin with your favourite zsh plugin manager, I use zplug:

# For zplug
zplug "rawkode/zsh-docker-run"

Now all you need to-do is add some functions to your .zshrc file:

function example {
  run_with_docker "image_name" "image_tag" "command" $@
}

function npm {
  run_with_docker "node" "alpine" "npm" $@
}

More Examples

function elixir() {
  run_with_docker "elixir" "latest" "elixir" $@
}

function iex() {
  run_with_docker "elixir" "latest" "iex" $@
}

function mix() {
  run_with_docker "elixir" "latest" "mix" $@
}

function go() {
  run_with_docker "golang" "latest" "go" $@
}

function php() {
  run_with_docker "php" "latest" "php" $@
}

What's Next?