Module compute_planner 

Deployment-time compute planner.

The planner turns portable stack requirements plus a target platform into a renderable set of recommended deployment choices. It does not mutate the stack and does not require database access.

Structs

ComputeMachineOption

One concrete provider machine option.

ComputePlan

Full compute plan for one stack/platform pair.

ComputePoolPlan

Planner output for one compute pool.

ContainerResourcePlan

Deployment-time resource controls and effective allocation for one container.

Constants

GENERATED_POOL_MAX_MACHINES

Machine count up to which a setup offers choices for a pool the source does not declare.

Functions

capacity_group_requirements

Convert a capacity group declaration into planner requirements.

check_pool_capacity

Rejects a selection whose largest fleet cannot hold the workloads at their desired replica counts after reserving host resources. It also checks that one replica fits; arbitrary multi-replica packing can still require runtime validation.

default_persistent_failure_domains

Failure-domain policy for a pool that hosts persistent stateful workloads when the deployment does not choose one: one provider-selected domain, so the pool’s machines and their volumes land in the same zone.

generated_pool_scale_policy

Allowed scale for a pool that no capacity group declares.

plan_compute

Compute a deterministic deployment-time plan.

plan_compute_with_state

Plan a configuration update while retaining the installed machine architecture. Resource changes must not silently require a different workload image target.

validate_compute_pool_selection

Validate one selected compute pool against platform machine requirements and source-declared scale bounds.