Apply and manage Pod rightsizing with CLI

This section describes how to apply and manage Pod rightsizing from the cluster using the CLI.

Pod rightsizing is configured declaratively using Kubernetes Policy custom resources (CRs). A policy defines Pod rightsizing behavior and how the policy selects workloads.

Policies select workloads using an appList selector, label selectors, or a policy annotation on the workload.

Each workload is managed by at most one policy at a time. When multiple policies match the same workload, precedence rules determine which policy manages it.

If no policy manages a workload, Pod rightsizing is not applied to it.

Workflow description

Use the following workflow to apply Pod rightsizing from the cluster:

1. Select a policy (built-in or custom).

2. Define workload selection (by using appList or appSelector label selectors, or a workload policy annotation).

3. Update the Policy resource in the cluster so the updated selectors and parameters take effect.

Kompass provides built-in policies, and you can also create custom policies.

The built-in policies - Balanced, Stability-focused, and Cost-focused - are described in Pod rightsizing workload optimization. You can see their fixed parameters at Built-in policy fixed parameter values.

You cannot delete or change built-in policies parameters.

To manage a workload by policy, you edit the policy workload selection and priority values, as described in Apply Pod rightsizing to workloads - CLI.

You can also create a custom policy by duplicating an existing policy. With a custom policy, you have full control of all parameters.

For information about creating, editing, and deleting a custom policy, see Manage custom policies.

Configuration sample

Values inside [ ] are user-specified placeholders.

spec:
  appList: []
  appSelector:
    labels: {}
    namespaces:
      operator: Include
      values: []
  cooldownPeriod: 0s
  cpu:
    bufferPercentage: 30
    ignoreThrottlingEvent: false
    minimumImpactPercentage: 10
    minimumStepForScaleUp: 100m
    minimumValueForScaleDown: 10m
    optimizationStrategy: max
    replicaAggregationMethod: max
  dataCoveragePercentage: 80
  evictPodsInDefferedState: false
  lookbackPeriod: 5m
  memory:
    bufferPercentage: 40
    ignoreOomEvent: false
    minimumImpactPercentage: 10
    minimumStepForScaleUp: 256Mi
    minimumValueForScaleDown: 256Mi
    optimizationStrategy: max
    replicaAggregationMethod: max
  preferInPlace: true
  priority: 2

Policy parameters reference

All parameters are validated when a policy is created or updated. Policies with missing or invalid parameters cannot be applied.

Define custom replica aggregation method values

You can define custom values for the CPU and memory replica aggregation method. This can be useful if the fixed values are overly aggressive.

To define custom aggregation method figures, you define values for custom1 and custom2 in Helm values.yaml, then define the value in the policy configuration as custom value 1 or custom value 2.

To define custom values:

1. Add the custom definition to Helm values.yaml:

   rightsizing:
     config:
       customReplicaAggregationMethods:
         cpu:
           custom1: 70
           custom2: 71
         memory:
           custom1: 80
           custom2: 81
   

   Note that both CPU and memory are in the same section.

2. In the policy on the cluster, change the value to the desired value.

   For example, to set the memory value to 80, change the value in the policy spec.memory.replicaAggregationMethod to custom value 1.

See also:

• Apply Pod rightsizing to workloads - CLI

• Manage policies for Pod rightsizing - CLI