stado service directory publish
Invocation
stado service directory publish [OPTIONS]Purpose
Write this machine's forward markers from the directory. Several products resolve a service's address from an owner-only file under `~/.stado/forwards/<service>.local` rather than an environment variable - Skarbiec's credential bridge reads `skarbiec.local`, and `weles-admission.local` the same way. Nothing wrote those files. They were produced by hand, which is why one on this fleet named a port no service has ever bound while the directory held the right answer for the same host all along. The address is per-caller, so this resolves for the asking target and writes only what the directory declares. A service with no endpoint for this machine is reported and skipped, never guessed. Markers the directory does not declare are reported as `fossil` on every run and removed only under `--prune`. Nothing has ever removed one: operator-host carries 11 markers of which the directory declares 3, including three different names for one endpoint and two different ports for one relationship, and a consumer holding an old name resolves it forever.
Required inputs and options
| Input or option | Contract |
|---|---|
--service <SERVICE> | Publish one service instead of every declared endpoint |
--target <TARGET> | Resolve as this target instead of this machine |
--prune | Delete the markers the directory does not declare. Without this they are only reported: a marker is an address something on this host dials, and removing one by default makes a publish a reaper |
--json | Command option; required or optional as shown in the invocation. |
Output and state effect
It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.
Refusals
- Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.