Description

This cookbook is designed to be able to describe and deploy Python web applications. Currently supported:

* plain python web applications

* Django

* Green Unicorn

* Celery

Note that this cookbook provides the Python-specific bindings for the `application` cookbook; you will find general documentation in that cookbook.

Other application stacks may be supported at a later date.

Requirements

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

The following Opscode cookbooks are dependencies:

* application

* python

* gunicorn

* supervisor

Resources/Providers

The LWRPs provided by this cookbook are not meant to be used by themselves; make sure you are familiar with the `application` cookbook before proceeding.

django

The `django` sub-resource LWRP deals with deploying Django webapps from an SCM repository. It uses the `deploy_revision` LWRP to perform the bulk of its tasks, and many concepts and parameters map directly to it. Check the documentation for `deploy_revision` for more information.

A new virtualenv will be created for the application in "#{path}/shared/env"; pip package will be installed in that virtualenv.

- packages: an Array of pip packages to install

- requirements: the relative path to a requirements file. If not specified the provider will look for one in the project root, named either "requirements/#{chef_environment}.txt" or "requirements.txt"

- database\_master\_role: if a role name is provided, a Chef search will be run to find a node with than role in the same environment as the current role. If a node is found, its IP address will be used when rendering the context file, but see the "Database block parameters" section below

- local\_settings\_file: the name of the local settings file to be generated by template. Defaults to "local_settings.py"

- settings\_template: the name of template that will be rendered to create the local settings file; if specified it will be looked up in the application cookbook. Defaults to "settings.py.erb" from this cookbook

- settings: a Hash of additional settings that will be made available to the template

- database: a block containing additional parameters for configuring the database connection

- legacy\_database\_settings: if true, the default settings template will generate legacy database config variables. Defaults to false

- debug: used by the default settings template to control debugging. Defaults to false

- collectstatic: controls the behavior of the `staticfiles` app. If true, if will invoke manage.py with `collectstatic --noinput`; you can also pass a String with an explicit command (see Usage below). Defaults to false

The database block can accept any method, which will result in an entry being created in the `@database` Hash which is passed to the context template. See Usage below for more information.

gunicorn

The `gunicorn` sub-resource LWRP configures Green Unicorn to run the application.

If used with a Django application, it will install gunicorn into the same virtualenv and run it with `manage.py run_gunicorn`. For other applications, gunicorn will be run with `gunicorn #{app_module}`.

- app_module: mandatory. If set to :django, gunicorn will be configured to run a Django application; if set to another String or Symbol, it will be used to build the gunicorn base command.

- settings\_template: the template to render to create the `gunicorn_config.py` file; if specified it will be looked up in the application cookbook. Defaults to "se.py.erb" from the `gunicorn` cookbook

- host: passed to the `gunicorn_config` LWRP

- port: passed to the `gunicorn_config` LWRP

- backlog: passed to the `gunicorn_config` LWRP

- workers: passed to the `gunicorn_config` LWRP

- worker_class: passed to the `gunicorn_config` LWRP

- worker_connections: passed to the `gunicorn_config` LWRP

- max_requests: passed to the `gunicorn_config` LWRP

- timeout: passed to the `gunicorn_config` LWRP

- keepalive: passed to the `gunicorn_config` LWRP

- debug: passed to the `gunicorn_config` LWRP

- trace: passed to the `gunicorn_config` LWRP

- preload_app: passed to the `gunicorn_config` LWRP

- daemon: passed to the `gunicorn_config` LWRP

- pidfile: passed to the `gunicorn_config` LWRP

- umask: passed to the `gunicorn_config` LWRP

- logfile: passed to the `gunicorn_config` LWRP

- loglevel: passed to the `gunicorn_config` LWRP

- proc_name: passed to the `gunicorn_config` LWRP

Usage

A sample application that needs a database connection:

application "packaginator" do

path "/srv/packaginator"

owner "nobody"

group "nogroup"

repository "https://github.com/coderanger/packaginator.git"

revision "master"

migrate true

packages ["libpq-dev", "git-core", "mercurial"]

django do

packages ["redis"]

requirements "requirements/mkii.txt"

settings_template "settings.py.erb"

debug true

collectstatic "build_static --noinput"

database do

database "packaginator"

engine "postgresql_psycopg2"

username "packaginator"

password "awesome_password"

end

database_master_role "packaginator_database_master"

end

end

You can invoke any method on the database block:

application "my-app" do

path "/srv/packaginator"

repository "..."

revision "..."

django do

database_master_role "packaginator_database_master"

database do

database 'name'

quorum 2

replicas %w[Huey Dewey Louie]

end

end

end

The corresponding entries will be passed to the context template:

<%= @database['quorum']

<%= @database['replicas'].join(',') %>

License and Author

Author:: Adam Jacob (<adam@opscode.com>)

Author:: Andrea Campi (<andrea.campi@zephirworks.com.com>)

Author:: Joshua Timberman (<joshua@opscode.com>)

Author:: Noah Kantrowitz (<noah@coderanger.net>)

Author:: Seth Chisamore (<schisamo@opscode.com>)

Copyright 2009-2012, Opscode, Inc.

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

http://www.apache.org/licenses/LICENSE-2.0

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.