Skip to content

nlamirault/marcopolo

Repository files navigation

marcopolo

travis drone Melpa Status MELPA Stable Coverage Status

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 nicolas.lamirault@gmail.com