Skip to content

docs/coding-rules: add cross-cutting-0061 on slap-configuration in cron-read files

Adds coding rule cross-cutting-0061: a file read at run time by a cron job or long-running process must not be rendered by a buildout section that references ${slap-configuration:...}.

slapos.recipe.template resolves references when the section is created, so the reference makes the section depend on slap-configuration, whose timestamp changes on every bang. buildout folds a dependency's values into the section signature, so every bang reinstalls the section, deleting and recreating the file and breaking whatever reads it in between. Route the value through a stable section instead.

Drawn from rapid-cdn !2142, which fixed an intermittent test_ssl_ca_crt failure caused this way.

Added to rules.jsonl and rendered into cross-cutting.md via place-rules. Status soft (single MR). The other area files were left untouched (only their generated-date footer would have changed).

Merge request reports