{"id":14979007,"url":"https://github.com/nick-lehmann/generi","last_synced_at":"2026-03-05T22:07:55.791Z","repository":{"id":57433527,"uuid":"229483507","full_name":"nick-lehmann/Generi","owner":"nick-lehmann","description":"Manage huge sets of Docker images using matrix builds 🐳","archived":false,"fork":false,"pushed_at":"2019-12-29T15:21:09.000Z","size":46,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-01-14T04:08:36.766Z","etag":null,"topics":["docker","docker-hub","docker-image","python3"],"latest_commit_sha":null,"homepage":"https://generi.nicklehmann.sh/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nick-lehmann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-12-21T21:09:43.000Z","updated_at":"2019-12-29T15:21:11.000Z","dependencies_parsed_at":"2022-08-28T04:41:22.052Z","dependency_job_id":null,"html_url":"https://github.com/nick-lehmann/Generi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nick-lehmann%2FGeneri","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nick-lehmann%2FGeneri/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nick-lehmann%2FGeneri/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nick-lehmann%2FGeneri/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nick-lehmann","download_url":"https://codeload.github.com/nick-lehmann/Generi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241717689,"owners_count":20008429,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-hub","docker-image","python3"],"created_at":"2024-09-24T13:58:54.349Z","updated_at":"2025-12-01T01:04:36.195Z","avatar_url":"https://github.com/nick-lehmann.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Generi logo](/docs/images/icon.png?raw=true \"Generi logo\")\n\n📚 [Documentation](https://generi.nicklehmann.sh/)\n\n🐳 About\n========\n\nGeneri 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. \n\nFor 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.\n\n🎇 Features\n===========\n\n- Configuration in yaml\n- Specify different parameter to form a build matrix\n- Generate Dockerfile for each combination\n- Build all variations of your image with one command\n- Push to the repository of your choice\n- Everything customisable using [Jinja](https://jinja.palletsprojects.com/en/2.10.x/)\n\n✈️ Quickstart\n=============\n\n`Generi` can be configured using a simple yaml file that defines your matrix build. \n\n*schema.yaml*\n\n```yaml\nparameters:\n  python_version:\n    - 2.7\n    - 3.5\n    - 3.6\n    - 3.7\n  operating_system:\n    - buster\n    - alpine\n\ntemplate: templates\noutput: \"output/{{ python_version }}/{{ operating_system }}\"\nimage: \"nicklehmann/myapplication:py{{ python_version }}-{{ operating_system }}\"\n\nregistry:\n  username: nicklehmann\n```\n\n*templates/Dockerfile*\n\n```dockerfile\nFROM python:{{ python_version }}-{{ operating_system }}\n\nCOPY main.py main.py\n\nCMD [\"python\", \"main.py\"]\n```\n\nFirst, render your dockerfiles by running\n\n```bash\n$ generi write schema.yaml\n```\n\nAfter that, build and optionally push your image.\n\n```bash\n$ generi build schema.yaml\n$ generi push schema.yaml\n```\n\nFor more examples, please see the [usage](https://generi.nicklehmann.sh/usage/usage.html) section of the documentation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnick-lehmann%2Fgeneri","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnick-lehmann%2Fgeneri","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnick-lehmann%2Fgeneri/lists"}