Provisioning

Provisioning is the process of configuring a server with the software required to run Open Food Network.

The provision.yml playbook installs packages such as curl and git, then installs:

• Nginx
• rbenv
• Ruby
• Postgresql
• Redis
• Unicorn

Important

For all ofn-install tasks make sure you update your local repos ofn-install and ofn-secrets (see fetch secrets below). Ensure correct version of dependencies and roles are installed.

First time: run the site.yml playbook

If the server you are provisioning has not been set up or provisioned before, you can run the site.yml playbook. This will run through the three main playbooks for: setup, provision, and deploy. The setup playbook includes adding the correct user accounts to the server.

ansible-playbook site.yml --limit=au_staging

Tip

Hosted Ubuntu servers often have remote access to root disabled, so for first-time setup, use the ubuntu user like so: -e "ansible_user=ubuntu"

This step can take a long time. And you might need to tweak your SSH configuration to prevent timeouts.

Running Ansible playbooks

Add -vvvv for greater debug output.

Provisioning

To provision you just need to run the following command (this will automatically load secrets from the host_vars subfolder):

ansible-playbook playbooks/provision.yml --limit=<host>

Ensuring secrets are up to date (see Configuration on how to build a new secrets file). If you are a member of the core dev team, you can use a more convenient way to include up-to-date secrets, see fetch_secrets.yml playbook.

Server groups

To provision all globally managed servers, you can use the all-prod group:

ansible-playbook playbooks/fetch_secrets.yml && ansible-playbook playbooks/provision.yml --limit=all-prod

Next: Administration of your application server