From ef4fbce57e87f4254d7ce80d417eafb426579666 Mon Sep 17 00:00:00 2001 From: Nicco Date: Sun, 22 Dec 2019 20:02:55 +0100 Subject: [PATCH] Update README.md --- README.md | 54 ++++++++++++++++++++++++++++++++---------------------- 1 file changed, 32 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index edaa14c..b1f7f32 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,45 @@ # tumbo -Docker matrix build generator +Docker matrix build generator. + +The basic idea is that you combine a config file with custom variables with templating (Jinja2) and *__tumbo__* will run your matrix build in docker. + +## 🚀 Quickstart + +###### spec.yml ```yaml variables: - my_var: - - a - - b - - c - some_other: - - 0.1.0 - - 0.1.2 + version: + - 3.11 + - 3.10 + - 3.9 + name: + - Alice + - Bob -context: ./build -recipe: './Dockerfile.j2' -tag: "my-tag:{{ my_var }}-{{ some_other }}" +recipe: ./Dockerfile.j2 -parallel: no -# no -# yes : uses all threads available -# n : number of threads to use -# default: yes - -push: yes run: yes -registry: - username: my_user - password: my_pass - host: my_host +parallel: no ``` +###### Dockerfile.j2 + +``` +FROM alpine:{{ version }} + +CMD [ "echo", "Hi {{ name }} from {{ version }}" ] +``` + +And run + +```sh +tumbo -c spec.yml +``` + +Tumbo will then generate 6 images, build and run them in all the combinations possible with the variables given. + ## 📘 Config Reference ### Variables