#Handling Out of Resource Errors

#Overview

This guide describes how to prevent Alauda Container Platform nodes from running out of memory (OOM) or disk space. Stable node operation is critical, especially for non-compressible resources like memory and disk. Resource exhaustion can lead to node instability.

Administrators can configure eviction policies to monitor nodes and reclaim resources before stability is compromised.

This document covers how Alauda Container Platform handles out-of-resource scenarios, including resource reclamation, pod eviction, pod scheduling, and the Out of Memory Killer. Example configurations and best practices are also provided.

#Configuring Eviction Policies

Eviction policies allow nodes to terminate pods when resources are low, reclaiming needed resources. Policies combine eviction signals and threshold values, set in the node configuration or via command line. Evictions can be:

• Hard: Immediate action when a threshold is exceeded.
• Soft: Grace period before action is taken.

Properly configured eviction policies help nodes proactively prevent resource exhaustion.

For disk pressure, nodes monitor both nodefs (root filesystem) and imagefs (container image storage).

• nodefs/rootfs: Used for local disk volumes, logs, and other storage (e.g., /var/lib/kubelet).
• imagefs: Used by the container runtime for images and writable layers.

#Creating Eviction Policies in Node Configuration

To set eviction thresholds, edit the node configuration map under eviction-hard or eviction-soft.

Hard Eviction Example:

kubeletArguments:
  eviction-hard:
    - memory.available<100Mi
    - nodefs.available<10%
    - nodefs.inodesFree<5%
    - imagefs.available<15%
    - imagefs.inodesFree<10%

Soft Eviction Example:

kubeletArguments:
  eviction-soft:
    - memory.available<100Mi
    - nodefs.available<10%
    - nodefs.inodesFree<5%
    - imagefs.available<15%
    - imagefs.inodesFree<10%
  eviction-soft-grace-period:
    - memory.available=1m30s
    - nodefs.available=1m30s
    - nodefs.inodesFree=1m30s
    - imagefs.available=1m30s
    - imagefs.inodesFree=1m30s

Restart the kubelet service for changes to take effect:

$ systemctl restart kubelet

#Eviction Signals

Nodes can trigger evictions based on the following signals:

• inodesFree must be specified as a percentage.
• Memory calculations exclude reclaimable inactive file memory.
• Do not use free -m in containers.

Nodes monitor these filesystems every 10 seconds. Dedicated filesystems for volumes/logs are not monitored.

#Eviction Thresholds

Eviction thresholds trigger resource reclamation. When a threshold is met, the node reports a pressure condition, preventing new pods from being scheduled until resources are reclaimed.

• Hard thresholds: Immediate action.
• Soft thresholds: Action after a grace period.

Thresholds are configured as:

<eviction_signal><operator><quantity>

Example:

• memory.available<1Gi
• memory.available<10%

Nodes evaluate thresholds every 10 seconds.

#Hard Eviction Thresholds

No grace period; immediate action is taken.

Example:

kubeletArguments:
  eviction-hard:
    - memory.available<500Mi
    - nodefs.available<500Mi
    - nodefs.inodesFree<5%
    - imagefs.available<100Mi
    - imagefs.inodesFree<10%

#Default Hard Eviction Thresholds

kubeletArguments:
  eviction-hard:
    - memory.available<100Mi
    - nodefs.available<10%
    - nodefs.inodesFree<5%
    - imagefs.available<15%

#Soft Eviction Thresholds

Soft thresholds require a grace period. Optionally, set a maximum pod termination grace period (eviction-max-pod-grace-period).

Example:

kubeletArguments:
  eviction-soft:
    - memory.available<500Mi
    - nodefs.available<500Mi
    - nodefs.inodesFree<5%
    - imagefs.available<100Mi
    - imagefs.inodesFree<10%
  eviction-soft-grace-period:
    - memory.available=1m30s
    - nodefs.available=1m30s
    - nodefs.inodesFree=1m30s
    - imagefs.available=1m30s
    - imagefs.inodesFree=1m30s

#Configuring Allocatable Resources for Scheduling

Control how much node resource is available for scheduling by setting system-reserved for system daemons. Evictions occur only if pods exceed their requested resources.

• Capacity: Total resource on the node.
• Allocatable: Resource available for scheduling.

Example:

kubeletArguments:
  eviction-hard:
    - "memory.available<500Mi"
  system-reserved:
    - "memory=1.5Gi"

Determine appropriate values using the node summary API.

Restart the kubelet for changes:

$ systemctl restart kubelet

#Preventing Node Condition Oscillation

To avoid oscillation above/below soft eviction thresholds, set eviction-pressure-transition-period:

Example:

kubeletArguments:
  eviction-pressure-transition-period:
    - 5m

Default is 5 minutes. Restart services for changes.

#Reclaiming Node-level Resources

When eviction criteria are met, nodes reclaim resources before evicting user pods.

• With imagefs:
  • If nodefs threshold is met: Delete dead pods/containers.
  • If imagefs threshold is met: Delete unused images.
• Without imagefs:
  • If nodefs threshold is met: Delete dead pods/containers, then unused images.

#Pod Eviction

If a threshold and grace period are met, pods are evicted until the signal is below the threshold.

Pods are ranked for eviction by quality of service (QoS) and resource consumption.

Guaranteed pods are only evicted if system daemons exceed reserved resources or only guaranteed pods remain.

Disk is a best-effort resource; pods are evicted one at a time to reclaim disk space, ranked by QoS and disk usage.

#Quality of Service and Out of Memory Killer

If a system OOM event occurs before memory can be reclaimed, the OOM killer responds.

OOM scores are set based on QoS:

OOM killer ends the container with the highest score. Containers with lowest QoS and highest memory usage are ended first. Containers may be restarted per node policy.

#Scheduler and Out of Resource Conditions

Scheduler considers node conditions when placing pods.

#Example Scenario

Operator wants:

• Node with 10Gi memory.
• Reserve 10% for system daemons.
• Evict pods at 95% utilization.

Calculation:

• capacity = 10Gi
• system-reserved = 1Gi
• allocatable = 9Gi

To trigger eviction below 10% available memory for 30s, or immediately below 5%:

• system-reserved = 2Gi
• allocatable = 8Gi

Configuration:

kubeletArguments:
  system-reserved:
    - "memory=2Gi"
  eviction-hard:
    - "memory.available<.5Gi"
  eviction-soft:
    - "memory.available<1Gi"
  eviction-soft-grace-period:
    - "memory.available=30s"

This prevents immediate memory pressure and eviction after scheduling.

#Recommended Practices

#Daemon Sets and Out of Resource Handling

Pods created by daemon sets are immediately recreated if evicted. Daemon sets should avoid best-effort pods and use guaranteed QoS to reduce eviction risk.