https://github.com/nick-lehmann/generi

Manage huge sets of Docker images using matrix builds 🐳
https://github.com/nick-lehmann/generi

docker docker-hub docker-image python3

Last synced: about 1 month ago
JSON representation

Manage huge sets of Docker images using matrix builds 🐳

• Host: GitHub
• URL: https://github.com/nick-lehmann/generi
• Owner: nick-lehmann
• License: mit
• Created: 2019-12-21T21:09:43.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-29T15:21:09.000Z (almost 5 years ago)
• Last Synced: 2024-11-14T11:08:04.016Z (about 1 month ago)
• Topics: docker, docker-hub, docker-image, python3
• Language: Python
• Homepage: https://generi.nicklehmann.sh/
• Size: 44.9 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![Generi logo](/docs/images/icon.png?raw=true "Generi logo")

📚 [Documentation](https://generi.nicklehmann.sh/)

🐳 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](https://jinja.palletsprojects.com/en/2.10.x/)

✈️ Quickstart

=============

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

*schema.yaml*

```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*

```dockerfile

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

COPY main.py main.py

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

```

First, render your dockerfiles by running

```bash

$ generi write schema.yaml

```

After that, build and optionally push your image.

```bash

$ generi build schema.yaml

$ generi push schema.yaml

```

For more examples, please see the [usage](https://generi.nicklehmann.sh/usage/usage.html) section of the documentation.