README.md 1.78 KB

Software Público - configuration management

Requirements

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