From 2eacb6269670b94c17bb979d84dd7ead9db693fc Mon Sep 17 00:00:00 2001 From: Noel Sabia Date: Sat, 14 Nov 2026 06:31:11 +0100 Subject: [PATCH] docs: match current Cloudflare Routes UI Public hostnames are under the tunnel Routes tab, not an Overview action. Record that the tunnel stays Inactive until the connector runs and that the token comes from the install command. --- docs/deploy.md | 24 ++++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) 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