android_cast/backend/url-shortener/DEPLOY.md

URL shortener — deploy (FE → BE)

Topology: same as INFRA.md — TLS on Gentoo FE, app on Alpine BE :80.

Prerequisites (confirmed)

Item	Status
DNS s.f0xx.org → FE	PO
FE TLS cert	/etc/letsencrypt/live/s.f0xx.org/
Git remote	git://f0xx.org/androicast_project/url-shortener
MariaDB schema url_shortener	sql/schema.mariadb.sql

FE (Gentoo)

Add deploy/nginx.fe-s.f0xx.org.snippet inside a new server { listen 443 ssl; server_name s.f0xx.org; } block
(mirror apps.f0xx.org TLS paths; cert paths above).

nginx -t && rc-service nginx reload

BE (Alpine)

1. Sync this tree to docroot (suggested): /var/www/localhost/htdocs/apps/s/
2. Include deploy/nginx.be-url-shortener.fragment in apps.conf or dedicated server_name on BE
3. Apply SQL migration
4. rc-service php-fpm81 restart if needed

nginx -t && rc-service nginx reload

Alpine/nginx note: regex locations with {n,m} quantifiers must be double-quoted or nginx parses { as a block delimiter (nginx: [emerg] improper regexp).

Verify

curl -sSI https://s.f0xx.org/api/v1/health
./scripts/smoke_shorten.sh

Not added to validate_be_services.sh until first production deploy (SPEC).