CLI reference / service / directory / publish

stado service directory publish

Invocation

stado service directory publish [OPTIONS]

Purpose

Write this machine's forward markers from the directory. Publishes declared per-caller endpoints for consumers of forward markers. Undeclared markers are reported, and removed only with `--prune`.

Required inputs and options

Input or optionContract
--service <SERVICE>Publish one service instead of every declared endpoint
--target <TARGET>Resolve as this target instead of this machine
--pruneDelete 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
--jsonCommand 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.