Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


deploy_s3 (3) Versions 1.3.0

Provides a resource for downloading build packages and deploying them onto a server

cookbook 'deploy_s3', '= 1.3.0', :supermarket
cookbook 'deploy_s3', '= 1.3.0'
knife supermarket install deploy_s3
knife supermarket download deploy_s3
Quality -%

Description Build Status

Somewhat similar to the Opscode deploy resource, but rather than hooking up to a source code repository, it downloads complete build packages from a specific Amazon S3 bucket.
The cookbook itself doesn't do much, besides providing an "s3_deploy" resource that takes care of the above.


Needs the "s3cmd" cookbook to work. Tested on Ubuntu 11.10 and 12.04, but it should work on any platform that supports symlinks.


['deploy_s3']['bucket'] = The name of the bucket containing the releases
['deploy_s3']['deploy_root'] = The location where the app will be deployed on disk - defaults to "/home/web"


Best to explain by example:

Let's assume we have an application called "myapp", and we want to deploy the build "v1.2" on our server.
We set the "bucket" attribute to "app-releases", and leave "deploy_root" as the default.

First, we need to store the build in the "app-releases" S3 bucket. The build should be a single folder named after the release name ("v1.2" in our case), which is then compressed with Tar/Gz. So for our example, the package would be "v1.2.tar.gz" which contains the folder "v1.2".

This folder is then uploaded into S3, inside a folder named after the app: "myapp/v1.2.tar.gz"

Then we'd put the following in our recipe

deploy_s3 "myapp" do
    build "v1.2"
    action :create

and the resource will do the following:

  1. Create the folder "/home/web/myapp" if it's not already there
  2. Create the folder "/home/web/myapp/releases" if it's not already there
  3. Attempt to download the object "myapp/v1.2.tar.gz" from the "app-releases" bucket, into "/home/web/myapp/releases"
  4. Unzip the package
  5. Symlink the package to "/home/web/latest"


Please refer to the Readme here

License and Author

Author:: Adam Borocz (on GitHub)

Copyright:: 2013, HipSnip Ltd.

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

hipsnip-s3cmd >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

No quality metric results found