browsertrix/docs/deploy/ansible/digitalocean.md

DigitalOcean

Playbook Path: ansible/playbooks/install_microk8s.yml

This playbook provides an easy way to install BrowserTrix Cloud on DigitalOcean. It automatically sets up Browsertrix with, LetsEncrypt certificates.

Requirements

To run this ansible playbook, you need to:

• Have a DigitalOcean Account where this will run.
• Create a DigitalOcean API Key which will need to be set in your terminal sessions environment variables export DO_API_TOKEN
• doctl command line client configured (run doctl auth init)
• Create a DigitalOcean Spaces API Key which will also need to be set in your terminal sessions environment variables, which should be set as DO_AWS_ACCESS_KEY and DO_AWS_SECRET_KEY
• Configure a DNS A Record and CNAME record.
• Install Ansible on your local machine (the control machine).

Install

1. Clone the repo:

git clone https://github.com/webrecorder/browsertrix-cloud.git
cd browsertrix-cloud

2. Look at the configuration options and modify them or pass them as extra variables as shown below. If you haven't configured kubectl, please enable the configure_kube option

3. Run the playbook:

ansible-playbook playbooks/do_setup.yml -e project_name="your-project" -e superuser_email="you@yourdomain.com" -e domain="yourdomain.com"

Upgrading

1. Run git pull

2. Run the playbook:

ansible-playbook playbooks/do_setup.yml -e project_name="your-project" -e superuser_email="you@yourdomain.com" -e domain_name="yourdomain.com" -t helm_upgrade