Description

Opscode Chef cookbook that installs and configures uWSGI. uWSGI is a fast, self-healing and developer/sysadmin-friendly application container server coded in pure C.

Requirements

Platform

Debian, Ubuntu

Cookbooks

python
runit

Definitions

uwsgi_service

:home_path - path to the app you want to run with uWSGI, default to "/var/www/app"
:pid_path - path to pid file for uWSGI, default to "/var/run/uwsgi-app.pid"
:config_file - path to configuration file, default to nil, overrides the below options if not nil
:config_type - configuration file type, default to :ini
:host - hostname to run uWSGI on, default to "127.0.0.1"
:port - port number to run uWSGI on, default to 8080
:worker_processes - number of uWSGI workers, default to 2, should probably be relative to the number of CPUs
:app - app to run on uwsgi, passed to --module parameted of uWSGI, default to "main:app"
:uid - user-id to run uwsgi under, default to "www-data"
:gid - group-id to run uwsgi under, default to "www-data"
:master - enable uwsgi master process, default to false
:no_orphans - kill workers without a master process, default to false
:die_on_term - make uwsgi die on term signal, default to false
:close_on_exec - set close-on-exec flag on uwsgi socket, default to false
:lazy - load application after worker fork(), default to false
:disable_logging - disable uwsgi request logging, default to false
:start_immediately - decide whether you want to start the service immediately or later manually, default to true

Usage

Add the default uWSGI recipe to install uwsgi through pip. Define a uWSGI service with a definition like so:

uwsgi_service "myapp" do
  home_path "/var/www/app"
  pid_path "/var/run/uwsgi-app.pid"
  host "127.0.0.1"
  port 8080
  worker_processes 2
  app "flask:app"
end

You can also use a preexisting uWSGI configuration like so:

uwsgi_service "myapp" do
  home_path "/var/www/app"
  pid_path "/var/run/uwsgi-app.pid"
  config_file "/etc/uwsgi/myapp.yaml"
  config_type :yaml
end

If :config_file is passed, all other options except :home_path, :pid_path, and :config_type are ignored.

buzzedword / uwsgi