A utility for releasing and managing Chef Cookbooks. It will:
- Tag and push a new release to git
- Upload the cookbook to a cookbook share (such as Supermarket)
Existing tools to package cookbooks (such as Knife Community and knife cookbook site share
) require a dependency on Chef. Because of thier dependency on Chef, they enforce the use of a "cookbook repo". Especially with the evolution of Berkshelf, cookbooks are individualized artifacts and are often contained in their own repositories. stove is cookbook-centric, rather than Chef-centric.
-
Add Stove to your project's Gemfile:
gem 'stove'
-
Run the
bundle
command to install:$ bundle install --binstubs
Stove requires your username and private key to upload a cookbook. You can pass these to each command call, or you can set them Stove:
$ stove login --username sethvargo --key ~/.chef/sethvargo.pem
These values will be saved in Stove's configuration file and persisted across your workstation.
The default publishing endpoint is the Chef Supermarket, but this is configurable. If you want to publish to an internal community site, you can specify the --endpoint
value:
$ stove --endpoint https://internal-cookbook-store.example.com
There are two ways to use Stove. You can either use the stove
command directly or use the embedded rake task.
Execute the stove
command from inside the root of a cookbook:
$ bin/stove
This will package (as a tarball) the cookbook in the current working directory, tag a new version, push to git, and publish to a cookbook share.
If you are familiar with the Bundler approach to publishing Ruby gems, this approach will feel very familiar. Simply add the following to your Rakefile
:
require 'stove/rake_task'
Stove::RakeTask.new
And then use rake to publish the cookbook:
$ bin/rake publish
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
- Author: Seth Vargo (sethvargo@gmail.com)
Copyright 2013-2014 Seth Vargo <sethvargo@gmail.com>
Copyright 2013-2014 Chef Software, Inc
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.