ansible-rookeries/README.md

Ansible Rookeries
=================

An Ansible role that acts as a companion to the Rookeries project.  The goal of this role is to make deployment of 
Rookeries simple.  Ideally Rookeries even as a Python WSGI app with this role, should be easier to setup than Wordpress.

This role is a work-in-progress as Rookeries itself is heavily under development.

Requirements
------------

- aptitude or python-apt (required by apt tasks)
- python > 2.5 (required by ini_file tasks)
- Ansible >= 2.0

This role is designed to work against a modern Ubuntu system.  (Tested on Ubuntu 13.10 and 14.04)  It should 
theoretically work on older versions of Ubuntu or Debian based systems.

Example Playbook
----------------

The simplest way to include the role in your playbook is to base it off the  below configuration.  The crucial
part is to configure the rookeries_app_config and the app_nginx_hostname (inherited from the nginx-uwsgi-supervisor 
role).
         
    - hosts: servers
      sudo: yes
      vars:
          my_rookeries_app_config:
              rookeries_environment_name: ...
              ...
      roles:
          - role: ansible-rookeries
            rookeries_app_config: "{{ vagrant_rookeries_app_config }}"
            rookeries_db: "{{ rookeries_db_setup }}"
            rookeries_environ_type: prod
            rookeries_package_path: "{{ rookeries_package }}"
            rookeries_app_hostname: rookeries.org
            
*TODO: Add in section for description of symlink enabled deployments.*

Role Variables
--------------

*TODO: A description of newer role variables for version number and app name*

- rookeries_db:
    - This configures database soecific inforaation
    - keys:
        - db_name: 
            - The name of the database to store info in.
        - username:
            - The database username for the above specified database.
        - password: 
            - The database username for the above specified database.
        - host:
            - The hostname of the CouchDB database server.
            - Default: localhost
        - port:
            - The port of the CouchDB database server.
            - Default: 5984
- rookeries_app_name:
    - Configures the unique name of the rookeries app.
    - Default: rookeries
- rookeries_app_hostname:
    - Configures the hostname of site (https://my.rookeries_site.net) serving the rookeries app.
    - Default: localhost
- rookeries_environ_type:
    - The mode of the setup.  Setting to "dev" enables the use of a SMTP fake server to help with development.
    - Default: dev
- rookeries_app_config:
    - Application specific configuration for running rookeries

This role depends on the nginx_uwsgi_supervisor role, and hence reuses the variables provided by that role.  See the 
[Ansible Galaxy role page] (https://galaxy.ansible.com/list#/roles/2637) for details.

Dependencies
------------

- nginx_uwsgi_supervisor
    - Setup common NGINX, UWSGI and Supervisor infrastructure.
    - Repository: https://bitbucket.org/dorianpula/ansible-nginx-uwsgi-supervisor
    - Ansible Galaxy: https://galaxy.ansible.com/list#/roles/2637

License
-------

AGPL v3

Author Information
------------------

Dorian Pula

- twitter: @dorianpula
- email: dorian.pula at amber-penguin.software.ca
- www: http://amber-penguin-software.ca

This role is a spin-off of the technology developed for the [Rookeries project] (http://rookeries.org/)


Repositories
------------

- Main: https://bitbucket.org/dorianpula/ansible-rookeries