2.3 KiB
ADR-0170: Explicit DEV worker placement
Status and scope
Accepted operational clarification, 2026-10-19, from the maintainer's requirement
that DEV workloads run in evolution-dev and never on the control plane. Extends
ADR-0076/0088 without changing biological rules, node labels, storage placement,
database endpoints, credentials, URLs or World0 policy.
Decision
Apply a reusable Kustomize component to the full DEV application and its
standalone region/store overlays. Every current DEV Deployment and Job requires
nodes without either node-role.kubernetes.io/control-plane or the older
node-role.kubernetes.io/master label. Both exclusions belong to the same
required selector term. Existing store selectors, volumes and resource settings
remain. No control-plane toleration or node selector override is introduced.
The rendered deployment policy requires both exclusions in every required
node-affinity term, since terms are alternatives. It also refuses explicit
nodeName, which bypasses scheduler selection. Future DEV workload kinds must
provide the same restriction before passing the policy. Shared bases, stage,
monitoring and operator-only inventory examples keep their existing scope.
Alternatives and consequences
Relying only on common control-plane taints is weaker than the explicit requirement: taints are external cluster configuration. Replacing the store selector with a particular hostname would couple the application to an unknown node and could strand its node-local volume. Required negative role affinity preserves current placement constraints while preventing scheduling onto a correctly role-labelled control plane.
If no eligible worker owns the existing volume, pods remain Pending. Do not relax the rule or move retained storage merely to obtain readiness. Cluster role labels remain an infrastructure responsibility; offline rendering cannot verify their truth or prove a running pod's placement.
Delivery uses the existing Git Actions -> Harbor -> ArgoCD -> Kubernetes flow.
Qualify effective rendered objects and adversarial patches (removed affinity,
missing legacy-role exclusion, unrestricted OR term and direct nodeName).
Record actual rollout, placement and target-host measurements separately. No
direct deployment, live reachability or M12 completion is inferred from a push.