Software Público - configuration management

Requirements

• chake
• rake

For development

• vagrant
• shunit2
• moreutils
• redir

Configuration parameters

For development, all configuration parameters are defined in the file nodes.yaml.

For production, create a new file based on nodes.yaml, e.g. prod.yaml.

Todos os parâmetros de configuração estão definidos no arquivo nodes.yaml

Deploy

Development

First you have to bring up the development virtual machines:

$ vagrant up
$ rake bootstrap_common

Right now there are 5 VM's, so this might take a while. The basic commands for deployment:

$ rake                                  # deploys all servers
$ rake nodes                            # lists all servers
$ rake converge:$server                 # deploys only $server

Production

• TODO: document adding the SSL key and certificate
• TODO: document creation of prod.yaml.
• TODO: document SSH configuration

$ rake NODES=prod.yaml                  # deploys all servers
$ rake nodes NODES=prod.yaml            # lists all servers
$ rake converge:$server NODES=prod.yaml # deploys only $server

You can also do export NODES=prod.yaml in your shell and omit the NODES=prod.yaml parameter in the rake calls.

See the output of rake -T for other tasks.

Viewing the running site in development

Run:

./server

Follow the on-screen instructions an browse to http://softwarepublico.dev/.

Note: this requires that your system will resolve \*.dev to localhost. Google DNS servers will do that automatically, otherwise you might add the following entries to /etc/hosts:

127.0.53.53 softwarepublico.dev
127.0.53.53 listas.softwarepublico.dev