Deploying Open Food Network

These are Ansible playbooks (scripts) for managing an Open Food Network app server. This is not for your local development environment. Head to the OFN getting started guide to run the OFN locally.

The Open Food Network is an online marketplace for local food. Instructions for configuring a development environment can be found on the project's GitHub repository.

Start with our deployment tutorial to learn how to setup your own Open Food Network server with Ansible.

For deploying OFN versions below v4.x.x, please use the ofn-v3 branch of this repo.

Playbooks

These playbooks will install the Open Food Network app onto a server running an apt-compatible OS like Debian or Ubuntu. It has currently been tested on Ubuntu 16.04 and 18.04 (64 bit) on AWS, DigitalOcean and Scaleway cloud servers.

The playbooks take information from the inventory. Make sure that your host's information is up to date before running a playbook. Make also sure to include your host's secrets file.

These are the main playbooks:

• setup.yml - Use a root login to ensure python is installed and create a default user (defined in inventory/group_vars/all.yml) on the server for installation (mandatory the first time you provision a server).
• provision.yml - Install and configure all required software on the server.
• deploy.yml - Deploy OFN to the server by copying a git repo to the server and using ruby/rake/rails tasks to configure and migrate.
• backup.yml - Backup database and image files on the server to the local machine.
• rollback.yml - Rollback the database and codebase to the previous version.

You may want to use the anisble option "checkrun" to do a dry-run of the playbooks. With this option, Ansible will run the playbooks, but not actually make changes on the server.

Requirements

You will need to install Ansible, alongside other dependencies, on your machine to run the playbooks. You can do so with:

pip install -r requirements.txt

Before that, it's recommended you set up your Python environment using Pyenv.

In that case, you need to:

• Install and configure pyenv
• Install and configure pyenv-virtualenv
• Install the required Python version:

$ pyenv install 3.8.2

• Create the virtualenv:

$ pyenv virtualenv 3.8.2 ofn-install

Installation quick steps

ansible-galaxy install -r bin/requirements.yml
ansible-playbook site.yml  --limit=bf-staging  -e "ansible_user=jamal"

ansible-playbook playbooks/deploy.yml --limit bf-staging -e "git_version=v2.9.10"


ansible-playbook playbooks/deploy.yml --limit bf-prod -e "git_version=v2.9.10"

Code quality

Run the ansible-lint checks using:

ansible-lint site.yml --exclude=community

This is also run in CI.

---