Baryon
Chef cookbook compositor (aka universe endpoint)
This is an implementation of a chef-universe server that layers sources.
Right now it uses Github releases/tags as the primary source for cookbook
information. Then layers the supermarket universe data behind the Github
data. This lets you effectively 'namespace' your cookbooks. More backend
sources and more merge strategies are planned to be implemented. It also
provides a Github hook endpoint for updating cookbook data as well as
poling Github on a sync interval.
Features:
- Exclusive Merge of sources (Github org before supermarket universe)
- GitHub hook Universe updates
- understands tags beyond /^v\d.\d.\d/
- Efficient usage of Github api
- Stable service
Getting Started
Pull a release from releases for your architecture.
Build from source
This project is using the Go 1.5 vendor experiment to manage dependencies. Fetch the repo source per normal with go get:
go get github.com/pantheon-systems/baryon
Vendored Deps
Then run make
in the source directory. Make will 'go get' gvt, which is used to manage vendoring dependencies into the ./vendor
directory, and build from source
cd $GOPATH/src/github.com/pantheon-systems/baryon && make
How to use
The most simple setup is to just ./baryon -p 80 -o mygithuborg -t mytoken -s hooksecret
this starts a server that will listen on port 80, and index 'mygithuborg' using your github token and waiting for github hook payloads with 'hooksecret' as githubs auth request to baryon.
./baryon --help
Usage:
baryon [OPTIONS]
Application Options:
-p, --port= Port to listen on (443) [$BARYON_PORT]
-b, --bind= Ip address to bind to (0.0.0.0) [$BARYON_BIND]
-s, --secret= The web-hook secret [$BARYON_HOOK_SECRET]
-k, --key= Specify a Key file to enable server to start TLS [$BARYON_KEY]
-c, --cert= Cert file for TLS [$BARYON_CERT]
-o, --org= Github Org to find cookbooks [$BARYON_GITHUB_ORG]
-t, --token= Github API token to use when connecting [$BARYON_GITHUB_TOKEN]
-i, --interval= Interval to perform full sync against github repos. Supports Golang duration formatting '1h2m'... etc. (12h)
[$BARYON_INTERVAL]
--no-sync Do NOT perform a github scan/sync when starting. Periodic sync will still fire [$BARYON_NOSYNC]
--berks-only Only use berks compatable version tags in the universe [$BARYON_BERKSONLY]
Help Options:
-h, --help Show this help message