Build Docker images with custom packages for local development, testing and daily tasks.
Project description
Build Docker images with custom packages
Install vim
and curl
using apt-get
.
docker run -it --rm $(dugaire build --apt=vim,curl)
Install vim
, python3
, pip3
using apt-get
and install ansible
using pip3
.
docker run -it --rm $(dugaire build --apt=vim,python3-pip --pip3=ansible)
Install kubectl
binary version v1.15.0
(use --with-kubectl=latest
to install the latest version).
docker run -it --rm $(dugaire build --apt=vim --with-kubectl=1.15.0)
Do not build the image and just print the Dockerfile:
dugaire build --apt=vim,curl --with-kubectl=latest --output=dockerfile --dry-run
Install (on Linux)
Using pip (recommended)
pip install dugaire
From source
Clone this repository.
git clone https://github.com/tadeugr/dugaire.git
cd
to its directory.
cd dugaire
Install it (requires pip
).
make install
You should have the command available.
dugaire build --help
Enable autocomplete
To enable autocomplete for your current terminal session, run:
eval "$(_DUGAIRE_COMPLETE=source dugaire)"
Follow the instructions bellow to permanently enable autocomplete.
bash
echo 'eval "$(_DUGAIRE_COMPLETE=source dugaire)"' >> ~/.bashrc
zsh
echo 'eval "$(_DUGAIRE_COMPLETE=source dugaire)"' >> ~/.zshrc
Usage
Usage: dugaire build [OPTIONS]
Build Docker images with custom packages.
Examples:
Build an image and install vim and curl using apt-get.
$ dugaire build --apt=vim,curl
Build an image and install python3 using apt-get and ansible using pip3.
$ dugaire build --apt=python3-pip --pip3=ansible
Build an image and install the latest version of kubectl.
$ dugaire build --with-kubectl=latest
Options:
--from <name:tag> Base image (used in Dockerfile FROM).
Example: -f=ubuntu [default: ubuntu:18.04;
required]
--apt <pkg01|pkg01,pkg02> Comma separeted list of packages (no blank
space) to install using apt-get install.
Requires a base image with apt-get. Example:
-apt=curl,vim
--pip3 <pkg01|pkg01,pkg02> Comma separeted list of packages (no blank
space) to install using pip3 install.
WARNING: requires -apt=python3-pip. Example:
-apt=python3-pip -pip3=ansible,jinja2
--with-kubectl <latest|1.15.0 (or other)>
Install kubectl. Examples: --with-
kubectl=latest / --with-kubectl=1.17.0
--name <name:tag> Image name. Example: --name="myimage:0.0.1"
[default: random]
--dry-run Do not build image. [default: False]
--output [image.id|image.id.short|image.name|dockerfile]
Command output options. [default:
image.id.short]
--help Show this message and exit.
Supported features
Base images
Distro | Tested with |
---|---|
ubuntu | ubuntu:16.04 ubuntu:18.04 ubuntu:20.04 |
You may use base images that were built from the tested images.
Package/Dependency managers
-
apt-get
: you can install any package usingapt
. Use a comma separated (no blank space) list of packages you want to install. Example:--apt=wget,iputils-ping
-
pip3
: you can install any package usingpip3
. Use a comma separated (no blank space) list of packages you want to install. Example:--pip3=jinja2,pyyaml
. WARNING to usepip3
you must explicitly installpip3
usingapt
:--apt=python3-pip
.
Packages
kubectl
: use the parameter--with-kubectl=latest
to install the latest version. For specific versions use the following format:--with-kubectl=1.17.0
Useful Docker commands
List images created with dugaire
docker images -f label='builtwith=dugaire'
Delete all images created with dugaire
docker rmi $(docker images -aq -f label='builtwith=dugaire')
Known issues
RuntimeError: Python 3 was configured to use ASCII as encoding for the environment
If you get an error like this one:
RuntimeError: Click will abort further execution because Python 3 was configured to use ASCII as encoding for the environment. Consult https://click.palletsprojects.com/python3/ for mitigation steps.
It is because dugaire
uses Python3 and Click, and according to Click "in Python 3, the encoding detection is done in the interpreter, and on Linux and certain other operating systems, its encoding handling is problematic". Read more.
Solution
Setup your locale correctly, for example if you are using en_US.UTF-8
, run:
apt update && apt-get -y install locales
locale-gen --purge en_US.UTF-8
export LC_ALL="en_US.UTF-8"
export LC_CTYPE="en_US.UTF-8"
# Alternatively you can run:
#sudo dpkg-reconfigure locales
Then you should be able to run dugaire
.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.