Name: baryon
Owner: Pantheon
Description: Layered Chef Universe Server
Created: 2015-10-22 03:29:21.0
Updated: 2017-03-02 03:18:06.0
Pushed: 2016-07-22 19:51:22.0
Homepage: null
Size: 55
Language: Go
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Chef cookbook compositor (aka universe endpoint)
This is an implementation of the Chef Universe server API that layers and combines multiple universe sources like the Chef Supermarket and GitHub organizations.
By default Baryon makes use of GitHub releases (tags) as the primary source for cookbook version information. Any remaining dependencies are resolved with the community Supermarket data. This provides a simple mechanism to combine private version controlled storage with public community cookbooks, with preference for the internal name-space.
A GitHub web-hook endpoint for processing cookbook version data (typically automatic tagging during continuous integration) as well as polling GitHub repositories on a sync interval is provided.
Features:
Download a release for your architecture, and run it.
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 GitHub's auth request to baryon.
The token you use for baryon needs to have access to private repositories if you expect it to index private cookbooks. It only needs to read from repositories however.
baryon --help
e:
ryon [OPTIONS]
ication Options:
, --port= Port to listen on (443) [$BARYON_PORT]
, --bind= Ip address to bind to (0.0.0.0) [$BARYON_BIND]
, --secret= The web-hook secret [$BARYON_HOOK_SECRET]
, --key= Specify a Key file to enable server to start TLS [$BARYON_KEY]
, --cert= Cert file for TLS [$BARYON_CERT]
, --org= Github Org to find cookbooks [$BARYON_GITHUB_ORG]
, --token= Github API token to use when connecting [$BARYON_GITHUB_TOKEN]
, --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]
Options:
, --help Show this help message
This project is using the Go 1.5 vendor experiment to manage dependencies. Fetch the repo source per normal with go get:
et github.com/pantheon-systems/baryon
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
GOPATH/src/github.com/pantheon-systems/baryon && make