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


poise-archive (9) Versions 1.4.0

A Chef cookbook for unpacking file archives like tar and zip.

cookbook 'poise-archive', '= 1.4.0'
cookbook 'poise-archive', '= 1.4.0', :supermarket
knife supermarket install poise-archive
knife supermarket download poise-archive
Quality 44%

Poise-Archive Cookbook

Build Status Gem Version Cookbook Version Coverage Gemnasium License

A Chef cookbook to unpack file archives.

It supports .tar, .tar.gz, .tar.bz2, and .zip archive files.

Quick Start

To download an unpack and archive:

poise_archive '' do
  destination '/opt/myapp'


Chef 12.1 or newer is required.


This cookbook supports all platforms (including Windows) but some Unix platforms (Solaris, AIX) may see very slow tar file unpacking when using the pure-Ruby fallback implementation.



The poise_archive resource unpacks file archives.

poise_archive '/tmp/myapp-1.2.0.tar' do
  destination '/srv/myapp-1.2.0'

A URL can also be passed as the source path, optionally with extra properties to be merged with source_properties.

poise_archive '' do
  destination '/srv/myapp-1.2.0'

poise_archive ['', {headers: {'Authentication' => '...'}}] do
  destination '/srv/myapp-1.2.0'


  • :unpack – Unpack the archive. (default)


  • path – Path to the archive. If relative, it is taken as a file inside Chef::Config[:file_cache_path]. If a URL, it is downloaded to a cache file first. (name attribute)
  • destination – Path to unpack the archive to. If not specified, the path of the archive without the file extension is used. Required when unpacking from a URL. (default: auto)
  • group – Group to run the unpack as.
  • keep_existing – Keep existing files in the destination directory when unpacking. (default: false)
  • source_properties – Property key/value pairs to be applied to the remote_file file resource when downloading a URL. (default: {retries: 5})
  • strip_components – Number of intermediary directories to skip when unpacking. Works like GNU tar's --strip-components. (default: 1)
  • user – User to run the unpack as.


Development sponsored by Bloomberg.

The Poise test server infrastructure is sponsored by Rackspace.


Copyright 2016-2017, Noah Kantrowitz

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, 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.

BZip2 implementation is based on RBzip2. Copyright Sebastian Staudt, Brian Lopez. RBzip2 code used under the terms of the new BSD license.

Dependent cookbooks

poise ~> 2.6

Contingent cookbooks

blp-nrpe Applicable Versions
cerner_splunk_ingredient Applicable Versions
cerner_tomcat Applicable Versions
consul Applicable Versions
consul-replicate Applicable Versions
forge_server Applicable Versions
ftb_server Applicable Versions
github_action_runners Applicable Versions
hashicorp-vault Applicable Versions
helm Applicable Versions
java-service Applicable Versions
newrelic-infra Applicable Versions
nomad-agent Applicable Versions
nrpe-ng Applicable Versions
openbazaar Applicable Versions
poise-languages Applicable Versions
radarr Applicable Versions
radiator Applicable Versions
snort Applicable Versions
teleport Applicable Versions

Poise-Archive Changelog


  • Added support for using 7-Zip on Windows.
  • Fixed handling of .tar.xz archives on RHEL and CentOS.


  • Add support for unpacking directly from a URL.


  • #1 Restore file permissions for ZIP files.


  • Add back a tar-binary provider called GnuTar, used by default on Linux.
  • Support for ZIP files via RubyZip.
  • Full Windows support, including with the user and group properties.


  • Fix compat with older Ruby that doesn't include Entry#symlink?.


  • Fix GNU tar longlink extension.


  • Scrap the original tar implementation in favor of a 100% pure-Ruby solution. This should work on all platforms exactly the same. Hopefully.


  • Initial release!

Collaborator Number Metric

1.4.0 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

1.4.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Foodcritic Metric

1.4.0 passed this metric

License Metric

1.4.0 failed this metric

poise-archive does not have a valid open source license.
Acceptable licenses include Apache-2.0, apachev2, MIT, mit, GPL-2.0, gplv2, GPL-3.0, gplv3.

No Binaries Metric

1.4.0 passed this metric

Publish Metric

1.4.0 passed this metric

Supported Platforms Metric

1.4.0 failed this metric

poise-archive should declare what platform(s) it supports.

Testing File Metric

1.4.0 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

1.4.0 passed this metric