dockeb

Documentation aussi disponible en français

dockeb, the Keb Docker wrapper.

dockeb can be used as a drop-in replacement for the Docker command-line.

The difference between docker and dockeb is name generation. While docker generates names of the form adjective_surname for containers, dockeb generates a random Keb name.

If you give an explicit name to a container, using the --name flag, it will be left unchanged.

Requirements

To run dockeb, you will need Python ≥ 3.4, as well as Docker.

For installing, we recommend using the pip package manager.

Installing

To install dockeb system-wide, run:

sudo pip3 install dockeb

To install dockeb manually from source, the steps are as follows:

git clone git@github.com:abusque/dockeb.git
cd dockeb
sudo ./setup.py install

Using

Once installed, you can use dockeb by running the following command:

dockeb

For a more interesting command, try:

dockeb run hello-world
dockeb ps -a

You will notice that the container was given a Keb name when created.

To automatically use dockeb instead of docker, consider defining an alias in your shell configuration:

alias docker='dockeb'
# To preserve auto-completions if using Zsh:
setopt complete_aliases

Development

For local development of dockeb, you may use pipenv. Use pipenv install --dev to generate a virtual environment into which the dependencies will be installed. You may then use pipenv shell to activate that environment.

For publishing releases to PyPI, we recommend using Twine.

See Also

• qng, the Queb name generator.