CLI reference / placement

stado placement

Invocation

stado placement <COMMAND>

Purpose

Atomically relocate a declared service group between registered hosts

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

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.

Subcommands

  • move — Relocate one complete service group to another registered host, or, with --authority, take the registry authority role on --to-host while the declared authority does not answer
  • evict — Stop an instance running where the directory places nothing
  • standby — Make a registered host a place this profile may move to: deliver each service's program (a managed program now; a release-controlled tree through the host's own agent), stage each unit rendered from the service catalog where the move starts it (installed, not loaded, not declared), and write the host into the profile and the directory once every unit is staged. Idempotent; a unit already running on the host is refused as a second active copy, and a pass that stops at a pending rollout says so and the next pass continues