Berktacular is a gem that parses json type chef environment files and does things with them. It supports an additional json field called "cookbook_locations" containing a hash of cookbook locations at the same level as "cookbook_versions" The top level key is the cookbook name. Under it, the following keys are supported:
"github" : "github_account/repo_name"
"tag" : "string-%{version}" || "v%{version} || "%{version}
"auto_upgrade": true
"rel" : "cookbook_path/path/relative/to/github/repo"
"versions" : version hash that contains mappings to github commit refs. see below.
The special string '%{version}' is replaced with the version from cookbook_versions. The 'versions' hash allows the creation of versioned dependencies for cookbooks that are in github but not tagged. It provides a mapping of arbitrary version strings to a git commit reference.
Example:
"cookbook_locations": {
"untagged_repo": {
"github": "account/untagged_repo"
"versions": {
"0.0.1": {
"ref": "1234567890abcdef1234567890abcdef12345678"
}
}
}
}
This would allow you to reference version "0.0.1" of "untagged_repo" from your cookbook_versions section.
The "auto_upgrade" flag allows berktacular to auto-update a cookbook to latest available tagged version.
Using the --upload flag, berktacular will generate a Berksfile, verify it, and upload the environment file plus cookbooks to the chef server. When --upgrade is used, the environment file and cookbooks are both uploaded to the chef server with the latest versions filled in for any cookbooks marked "auto_upgrade".