apache2 wsgi #6

Supports: trusty

Add to new model

Description

Install apache2 with mod_wsgi
Install python dependencies, from requirements.txt or from directory
Install ruby dependencies, from Gemfile or from directory
Extract app files
Serve the app on ports 80 and 443

Apache WSGI charm

This is a Juju charm for setting up an Apache mod_wsgi server for a basic Python WSGI app.

Usage

Deploy the charm

bash juju deploy ~nottrobin/trusty/apache2-wsgi

Add a project

The charm will just show a basic Apache2 welcome page, until you give it a URL from which to download a correctly configured WSGI app:

juju set app_tgz_url=http://example.com/my-project.tgz

It will then download the project, extract it, and restart Apache, attempting to run it.

Mongodb

If your app wants to make use of a MongoDB server, you can do that by adding a relation:

bash juju deploy mongodb juju add-relation apache-wsgi mongodb

Now the MongoDB URI for your application to use will be available in the environment variable MONGODB_URI.

Configuring

By default, the WSGI file (wsgi_file_path) is expected to be at [project]/app.py, and the application name (wsgi_app_name) is expected to be app. This is in line with Flask defaults.

Any required python modules should be listed in [project]/requirements.txt (pip_requirements_path) and if you want pip to install them from local files instead of from PyPi, include the local packages in [project]/pip-cache (pip_cache_path).

For a full list of configuration options, see config.yaml.

Configuration

apache_conf_path
(string) Path within the project to a custom apache configuration template Defaults to using the charm's template at [charm]/templates/wsgi-app.conf
app_tgz_url
(string) A url where a gzipped tarball of the application files can be downloaded
apt_dependencies
(string) Space separated list of extra apt packages to be installed.
environment_variables
(string) A dictionary of environment variables to be set in the instance
nagios_check_string
(string) The string for nagios to check is in the `nagios_check_uri` page
nagios_check_uri
(string) Relative URI for nagios to check against Nagios will expect a 200 status and a string, set in `nagios_check_string`
/
nagios_environment
(string) Name of the environment for use in nagios
wsgi-apps
pip_cache_path
(string) A path (within the project) to python dependencies
pip-cache
pip_no_index
(boolean) Prevent pip connecting to Python Package Index to download packages
pip_requirements_path
(string) A path (within the project) to pip requirements file - set this to blank to prevent installing from PyPi
requirements.txt
server_name
(string) The servername for inclusion in the Apache configuration
*
ssl_certificate
(string) Base64 encoded certificate file for SSL
ssl_keyfile
(string) Base64 encoded keyfile for SSL
static_path
(string) The path to the static folder within the application
static
static_url_path
(string) The URL path to access static files
static
wsgi_app_name
(string) The name of the application inside the WSGI file
application
wsgi_file_path
(string) The location (within the project) of the WSGI script
application.py