DockerBox

dockerbox is a single executable that runs docker containers based on local and remote run configurations.

Install

go get github.com/beenverifiedinc/dockerbox

Add dockerbox to your path

export PATH=$PATH:$HOME/.dockerbox/bin/

Add a registry.yaml file to $HOME/.dockerbox/registry.yaml

repos:
- name: local
  path: $HOME/.dockerbox/local.yaml
  type: file
- name: example
  path: https://raw.githubusercontent.com/BeenVerifiedInc/dockerbox/master/example/example.yaml
  type: url

add a local config to $HOME/.dockerbox/local.yaml

applets:
  kubectl:
    name: kubectl
    image: beenverifiedinc/kubectl
    image_tag: 1.7.11
    entrypoint: kubectl
    environment:
    - KUBECONFIG=/root/.kube/config
    volumes:
    - $HOME/.kube:/root/.kube
    - $PWD:/app
    work_dir: /app

To update your applet cache ($HOME/.dockerbox/.cache.yaml) from all the repos in the registry run dockerbox update.

To see the list of available applets run dockerbox list

And to install an applet run dockerbox install -i <applet name> or dockerbox install -a to install all available applets. dockerbox installs applets by creating a symlink from $HOME/.dockerbox/<applet name> to the dockerbox binary $GOPATH/bin/dockerbox.

Full applet spec:

• name string
• work_dir string
• entrypoint string
• restart string
• network string
• rm bool (defaults true)
• tty bool (defaults true)
• interactive bool (defaults true)
• privileged bool
• detach bool
• kill bool (kills running container with the same name before running)
• environment list
• volumes list
• ports list
• env_file list
• dependencies list (list of applets to run first)
• links list
• image string
• image_tag string
• command list

Usage

Usage:
  dockerbox [command]

Available Commands:
  help        Help about any command
  install     install docker applet
  list        list all available applets in the repo
  uninstall   uninstall docker applet
  update      update the repo from the registry configs