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


docker-registry (3) Versions 0.0.8

Installs and configures docker-registry

cookbook 'docker-registry', '~> 0.0.8'
cookbook 'docker-registry', '~> 0.0.8', :supermarket
knife supermarket install docker-registry
knife supermarket download docker-registry
Quality 63%


This cookbook deployes the dotCloud docker-registry


Chef 0.10.0 or higher required (for Chef environment use).


  • application_nginx
  • application_python


  • Ubuntu
  • SmartOS
  • CentOS (Requires supervisor cookbook >= 0.4.11)


See attributes/default.rb for default values.

  • node["docker-registry"]["revision"] - Git tag to install.
  • node["docker-registry"]["storage"] - Defines the type of storage to use, local or s3.
  • node["docker-registry"]["ssl"] - If ssl should be enabled.
  • node["docker-registry"]["server_name"] - The FQDN that NGiNX will proxy for.
  • node["docker-registry"]["data_bag"] - Name of data bag containing encrypted secrets.
  • node["docker-registry"]["s3_access_key"] - Your S3 Access Key.
  • node["docker-registry"]["s3_bucket"] - Your S3 storage bucket.
  • node["docker-registry"]["secret_key"] - A 64 character random string. This is used to secure the session cookie. It is recommended to store this in the encrypted data bag.

Data Bag

To enable SSL or use S3 as a storage backend a data bag must be created to store the secrets. The data bag should contain an item for each environment that will host the docker-registry.

$ knife data bag show BAG_NAME ENVIRONMENT --secret-file=my-secret-file
  "id": "ENVIRONMENT",
  "secret_key": "...",
  "ssl_certificate": [
    "....", # SSL Certificate Chain
  "ssl_certificate_key": "...",
  "s3_secret_key": "..."

The ssl_certificate should contain the entire Certificate chain starting with the server certificate. The values should not contain any new lines. You can do this with cat my_cert.crt | tr -d '\r\n'.



A helper role that will configure a server to act as both an application server and load balancer.


Applying this role will install the docker-registry


Applying this role will install and configure NGiNX to proxy to all application servers.

The docker-registry_load_balancer role included in the repo will install the latest NGiNX from source. Ubuntu includes an ancient version that won't work with the registry.

License and Author

Author:: Raul E Rangel (

Copyright 2014, Raul E Rangel.

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.

Dependent cookbooks

application >= 3.0.0
application_python >= 0.0.0
application_nginx >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric

0.0.8 failed this metric

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

Contributing File Metric

0.0.8 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

0.0.8 passed this metric

No Binaries Metric

0.0.8 passed this metric

Publish Metric

0.0.8 passed this metric

Supported Platforms Metric

0.0.8 passed this metric

Testing File Metric

0.0.8 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

0.0.8 passed this metric