Skip to content

Deployment with Ansible

Enrico Stano edited this page Aug 4, 2017 · 10 revisions

This gets a copy of openfoodnetwork from a git repo that your specify (in vars.yml), put it onto the server, and then does ruby/rake/rails tasks and configuration needed so that it can run. The main tasks accomplished are:

  • copy OFN from a git repo to the server
  • create the database if needed
  • run database migrations
  • precompile assets used by OFN
  • creates seed data
  • creates an initial admin user

This list isn't comprehensive; those are the highlights.

Running the deploy playbook

Edit git_repo and git_version in inventory/group_vars/all.yml.

Then, assuming you want to deploy to es-staging host, run the following command:

ansible-playbook playbooks/deploy.yml --limit es-staging

(with -vvvv for full debug output)

Replace es-staging with your own host as specified in inventory/hosts file.

There is a timestamped backup process included in deployment and a rollback version saved each time.

Rollback

If the deployment script fails after the "Create a repo backup version" task you may need to roll it back to have a functional site, by running:

ansible-playbook rollback.yml -i staging

Failures before this don't need rollback, and it will not run. Just run deployment again. This could be automated at some point.

Backup

Backups will be stored by default in ofn_deployment/backups.

To backup on the server and to the local machine run:

ansible-playbook backup.yml -i staging

Note: This doesn't clean up old backups automatically yet.