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.
To run dockeb, you will need Python ≥ 3.4, as well as Docker.
For installing, we recommend using the pip
package manager.
To install dockeb system-wide, run:
sudo pip3 install dockeb
To install dockeb manually from source, the steps are as follows:
git clone [email protected]:abusque/dockeb.git
cd dockeb
sudo ./setup.py install
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
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.
- qng, the Queb name generator.