Startsida Utforska Hjälp
Logga in
akshay
/
dhall-concourse
spegling av https://github.com/akshaymankar/dhall-concourse
Bevaka 1
Stjärnmärk 0
Fork 0
Filer Ärenden 0 Wiki

Ingen beskrivning

Gren: fly-less
Grenar Taggar
dhall-concou...
ZIP TAR.GZ
Akshay Mankar da22302f20 Add render functions to render to JSON 5 år sedan
defaults 8eb1b38fbc Fix name of pipeline's oldName to old_name 5 år sedan
examples 743f69564b More compact formatting with dhall-1.26.1 5 år sedan
helpers 4040fe3a0c Add simple `in_parallel` helper to package.dhall 5 år sedan
lib 500165c224 Upgrade to dhall 11.0.0 5 år sedan
render da22302f20 Add render functions to render to JSON 5 år sedan
resource-types 257c0f000a Update all types with concourse v5.5.1 spec 5 år sedan
resources 257c0f000a Update all types with concourse v5.5.1 spec 5 år sedan
schemas 18e0e506c7 Add schemas 5 år sedan
types 764a5fa686 Add support for in_parallel 5 år sedan
utils 860e026a57 Format all files 5 år sedan
README.md 2c9c6a8636 Create README 5 år sedan
package.dhall da22302f20 Add render functions to render to JSON 5 år sedan

README.md

Dhall Concourse

Note: A lot of this README is inspired (some of it copied) from the dhall-kubernetes README, so thanks to the authors!

Dhall Concourse provides Dhall bindings for Concourse, so you can generate concourse pipelines from Dhall expressions. This will let you easily typecheck, template and modularize your Concourse pipelines.

Why do I need this?

There are a lot of issues one could face while building any non-trivial pipeline. Few them could be:

  1. Pipeline yaml becomes very big and unmanageable
  2. Same set of jobs are required to be run in different environments
  3. Same set of hooks but with slight changes in all jobs. E.g. slack notifications, releasing resources on failure, etc.

Most common way to deal with these have been to use a templating language like erb, but it gets very messy very fast. We can do a lot better.

Dhall solves all of this, being a programming language with builtin templating, all while being non-Turing complete, strongly typed and strongly normalizing (i.e.: reduces everything to a normal form, no matter how much abstraction you build), so saving you from the "oh-noes-I-made-my-config-in-code-and-now-its-too-abstract" nightmare.

For a Dhall Tutorial, see the readme of the project, or the full tutorial.

Prerequisites

You need a patched version of dhall for this which supports the type JSON and function toJSON : forall(a : Type) -> a -> JSON. It is implemented at https://github.com/akshaymankar/dhall-recursive-json. It can be installed using instructions in the README.

Examples

There are a few examples in the examples directory.