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.

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.

• Fork the ofn-install repository.
• Clone the forked copy:

  git clone https://github.com/<your-namespace>/ofn-install.git
  

It's recommended you set up your Python environment using Pyenv.

• 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
  

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

Some playbooks require third-party roles, which are specified in bin/requirements.yml. You can install with the included script:

$ bin/setup

Run the ansible-lint checks using:

ansible-lint site.yml --exclude=community

This is also run in CI.