Saphan StudioDocs
Reference/Commands

saphan verify-deploy

Verifies a deployment end to end and reports PASS only with proof for every step: it records the artifact's digest, builds, checks that the digest changed, runs the rollout, then requires the live hea

Verifies a deployment end to end and reports PASS only with proof for every step: it records the artifact's digest, builds, checks that the digest changed, runs the rollout, then requires the live health URL to answer with a 2xx status. ⚠ The rollout is real: this command performs the deployment it verifies. A failed step stops the pipeline with the verdict STOP (exit 2), and the remaining steps are marked skipped. Commands and the URL come from flags or from a project configuration file named with --config; flags win. Each command is split into words (quotes respected) and run directly, not through a shell, so pipes and && need a script.

saphan verify-deploy --digest-cmd "./digest.sh" --build-cmd "make image" \
  --rollout-cmd "./rollout.sh" --health-url https://staging.example.test/health
saphan verify-deploy
flagtypedefaultwhat it does
--build-cmdstringThe command that builds the artifact (required, here or in the configuration file).
--configstringA YAML project file whose verify-deploy: section can hold any of these settings; flags override it.
--digest-cmdstringA command that prints the deployable artifact's digest, run before and after the build; an unchanged digest stops the check, while a failure before the build is read as no prior artifact (required).
--health-expectstringOptional text the live health response must contain.
--health-urlstringThe URL that must answer with a 2xx status after the rollout, the live proof (required).
--rollout-cmdstringThe command that performs the rollout (required).
--workdirstringThe directory the commands run in.

Global options apply to every command — see Every command.