CLI reference / service / directory / connect

stado service directory connect

Invocation

stado service directory connect [OPTIONS] <NAME>

Purpose

A usable route to one service, derived from where it is placed. `endpoint` reports what the directory was told; this works out what is true. The service is placed on exactly one host, so the address is a function of that placement and of who is asking: loopback when the asker is the placed host, and the placed host's routable address otherwise. Nothing per-caller is stored, so moving the service moves every caller with it. There is no other address. If the service is placed somewhere that does not answer, that is what this says -- resolving to something local instead is how a caller ends up talking to a process nobody placed.

Required inputs and options

Input or optionContract
<NAME>Service name as the directory keys it, e.g. `brama`
--target <TARGET>Resolve as this target instead of this machine
--consumer <CONSUMER>Which declared consumer is calling. Selects among this machine's resolver adapters when a service is bound once per consumer
--no-verifyReport the address without proving anything answers there
--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.