docker.el

Installation

The recommended way to install docker.el is through MELPA.

Otherwise, simply add the files to your load-path and then (require 'docker).

Quickstart

Use M-x docker-images, M-x docker-containers, M-x docker-volumes, M-x docker-networks or M-x docker-machines then mark/unmark items using the following keybindings:

Keymap	Description
`m`	Mark item
`U`	Unmark all
`u`	Unmark item
`t`	Toggle marks
`s`	Sort
`<`	Shrink column
`>`	Enlarge column
`C-c C-e`	Export to csv
`* r`	Mark items by regexp

Press ? to known about available keybindings in order to run actions on these items. Also check out https://github.com/politza/tablist to find more about the marking possibilities.

You can also call the API directly.

Configuration

OSX / docker-machine

The following configuration is required (some of it can probably be simplified by using https://github.com/purcell/exec-path-from-shell).

(setenv "PATH" (concat (getenv "PATH") ":/usr/local/bin"))
(setq exec-path (append exec-path '("/usr/local/bin")))
;; Use "docker-machine env box" command to find out your environment variables
(setenv "DOCKER_TLS_VERIFY" "1")
(setenv "DOCKER_HOST" "tcp://10.11.12.13:2376")
(setenv "DOCKER_CERT_PATH" "/Users/foo/.docker/machine/machines/box")
(setenv "DOCKER_MACHINE_NAME" "box")

Screenshots

images

Commands

docker-global-mode

Running M-x docker-global-mode creates keybindings to the various docker api. The keymap prefix is C-c d by default and can be changed with M-x customize-variable docker-keymap-prefix.

API

command	keymap	description
docker-images	`C-c d i i`	list images
docker-rmi	`C-c d i d`	delete image
docker-pull	`C-c d i f`	pull image
docker-push	`C-c d i p`	push image
docker-run	`C-c d i r`	run image
docker-containers	`C-c d c c`	list containers
docker-rm	`C-c d c d`	delete container
docker-stop	`C-c d c o`	stop container
docker-pause	`C-c d c p`	pause container
docker-restart	`C-c d c r`	restart container
docker-start	`C-c d c s`	start container
docker-unpause	`C-c d c u`	unpause container
docker-volumes	`C-c d v v`	list volumes
docker-volume-rm	`C-c d v d`	delete volume
docker-networks	`C-c d n n`	list networks
docker-network-rm	`C-c d n d`	delete network
dockerfile-build-buffer	`C-c d B`	Build Dockerfile

docker-images

M-x docker-images lists the docker images. After having selected some images, you can do the following actions:

F: pull
P: push
D: rmi
R: run

docker-containers

Running M-x docker-containers lists the docker containers. After having selected some containers, you can do the following actions:

S: start
O: stop
R: restart
P: pause/unpause
I: inspect
L: logs
C: cp
D: rm
d: diff

docker-volumes

Running M-x docker-volumes lists the docker volumes. After having selected some volumes, you can do the following actions:

D: rm

docker-networks

Running M-x docker-networks lists the docker networks. After having selected some networks, you can do the following actions:

D: rm

docker-machine-ls

Running M-x docker-machine-ls lists the docker machines. After having selected some machines, you can do the following actions:

S: start
E: env
O: stop
R: restart
D: rm

Philosophy

This package is inspired by packages like:

dired / ibuffer for selecting images / containers to operate on.
magit for the various actions popups.
projectile for the keymap.

Contributions welcome!

Either as suggestions or as pull requests by opening tickets on the issue tracker.

tzz/docker.el