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


opsworks_python (3) Versions 0.0.2

Deploys and configures python based applications with supervisor

cookbook 'opsworks_python', '= 0.0.2', :supermarket
cookbook 'opsworks_python', '= 0.0.2'
knife supermarket install opsworks_python
knife supermarket download opsworks_python
Quality 0%

opsworks_python Cookbook

This cookbook is designed to be able to describe and deploy python applications on AWS OpsWorks with supervisor.


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

The following Opscode cookbooks are dependencies:

  • python
  • supervisor

Additionally, the AWS OpsWorks following cookbooks are required:

  • deploy
  • scm_helper

Stack/Layer configuration

Stack configuration

In your stack, update enable your custom json:

 "deploy": {
    "my_python_app": {
        "custom_type": "python", // Required otherwise the recipe will skip
        // List of package to install (optional)
        "packages": { 
            "pip_package_name": "latest",
        // OS packages  (optional)
        "os_packages": { 
            "package_name": "lasest"
        "opsworks_python": {
            "supervisor": {
                // supervisor options



The python deploy recipe creates a virtualenv and installs specified OS and python packages. This is the default recipe. These attributes can be set on the deploy configuration (node[:deploy][application_name]) or globally (node["opsworks_python"]).

Attribute Parameters

  • packages: a list of python packages to be installed in the virtualenv
  • os_packages: a list of OS packages to be installed on the instance
  • venv_options: a string with command line options for virtualenv creation (defaults to --no-site-packages)
  • python_major_version: the major version of python to use (only allowable in the deploy configuration, not globally), allows you to use python 2.4, 2.5 or 2.6 as needed.
  • python-undeploy: removes the virtual env and stops supervisor for the app


by default supervisor looks for into your app folder.
If your entrypoint is different set:

["opsworks_python"]["supervisor"]["script"] = '' 

If you want supervisor to use a specific command:
["opsworks_python"]["supervisor"]["command"] = 'mycommand' 

Other supervisor options for the service are described here

Disable supervisor

set node["opsworks_python"]["supervisor"]["disabled"] = true and supervisor will be disabled.

Bugfix for R3 Instances

OpsWorks currently has a bug that affects r3 class instances, where the
ephemeral instance storage is not formatted or mounted on initial load. This
causes reboots to fail, since the volume is listed in fstab, and also results
in reduced space available on /mnt.

To workaround this issue, this package contains a custom recipe that formats
and mounts the default ephemeral volume on r3 instances. To enable the
recipe, add the opsworks_deploy_python::r3-mount-patch recipe to the start
of the setup section of any layers that might run on an r3 instance.

More info here.

License & Authors

With thanks to Jazkarta, Inc. and KCRW Radio
Copyright 2014, Alec Mitchell

Licensed under the BSD License.

Dependent cookbooks

deploy >= 0.0.0
scm_helper >= 0.0.0
opsworks_initial_setup >= 0.0.0
python >= 0.0.0
supervisor >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

application_buildout Cookbok CHANGELOG

Foodcritic Metric

0.0.2 failed this metric

FC015: Consider converting definition to a LWRP: /tmp/cook/3fc25bf971f3d707acd91d85/opsworks_python/definitions/python_base_setup.rb:1
FC015: Consider converting definition to a LWRP: /tmp/cook/3fc25bf971f3d707acd91d85/opsworks_python/definitions/python_dependencies.rb:1
FC015: Consider converting definition to a LWRP: /tmp/cook/3fc25bf971f3d707acd91d85/opsworks_python/definitions/supervisor_deploy.rb:1