diff --git a/fleet/PROTOCOL.md b/fleet/PROTOCOL.md index 03cdbad24..ef38a6bde 100644 --- a/fleet/PROTOCOL.md +++ b/fleet/PROTOCOL.md @@ -388,7 +388,11 @@ tiles rounded up, whichever is smaller), and a claim when no tile can be lent. and `failures` carry it. - `aggregates` lists the regions an aggregator serves (see Aggregator): one per GPU host that has placed tiles, with the tiles inside it, and the EC2 half when the coordinator - runs its aggregator. `frame_url` is null until the host's aggregator is serving. + runs its aggregator. `frame_url` is null until the host's aggregator is serving. With + the coordinator's DNS (`--dns-token-secret`) a host aggregator's `frame_url` and + `frame_url_v4` are its published names (`wss://agg--./frames`, + `wss://agg---v4.:/frames`), and both stay null for an aggregator + that serves no browser (no `--aggregate-tls-port`). - `actions` holds the latest 50 intents, committed and refused, oldest first: the `viewer` that sent it, the intent `id`, its `args` (a refused word's are `{}`, so its text appears nowhere), and the outcome. @@ -410,7 +414,8 @@ relaunching (its region would be black; claimed GPUs and dark tiles do not count fcvm fleet coord --listen [--agent-cmd '']... [--state-file ] [--text-check bedrock --text-check-model --text-check-region | --text-check none] [--max-tiles 100] [--ec2 none|fake] [--allowed-origin ]... - [--ec2-aggregate-listen --ec2-aggregate-url ] [--aggregate-arg ]... + [--ec2-aggregate-listen (--ec2-aggregate-url | --ec2-aggregate-tls + [--ec2-aggregate-tls-dir /run/fcvm-fleet/tls])] [--aggregate-arg ]... [--race-every ] [--restart-cooldown 60] [--camera-seed 1] [--max-borrowed ] [--trust-cf-connecting-ip] [--turnstile-secret --turnstile-site-key ] [--admin-listen ] [--ffmpeg ffmpeg] @@ -470,8 +475,12 @@ fcvm fleet coord --listen [--agent-cmd '']... [--state-file asked for before it exists and never changes address, so no resolver holds a negative or stale answer for it. A launch's records stay until its slot has a newer published launch or leaves the fleet; names of the fleet's shape (`slot-`, `ec2-`, with or without a - token, with or without `-v4`) that nothing references are deleted, at start too; every - other name in the zone is left alone. + token, `agg--`, each with or without `-v4`) that nothing references are + deleted, at start too; every other name in the zone is left alone. A host aggregator + that reports public addresses is named the same way under `agg--` (a host + name of lowercase letters, digits and inner hyphens, at most 40 characters): AAAA its own + IPv6 address, A the host's IPv4 address, with its port in `frame_url_v4`. Its names last + while it reports the same addresses. - `--dns-subzone` makes the coordinator the authoritative DNS server of a subzone of `--dns-zone` (the parent delegates it with NS records naming `--dns-subzone-ns`, and no DS record) and names launches there instead: `