vanilla

  • By johnsca
  • Latest version (#0)
  • trusty
  • Stable
  • Edge

Description

Vanilla is designed to deploy and grow small communities to scale.
This charm deploys Vanilla Forums as outlined by the Vanilla Forums installation guide.


Overview

This is a runtime layer that is intended to be built upon by other charm layers.
It provides Apache2 and modphp5, and manages sites based on an apache.yaml
defined in the charm layer that uses this.

Usage

In your charm layer's composer.yaml, you will need to include this layer, e.g.:

includes: ['layers:apache-php']

Then, you will need to include an apache.yaml file which can specify additional
packages to install, and one or more sites to install and manage. Each site
definition should include an install_from section whose keys are arguments to
install_remote and should at a minimum include a source value. It can also
include an options value, to be used for the Options directive, and a
server_name value, to be used for the ServerName directive and which can
reference config options via {config["<key>"]} interpolation. An example
apache.yaml might look like:

packages:
    - 'php5-mysql'
    - 'php5-gd'
sites:
    vanilla:
        server_name: '{config["hostname"]}'
        options: 'Indexes FollowSymLinks MultiViews'
        install_from:
            source: https://github.com/vanillaforums/Garden/archive/Vanilla_2.0.18.8.tar.gz
            checksum: acf61a7ffca9359c1e1d721777182e51637be59744925935291801ccc8e8fd55
            hash_type: sha256

Your site will be installed in to /var/www/<site> where <site> is the name
of your site entry (vanilla in the example above).

Finally, your charm layer will need to interact with this layer via reactive
states. This layer will set the apache.available state once your apache.yaml
has been processed and all sites installed, at which point your charm layer
should perform any additional setup (such as creating site config files, opening
the appropriate ports, etc) and then set the apache.start state.

Configuration

port
(int) Port on which to listen
80