jcloude/press/playbooks/roles/frankfurter/README.md

Guide to Setup Frankfurter

Install Docker

Setup Docker Repository

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

Install Docker

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Reference: https://docs.docker.com/engine/install/ubuntu/

Install Frankfurter

Copy docker-compose.yml from /templates/.

The compose configuration (docker-compose.yml) is prepared to match the docker run command from the docs

docker run -d -p 8080:8080 -e "DATABASE_URL=<postgres_url>"  --name frankfurter hakanensari/frankfurter

Start Frankfurter

docker compose up -d

Setup TLS

Setup NGINX

Place a minimal server block in /etc/nginx/conf.d

server {
	server_name frankfurter.frappe.cloud;
    location / {
        proxy_pass http://127.0.0.1:8080;
    }
}

Remove Default NGINX site

rm /etc/nginx/sites-enabled/default
rm /etc/nginx/sites-available/default
rm -rf /usr/share/nginx/html/

Setup Certbot

sudo python3 -m venv /opt/certbot/
sudo /opt/certbot/bin/pip install certbot
ln -s /opt/certbot/bin/certbot /usr/bin/certbot
certbot --nginx

Setup Certbot renewal cronjob

echo "0 0,12 * * * root /opt/certbot/bin/python -c 'import random; import time; time.sleep(random.random() * 3600)' && sudo certbot renew -q" | sudo tee -a /etc/crontab > /dev/null

Reference: https://certbot.eff.org/instructions?ws=nginx&os=ubuntufocal

Add frankfurter to blocked subdomains on FrappeCloud.com

https://jcloud.jingrow.com/app/blocked-domain/frankfurter

Done

curl -s https://frankfurter.frappe.cloud/latest | jq

{
  "amount": 1.0,
  "base": "EUR",
  "date": "2024-10-04",
  "rates": {
    "AUD": 1.6121,
    "CHF": 0.9394,
    "GBP": 0.83735,
    "INR": 92.61,
    "JPY": 161.69,
    "SGD": 1.4314,
    "USD": 1.1029,
    "ZAR": 19.2809
  }
}