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_artifact (8) Versions 1.0.0

A cookbook with library to deploy local files

cookbook 'deploy_artifact', '= 1.0.0', :supermarket
cookbook 'deploy_artifact', '= 1.0.0'
knife supermarket install deploy_artifact
knife supermarket download deploy_artifact
Quality -%

deploy_artifact Circle CI


This cookbook provides a simple deploy_artifact resource that will deploy a single binary or tar.gz file. The deployment process is designed to mirror the Deploy Resource except designed to be used only for local deployments and not GIT. It is assumed that a directory called cached-copy will already contain the contents of what is to be deployed. It is left up to you on how to deliver the artifact while the resource will do the work to deploy it.

Given a file location and path, the resource will:
- Create a directory structure:

current -> releases\<CHECKSUM>

- Assume the file is a single binary or gziped tar file
- Create a releases directory and release directory named as the MD5 checksum of the deployed file in path
- On successful completion, symlink the release directory releases\<CHECKSUM> to path\current


  • deploy_artifact - performs deployment of a local artifact on a server


  • deploy: default action, will deploy a given file to a given path


Resource Parameters for :deploy

  • name : defaults to file parameter
  • file : path to binary or tar.gz file to deploy, Required
  • path : path to location to deploy to, Required
  • owner : owner of the deployed files, Default: root
  • group : group of the deployed files, Default: root
  • before_symlink : callback which takes a Ruby block of code to execute before symlinking a release to current, Default: nothing
  • restart_command : callback which takes a Ruby block of code to execute after symlinkinga release to current which can be used to restart applications if needed, Default: nothing


Deploy tarball from Rackspace Cloud Files

rackspacecloud_file '/var/www/app/cached-copy/deploy.tar.gz' do
  directory 'deploy.tar.gz'
  rackspace_username 'username'
  rackspace_api_key 'api_key'
  rackspace_region 'dfw'
  action :create

deploy_artifact 'deploy.tar.gz' do
  path '/var/www/app'
  action :deploy

Deploy tarball and restart service

deploy_artifact 'deploy.tar.gz' do
  path '/var/www/app'
  action :deploy
  restart_command do
    service 'unicorn-app' do
      action :restart


  1. Fork the repository on Github
  2. Create a named feature branch (i.e. add-my-feature)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request

License and Authors

Authors:: Justin Seubert (

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

deploy_artifact CHANGELOG


  • First Version

No quality metric results found