Pod scheduling

These settings define how pods are scheduled onto specific nodes

Scheduling optimization policy

Whether or not node affinity is included in recommendation patches depends on the optimization policy selected.

Annotation Default value
live.stormforge.io/pod-scheduling.optimization-policy DoNotOptimize
Description

Optimize Live recommends an instance category for pod scheduling by default, but that recommendation will not be included in patches unless an optimization policy is configured.

Instance category node affinity recommendations can be added to patches by setting the optimization policy to InstanceCategories.

Valid values
  • DoNotOptimize
  • InstanceCategories

Affinity type

Annotation Default value
live.stormforge.io/pod-scheduling.instance-categories.node-affinity.type preferred
Description

Specifies which node affinity type to use when patching in node affinity settings.

Instance category recommendations will only be included in Optimize Live patches if you have configured a specific node affinity type. By default, no node affinity type is configured.

The available settings align with Kubernetes node affinity types.

Valid values
  • preferred – alias for PreferredDuringSchedulingIgnoredDuringExecution
  • required – alias for RequiredDuringSchedulingIgnoredDuringExecution

Affinity weight

Annotation Default value
live.stormforge.io/pod-scheduling.instance-categories.node-affinity.weight "70"
Description

Specifies a weight for a preferred affinity.

This setting has no effect when affinity type is set to required.

Valid values
  • Integer value between 1 and 100 (as a string)

Patch path

Annotation Default value
live.stormforge.io/pod-scheduling.instance-categories.node-affinity.patch-path None
Description

Indicates the absolute JSON pointer path to the field where the value is stored on the patched resource.

This can be used to fine-tune StormForge patching behavior when optimizing custom CRD and operator-owned workload types.

Examples
  • /spec/template/spec/affinity/nodeAffinity

Patch format

Annotation Default value
live.stormforge.io/pod-scheduling.instance-categories.node-affinity.patch-format None
Description

Defines the Go template that formats the value for the patched resource.

This can be used to fine-tune StormForge patching behavior when optimizing custom CRD and operator-owned workload types.

Valid values
  • String

Related topics

Recommendations > Pod scheduling

Automated node affinity for proportional resource scheduling

Last modified April 3, 2025