README
¶
metaGraf
metaGraf is a specification of metadata and necessary information about a software component to build it, run it and reason about it. It's intended to be used as a source of truth of requirements in a CI/CD and GitOps scenarios.
It is inspired by the twelve-factor app methodology to aid automation tasks or decisions about a component or collection of compoenents.
In a GitOps flow, the metaGraf specification in combination with the tool mg will be used as the foundation for manifest generation of the Kubernetes resources(YAML/JSON) that should go into Git. You can use tools like Kustomize to modify/patch generated resources to address the operational domain concerns.
Status
The model is maturing but should still be considered a work in progress. It is getting quite heavy usage internally in our CI processes. It is also getting internal usage in a GitOps setting for the CD parts. Better public examples are forthcoming.
This repository contains the WIP specification and a tool called mg that consumes the specification or specifications and turns that into actionable items or kubernets resources.
The repository will split in two in the future. One for the datastructure specification and one for the mg utility.
Acknowledgement
Appreciation goes out to my current employer Norsk Tipping AS, for letting me work on this in the open.
Directories