diff --git a/docs/deploy.md b/docs/deploy.md index 175d075..f4ed237 100644 --- a/docs/deploy.md +++ b/docs/deploy.md @@ -303,13 +303,25 @@ getent hosts api.pulse.noelsabia.dev || echo 'api: no DNS record yet (expected)' 1. Open Cloudflare **Zero Trust → Networks → Tunnels → Create a tunnel**. 2. Connector: **Cloudflared**. Name: `pulsecast-gate1`. -3. Save and copy the tunnel token. It is shown once. -4. Open the tunnel's **Public Hostnames** tab and add: +3. Copy the tunnel token from the connector install command. It is the long + `eyJ...` string after `--token` (or after `service install`). It is + sensitive: never paste it into chat, a commit, or a screenshot. The tunnel + stays **Inactive** with 0 routes until the connector Deployment is running; + routes can be added while it is inactive. +4. Open the tunnel and click the **Routes** tab (not Overview, and not + **Add a replica**). Click **Add route** or **Add a public hostname**, choose + **Public hostname**, and add: - | Public hostname | Service | - |---|---| - | `pulse.noelsabia.dev` | `http://hello:8080` (temporary, Gate 1-A) | - | `api.pulse.noelsabia.dev` | `http://api:8080` (works after Step 10) | + | Subdomain | Domain | Path | Service type | Service URL | + |---|---|---|---|---| + | `pulse` | `noelsabia.dev` | *(empty)* | HTTP | `hello:8080` | + | `api.pulse` | `noelsabia.dev` | *(empty)* | HTTP | `api:8080` | + + The first route is temporary for Gate 1-A. For the final Gate 1-B route, + change it to `web:3000` after the web image is deployed. If you already have + the web image, you may set `web:3000` now and skip the hello route; then the + public hello check in Step 6 is not available, but the tunnel proof still + happens when the real web pod is Ready. For the final Gate 1-B route, change `pulse.noelsabia.dev` to `http://web:3000` after the web image is deployed. If you already have the