Name Last Update
config Loading commit data...
cookbooks Loading commit data...
docs Loading commit data...
monitoring Loading commit data...
roles Loading commit data...
rpm_mirrors Loading commit data...
src Loading commit data...
tasks Loading commit data...
test Loading commit data...
utils Loading commit data...
.ackrc Loading commit data...
.gitignore Loading commit data...
Gemfile Loading commit data...
README.md Loading commit data...
Rakefile Loading commit data...
Rakefile.ci Loading commit data...
Vagrantfile Loading commit data...
ci Loading commit data...
config.rb Loading commit data...
local.rake.example Loading commit data...
nodes-ci.yaml Loading commit data...
nodes.yaml Loading commit data...
server Loading commit data...
ssh_config.erb Loading commit data...

README.md

Software Público - configuration management

Requirements

For development

  • vagrant
  • shunit2
  • moreutils
  • redir

Configuration parameters

All configuration parameters are defined in nodes.yaml, with exception of IP addresses, which are defined in different files:

  • for local development, the IP addresses of the Vagrant VMs are defined in config/local/ips.yaml.

  • for production, you need to create a new file called config/production/ips.yaml

You will probably not need to change nodes.yaml unless you are developing the deployment process.

Deploy

Development

First you have to bring up the development virtual machines:

$ vagrant up
$ rake preconfig
$ 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

The very first step is

$ rake preconfig SPB_ENV=production

This will perform some initial configuration to the system that is required before doing the actual deployment.

After that:

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

You can also do export SPB_ENV=production in your shell and omit it in the rake calls.

See the output of rake -T for other tasks.

Viewing the running site when developping locally

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