Files
computer-playbook/cli/administration/deploy/development/inventory/legacy_resolver.py
T
kevinveenbirkenbachandClaude Opus 5 5b8465260f feat(ci): deploy only the variants a change reaches
An image bump in a provider redeployed every variant of every consumer,
including the variants that switch that provider off and therefore never
deploy the bumped image at all. The diff-derived whitelist now narrows each
affected role to the variants whose own round closure still reaches a seed,
emitted as `role#0,2` selection tokens. That closure is walked on the same
variant-merged services maps the matrix planner builds its rounds from, so the
narrowing follows a parent's variant choice across every generation of the
chain. It covers every auto-derived whitelist: the weekly update PRs,
Dependabot, and any other diff-driven run.

The narrowing never shrinks the matrix on partial information. A seed role
keeps every variant, because its own files changed. A role reached only
through a run_after edge keeps every variant too, because the round closure
does not follow that edge and a role whose hits are empty is therefore
unnarrowed rather than dropped.

A pinned token naming a role the discovery query does not return now warns
instead of aborting the run. The diff-derived whitelist legitimately names
roles the lifecycle envelope filters out, and once it pins variants such a
token would abort every chunk; role names are still checked against roles/
before the run starts, so a typo is caught one layer earlier.

The round's variant merge moves out of the deploy inventory package into
utils/roles/applications/variants.py. The CI selection has to build the same
maps, and importing the deploy package for them pulls in a module that reads
INFINITO_SRC_DIR at import time, which the runner host does not set.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-21 22:51:03 +02:00

113 lines
4.1 KiB
Python

"""Default (non-variant) include resolution for the matrix planner.
When NO primary app ships a `meta/variants.yml`, the planner falls back
to this path — the `CombinedResolver` walks `dependencies` and
`shared:`-edges in the variant-merged services map and Jinja flags are
evaluated at deploy time against `group_names`. `run_after` is NOT
followed for inclusion (it is a pure ordering hint), so a variant that
disables a service does not get the provider re-added through the
ordering edge. This module owns the include resolution that path needs
and nothing else; the round's variant-merged services maps come from
`utils.roles.applications.variants`, which the CI selection resolves its
closure from as well.
"""
from __future__ import annotations
from typing import TYPE_CHECKING
from utils.roles.applications.variants import services_overrides_for_round
if TYPE_CHECKING:
from collections.abc import Iterable, Sequence
_build_services_overrides_for_round = services_overrides_for_round
def _resolve_round_include(
*,
primary_apps: Sequence[str],
services_overrides: dict[str, dict],
) -> tuple[str, ...]:
"""Resolve transitive prerequisites for each primary app under a
round's variant-merged services map. Returns the full include set
in stable order (deps first per primary, primary last; primaries
iterated in the user-provided order).
The resolver import is deferred so the host-side import surface
stays lean for callers that never need the variant-aware planner
(e.g. lint/validation).
"""
from cli.meta.roles.applications.resolution.combined.resolver import (
CombinedResolver,
)
resolver = CombinedResolver(
services_overrides=services_overrides, follow_run_after=False
)
out: list[str] = []
seen: set[str] = set()
for app_id in primary_apps:
deps = resolver.resolve(app_id)
for dep in deps:
if dep != app_id and dep not in seen:
out.append(dep)
seen.add(dep)
if app_id not in seen:
out.append(app_id)
seen.add(app_id)
return tuple(out)
def prune_orphans_after_disable(
*,
include: Sequence[str],
primary_apps: Sequence[str],
disabled_app_ids: Iterable[str],
services_overrides: dict[str, dict],
) -> tuple[tuple[str, ...], tuple[str, ...]]:
"""Split a round's ``include`` into ``(kept, pruned)`` after `disable`.
`kept` are the members still reachable from a surviving primary app
once every role in `disabled_app_ids` is cut from the graph; `pruned`
are the orphaned remainder (the disabled roots themselves excluded).
Reachability walks the same `dependencies` + `services` edges the
round's closure was built from — `run_after` is NOT followed, matching
``CombinedResolver(follow_run_after=False)`` — using `services_overrides`
so the variant-merged topology matches what the inventory bakes.
Returned order follows `include` for both tuples.
Args:
include: the round's full closure (deps-first, primary last).
primary_apps: the operator-selected roots (already `disable`-filtered).
disabled_app_ids: provider roles cut by `disable`.
services_overrides: round variant-merged services maps per role.
"""
from cli.meta.roles.applications.resolution.combined.resolver import (
CombinedResolver,
)
disabled = set(disabled_app_ids)
resolver = CombinedResolver(
services_overrides=services_overrides, follow_run_after=False
)
reachable: set[str] = set()
stack = [a for a in primary_apps if a not in disabled]
while stack:
node = stack.pop()
if node in reachable or node in disabled:
continue
reachable.add(node)
edges = resolver.edges_for(node)
stack.extend(
dep
for dep in (*edges.dependencies, *edges.services)
if dep not in reachable and dep not in disabled
)
kept = tuple(role for role in include if role in reachable)
pruned = tuple(
role for role in include if role not in reachable and role not in disabled
)
return kept, pruned