nlamirault / marcopolo

An Emacs client to the Docker registry / Hub API

marcopolo

DEPRECATED

See: https://github.com/Silex/docker.el

marcopolo provides :

• a REST client to the Docker registry / Hub API

Name comes from the CMA CGM Marco Polo container ship

Installation

The recommended way to install marcopolo is via MELPA:

M-x package-install marcopolo

or Cask:

(depends-on "marcopolo")

Usage

• Configure marcopolo in Elisp :

    (setq marcopolo-registry-host "https://docker.foobar.com"
          marcopolo-registry-username "xxx"
          marcopolo-registry-password "yyy"
          marcopolo-hub-username "aaa"
          marcopolo-hub-password "bbb")
  

• Or using environment variables :

    $ export DOCKER_REGISTRY_HOST="https://docker.foobar.com"
    $ export DOCKER_REGISTRY_USERNAME="xxx"
    $ export DOCKER_REGISTRY_PASSWORD="yyy"
    $ export DOCKER_HUB_USERNAME="aaa"
    $ export DOCKER_HUB_PASSWORD="bbb"
  

• The API :

    M-x marcopolo-hub-search
  
    M-x marcopolo-registry-search
  

• Keybindings in the marcopolo-mode:

Keybinding	Description
n	Go to next repository
p	Go to previous repository
q	Kill marcopolo buffer

• Some screenshots are available in img directory.

Development

Cask

marcopolo use Cask for dependencies management. Install it and retrieve dependencies :

$ curl -fsSkL https://raw.github.com/cask/cask/master/go | python
$ export PATH="$HOME/.cask/bin:$PATH"
$ cask

Tests

• Launch unit tests from shell:

    $ make clean test
  

• You could use Overseer to launch unit tests from Emacs

Support / Contribute

See here

Changelog

A changelog is available here.

License

See LICENSE.

Contact

Nicolas Lamirault [e-mail]