mirror of
https://github.com/nestriness/nestri.git
synced 2026-09-19 17:25:19 +03:00
feat(deploy): drop the IaC layer, and make both apps runnable as containers
Moving the issuer's state into Postgres removed the last thing that tied either app to one hosting provider. What was left was a deployment tool describing resources that no longer existed — so this replaces it with `wrangler`, which is what actually deploys a Worker, and adds a second way to run each app that involves no provider at all. Each app now has a `wrangler.jsonc` with an environment per stage, and a `Dockerfile` beside it. The handler is the same one in both cases; what differs is only where its settings come from. Two of them gained a second spelling so that nothing has to branch on the runtime: Postgres arrives as a pooled binding or as `DATABASE_URL`, and the route to the issuer is a service binding or `AUTH_INTERNAL_URL`. That last one is new, and it is a split the binding was already making without saying so. `AUTH_ISSUER_URL` has to be the issuer's public name, because it is compared literally against every token's `iss` claim — but the public name is often not routable from inside a deployment. So the name and the route are two settings now rather than one that cannot be both. DNS moves out of code and into `docs/dns.md`, which lists every hostname and what it is for. Six records that change roughly never did not need a tool, and the table outlives whatever is answering the names — which is the point, since some of them will stop being Workers. The sandbox hostnames are hyphenated rather than nested for the same reason: a certificate covering `*.nestri.io` covers one label and not two, so `api-sandbox.nestri.io` can become an ordinary origin later without a certificate having to be ordered for it first. Also drops `EMAIL_DEV_LOG` from committed configuration into `.dev.vars`, which `wrangler deploy` cannot upload. Printing a live sign-in code to a log should not be one forgotten override away from production.
This commit is contained in:
69
docs/dns.md
Normal file
69
docs/dns.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# DNS
|
||||
|
||||
Cloudflare holds the zones. Once the control plane moves off Workers that is
|
||||
the only thing it holds, so this file is deliberately written to survive the
|
||||
move: it says what each name **is for**, and treats what currently answers it
|
||||
as a detail that changes.
|
||||
|
||||
There is no infrastructure-as-code here, on purpose. There are six records.
|
||||
They change roughly never, they outlive several generations of whatever serves
|
||||
them, and the failure mode of getting one wrong is that sign-in stops working
|
||||
for everybody — which is a thing to do slowly, by hand, having read this table,
|
||||
rather than as a side effect of a deploy. What *is* automated is only the part
|
||||
that must stay in step with a deploy: while the control plane is a set of
|
||||
Workers, `wrangler` creates and owns the four control-plane records itself,
|
||||
because a route and its hostname are one fact and splitting them across two
|
||||
tools is how they drift.
|
||||
|
||||
## The rule
|
||||
|
||||
**One label deep on `nestri.io`.** A certificate for `*.nestri.io` covers
|
||||
`api-sandbox.nestri.io` and does not cover `api.sandbox.nestri.io`, and that is
|
||||
the whole reason the sandbox names are hyphenated rather than nested. It costs
|
||||
nothing while these are Workers — a custom domain gets its own certificate for
|
||||
the exact hostname either way — and it is what lets any of these names become
|
||||
an ordinary proxied origin later without also needing a certificate ordered for
|
||||
it. A name should not have to change because the thing behind it did.
|
||||
|
||||
## `nestri.io`
|
||||
|
||||
| Name | What it is | Answered today by |
|
||||
| ------------------------ | --------------------------------- | ----------------------- |
|
||||
| `api.nestri.io` | The API, production | Worker custom domain |
|
||||
| `auth.nestri.io` | The issuer, production | Worker custom domain |
|
||||
| `api-sandbox.nestri.io` | The API, sandbox | Worker custom domain |
|
||||
| `auth-sandbox.nestri.io` | The issuer, sandbox | Worker custom domain |
|
||||
| `doctor.nestri.io` | Where `nesdoctor` is downloaded | Static site |
|
||||
| `nestri.io` | The website, and `ssh nestri.io` | Website |
|
||||
|
||||
`auth.nestri.io` is the one name that cannot be changed casually. A token
|
||||
carries the address it was minted through in its `iss` claim, and every API
|
||||
request verifies that claim literally — so renaming the issuer invalidates
|
||||
every token in circulation at once, including the refresh tokens that would
|
||||
otherwise have recovered from it.
|
||||
|
||||
## After the move off Workers
|
||||
|
||||
Each of the first four becomes a proxied `A` record pointing at the host
|
||||
running the containers, and nothing else about them changes: same names, same
|
||||
certificates, same `iss` claim. Cloudflare keeps terminating public TLS, so
|
||||
there is no certificate on our own host to renew, and the origin is not
|
||||
addressable except through the proxy.
|
||||
|
||||
The order that matters, on the day: create the `A` records with the proxy on,
|
||||
confirm the containers answer through them, *then* remove the Worker routes.
|
||||
Doing it the other way leaves a window where the name resolves to nothing.
|
||||
|
||||
## `nestri.link`
|
||||
|
||||
A second zone, reserved and not yet serving anything. It exists so that a
|
||||
per-box hostname — one name, one box, the address a person opens to set their
|
||||
box up — never has to live under `nestri.io` beside the control plane. Two
|
||||
reasons, both of which get worse to fix later than to decide now: a box serves
|
||||
content we do not write, and cookie scope is a property of the registrable
|
||||
domain, so a name under `nestri.io` would put that content inside the same
|
||||
cookie boundary as sign-in.
|
||||
|
||||
`*.nestri.link` will be proxied for the same reason the control plane is: the
|
||||
public certificate stays Cloudflare's, and the only key on our own host is an
|
||||
origin certificate that is useless anywhere else.
|
||||
Reference in New Issue
Block a user