Zero-downtime Fly.io deploys (#132)

## Summary
- Start nginx after Tailscale connects (community best practice for Tailscale sidecars)
- Switch to `bluegreen` deploy strategy — old machine serves until new one is healthy
- Replace top-level `[checks]` with `[[http_service.checks]]` — only service-level checks gate traffic routing ([confirmed by Fly.io staff](https://community.fly.io/t/clarifying-the-types-of-health-checks/20379))
- Remove sentinel file and nginx if-check (no longer needed)

Supersedes the approach in #131 — that helped (502 window dropped from ~30s to ~3s) but couldn't fully eliminate it because top-level checks don't gate routing and Fly.io's proxy sends traffic as soon as the port is reachable.

## Deployment and Testing
- [ ] Merge and `fly deploy` from `fly/` directory
- [ ] Verify deploy completes with zero 502s (watch `fly logs` and Grafana docs-apm)
- [ ] Confirm `fly checks list` shows the new service-level check passing

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/132

docs/changelog.d/fix-zero-downtime-deploy.infra.md

@@ -0,0 +1 @@
+Eliminate 502 errors during Fly.io proxy deploys by starting nginx after Tailscale, switching to bluegreen deploys, and using service-level health checks for traffic gating.

fly/fly.toml

@@ -3,6 +3,9 @@ primary_region = "sjc"
 
 [build]
 
+[deploy]
+strategy = "bluegreen"
+
 [http_service]
 internal_port = 8080
 force_https = true
@@ -10,10 +13,9 @@ auto_stop_machines = "off"
 auto_start_machines = true
 min_machines_running = 1
 
-[checks]
+[[http_service.checks]]
-[checks.health]
+grace_period = "15s"
-port = 8080
+interval = "10s"
-type = "http"
+method = "GET"
-interval = "30s"
-timeout = "5s"
 path = "/healthz"
+timeout = "5s"

fly/nginx.conf

@@ -34,8 +34,8 @@ http {
                      max_size=200m inactive=24h;
 
     # MagicDNS resolver — using a variable in proxy_pass defers upstream DNS
-    # resolution to request time, letting nginx start before Tailscale connects.
+    # resolution to request time (not config time). Results are cached for
-    # Results are cached for 30s per worker to avoid per-request DNS lookups.
+    # 30s per worker to avoid per-request DNS lookups.
     resolver 100.100.100.100 valid=30s;
     resolver_timeout 5s;
 
@@ -76,9 +76,6 @@ http {
         listen 8080 default_server;
 
         location /healthz {
-            if (!-f /tmp/tailscale-ready) {
-                return 503 "starting\n";
-            }
             return 200 "ok\n";
         }
 

fly/start.sh

@@ -1,26 +1,22 @@
 #!/bin/sh
 set -e
 
-# Start nginx immediately so port 8080 is bound (avoids connection refused).
+# Connect to tailnet first — nginx needs MagicDNS for upstream resolution.
-# Health check returns 503 until /tmp/tailscale-ready exists, so Fly.io
+# With bluegreen deploys, the old machine serves traffic until this one is
-# keeps the old machine serving traffic until Tailscale connects.
+# fully ready. Fly.io runs Firecracker microVMs that support TUN devices
-nginx -g "daemon off;" &
+# natively — no need for --tun=userspace-networking.
-NGINX_PID=$!
-echo "Nginx started (waiting for Tailscale before proxying)"
-
-# Start tailscale daemon. Fly.io runs Firecracker microVMs which support
-# TUN devices natively — no need for --tun=userspace-networking.
 tailscaled --statedir=/var/lib/tailscale &
 sleep 2
 
-# Authenticate and join tailnet
 tailscale up --authkey="${TS_AUTHKEY}" --hostname=flyio-proxy
-
-# Wait for tailscale to be ready, then signal nginx health check
 until tailscale status > /dev/null 2>&1; do sleep 1; done
-touch /tmp/tailscale-ready
 echo "Tailscale connected"
 
+# Start nginx — MagicDNS is available, health check passes immediately.
+nginx -g "daemon off;" &
+NGINX_PID=$!
+echo "Nginx started"
+
 # Start Alloy for observability (logs → Loki, metrics → Prometheus)
 alloy run /etc/alloy/config.alloy \
     --server.http.listen-addr=127.0.0.1:12345 \