Skip to content

Latest commit

 

History

History
94 lines (62 loc) · 2.43 KB

README.fr.rst

File metadata and controls

94 lines (62 loc) · 2.43 KB

dockeb

PyPI

Documentation also available in English

dockeb, la version Keb de Docker.

dockeb peut être utilisé comme remplacement «tel quel» pour l'outil de ligne de commande Docker.

La différence entre docker et dockeb est la génération de noms. Tandis que docker génère un nom de la forme adjectif_nom pour les containers, dockeb génère plutôt un nom Keb aléatoire.

Si par contre un nom est assigné à un container de manière explicite, via l'option --name, celui-ci demeurera inchangé.

Pré-requis

Pour utiliser dockeb, vous aurez besoin de Python ≥ 3.4, ainsi que de Docker.

Pour l'installation, nous recommandons l'utilisation du gestionnaire de paquets pip.

Installation

Pour installer dockeb sur l'ensemble du système, exécutez:

sudo pip3 install dockeb

Pour installer dockeb manuellement à partir du code source, les étapes sont les suivantes:

git clone [email protected]:abusque/dockeb.git
cd dockeb
sudo ./setup.py install

Utilisation

Une fois installé, vous pouvez utiliser qng avec la commande suivante:

qng

Pour une commande plus intéressante, essayez:

dockeb run hello-world
dockeb ps -a

Vous constaterez qu'un nom Keb aléatoire a été assignée au container à sa création.

Pour utiliser dockeb automatiquement au lieu de docker, vous pouvez définir un alias dans la configuration de votre shell:

alias docker='dockeb'
# Pour activer l'auto-complétion si vous utilisez Zsh:
setopt complete_aliases

Développement

Pour développer dockeb localement, vous pouvez utiliser pipenv. Exécutez pipenv install --dev pour générer un environnement virtuel (virtual environment) dans lequel les dépendances seront installées. Vous pouvez ensuite utiliser pipenv shell pour activer cet environnement.

Pour publier de nouvelles versions sur PyPI, nous recommandons l'utilisation de Twine.

Voir aussi

  • qng, le générateur de noms Queb.