Skip to main content

Manage huge sets of Docker images using matrix builds

Project description

Generi logo

📚 Documentation

🐳 About

Generi is a tool to automatically create Dockerfiles and build images for a large combination of different factors. It is the right tool if you need to build many similar images with slightly different parameters.

For example, say you are developing an app. You might want to build one docker image for python 2.7, 3.6, 3.8. And for each python version, you need one with a database included or not. And all that for each tag. If you have experienced a scenario like this, try out Generi.

🎇 Features

  • Configuration in yaml
  • Specify different parameter to form a build matrix
  • Generate Dockerfile for each combination
  • Build all variations of your image with one command
  • Push to the repository of your choice
  • Everything customisable using Jinja

✈️ Quickstart

Generi can be configured using a simple yaml file that defines your matrix build.

schema.yaml

parameters:
  python_version:
    - 2.7
    - 3.5
    - 3.6
    - 3.7
  operating_system:
    - buster
    - alpine

template: templates
output: "output/{{ python_version }}/{{ operating_system }}"
image: "nicklehmann/myapplication:py{{ python_version }}-{{ operating_system }}"

registry:
  username: nicklehmann

templates/Dockerfile

FROM python:{{ python_version }}-{{ operating_system }}

COPY main.py main.py

CMD ["python", "main.py"]

First, render your dockerfiles by running

$ generi write schema.yaml

After that, build and optionally push your image.

$ generi build schema.yaml
$ generi push schema.yaml

For more examples, please see the usage section of the documentation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for generi, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size Generi-0.2.0-py3-none-any.whl (9.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size Generi-0.2.0.tar.gz (7.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page