Repository navigation
Converge one Domain in domains.yml and record the previous vhost hash (S-004-2, 11, 12, 13, 17) #116
Description
Builds part of spec S-004, docs/specs/004-domains-apply.md (feature issue #87): the acceptance criteria below. Each needs a test that names its id (test_s004_<k>_..., or a proves: S-004-2 comment line).
This is the engine side: domains.yml limited to one Domain, and the receipt's previousConfigurationSha256.
- S-004-2: With Domains
d1andd2both proxied ona,domains apply d1 --yesrenders onlyd1'sproxy.configurationPath, andd2's vhost file and receipt are unchanged - S-004-11: A
domains.ymlrun on a proxy server with a hand-written file atproxy.configurationPathwrites a receipt whosepreviousConfigurationSha256is that file's sha256, and a run with no file there writesnull - S-004-12: A
DeploymentReceiptwithoutpreviousConfigurationSha256still loads inservices status - S-004-13: A vhost that
nginx -trejects makesdomains apply <d> --yesexitENGINE_STEP_FAILED - S-004-17: The
converge_domainstool called withdomain: <d>runs only ond's proxy server and renders onlyd, called withoutdomainruns on every server incloudfall_serversas before, and called with an unknowndomainexitsPRECONDITION
Activity
migrate, which converges every server #87shipmill-romamo commentedon Oct 27, 2026
Triage: implement, for the next release candidate.
The plan: build the criteria listed in the body, as
docs/specs/004-domains-apply.md(S-004, approved in #100) says, each with a test that names its id. A departure from a criterion goes back as a question, never a quiet change. Build issues start in order: this one starts once every issue on itsDepends onlines has closed. I'll link the PR here.shipmill-romamo commentedon Oct 27, 2026
The build is in #133:
domains.ymlcan render one Domain, theconverge_domainstool takes an optionaldomainand runs only on its proxy server, and every domain receipt recordspreviousConfigurationSha256(optional, so older receipts still load). Withoutdomain, the tool runs exactly as before. Proven with engine tests; no live nginx run yet. This issue closes when #133 merges.Converge one Domain and record the vhost a run replaced
shipmill-romamo commentedon Oct 27, 2026
Released in v0.8.0rc6 (pre-release). uv tool install --prerelease allow cloudfall==0.8.0rc6
A plain install gets it with the next stable release.
If you filed this: react 👍 on this comment once it works for you, or reply if it doesn't.