# 스케일링 동작

> **지원 버전**: EKS 1.29+, EKS Auto Mode GA **마지막 업데이트**: 2026년 2월 19일

< [이전: NodePool 구성](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode/02-nodepool-configuration) | [목차](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode) | [다음: Spot 전략](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode/04-spot-strategies) >

***

이 문서에서는 EKS Auto Mode의 스케일링 동작을 이해하고 최적화하는 방법을 설명합니다.

## Pod Pending에서 노드 프로비저닝까지

EKS Auto Mode의 스케일링 흐름을 이해하면 최적화에 도움이 됩니다.

{% @mermaid/diagram content="flowchart TD
subgraph Trigger\["트리거"]
A\[Pod 생성] --> B{스케줄 가능?}
B -->|Yes| C\[기존 노드에 배치]
B -->|No| D\[Pod Pending]
end

```
subgraph AutoMode["Auto Mode Controller"]
    D --> E[Pending Pod 감지]
    E --> F[NodePool 평가]
    F --> G[요구사항 분석]
    G --> H[최적 인스턴스 선택]
    H --> I[노드 프로비저닝]
end

subgraph Provisioning["프로비저닝"]
    I --> J[EC2 인스턴스 시작]
    J --> K[노드 부트스트랩]
    K --> L[kubelet 등록]
    L --> M[노드 Ready]
end

subgraph Scheduling["스케줄링"]
    M --> N[Pod 스케줄링]
    N --> O[Pod Running]
end

style Trigger fill:#e1f5fe
style AutoMode fill:#fff3e0
style Provisioning fill:#f3e5f5
style Scheduling fill:#e8f5e9" %}
```

## Consolidation 동작

Consolidation은 비효율적인 노드를 정리하여 비용을 최적화합니다.

### WhenEmpty 정책

빈 노드만 제거합니다.

```yaml
apiVersion: karpenter.sh/v1
kind: NodePool
metadata:
  name: when-empty-example
spec:
  template:
    spec:
      requirements:
        - key: karpenter.k8s.aws/instance-category
          operator: In
          values: ["m", "c"]
      nodeClassRef:
        group: eks.amazonaws.com
        kind: NodeClass
        name: default
  disruption:
    consolidationPolicy: WhenEmpty
    consolidateAfter: 30s  # 빈 상태로 30초 후 제거
```

### WhenEmptyOrUnderutilized 정책

빈 노드뿐만 아니라 저사용률 노드도 통합합니다.

```yaml
apiVersion: karpenter.sh/v1
kind: NodePool
metadata:
  name: when-underutilized-example
spec:
  template:
    spec:
      requirements:
        - key: karpenter.k8s.aws/instance-category
          operator: In
          values: ["m", "c"]
      nodeClassRef:
        group: eks.amazonaws.com
        kind: NodeClass
        name: default
  disruption:
    consolidationPolicy: WhenEmptyOrUnderutilized
    consolidateAfter: 1m
```

{% @mermaid/diagram content="flowchart LR
subgraph Before\["통합 전"]
N1\["노드 1<br/>CPU: 20%<br/>메모리: 30%"]
N2\["노드 2<br/>CPU: 15%<br/>메모리: 25%"]
N3\["노드 3<br/>CPU: 10%<br/>메모리: 20%"]
end

```
subgraph After["통합 후"]
    N4["노드 1<br/>CPU: 45%<br/>메모리: 75%"]
    N5["(제거됨)"]
    N6["(제거됨)"]
end

Before --> |Consolidation| After

style N5 fill:#ffcdd2
style N6 fill:#ffcdd2" %}
```

## Drift 감지 및 교체

NodePool 설정이 변경되면 기존 노드를 새 설정으로 교체합니다.

```yaml
# 노드 Drift 확인
kubectl get nodes -o custom-columns=\
NAME:.metadata.name,\
NODEPOOL:.metadata.labels.karpenter\\.sh/nodepool,\
DRIFT:.metadata.annotations.karpenter\\.sh/drift-hash

# Drift가 감지된 노드 확인
kubectl get nodeclaims -o wide
```

Drift가 발생하는 경우:

* NodePool의 requirements가 변경된 경우
* NodeClass의 설정이 변경된 경우
* AMI가 업데이트된 경우

## Expiration 기반 노드 갱신

보안 패치나 AMI 업데이트를 위해 노드를 주기적으로 교체합니다.

```yaml
apiVersion: karpenter.sh/v1
kind: NodePool
metadata:
  name: with-expiration
spec:
  template:
    spec:
      requirements:
        - key: karpenter.k8s.aws/instance-category
          operator: In
          values: ["m", "c"]
      nodeClassRef:
        group: eks.amazonaws.com
        kind: NodeClass
        name: default
      # 노드 최대 수명 설정
      expireAfter: 168h  # 7일 후 자동 교체
  disruption:
    consolidationPolicy: WhenEmptyOrUnderutilized
    consolidateAfter: 1m
```

## 스케일링 지연 시간 최적화

```bash
# 노드 프로비저닝 시간 측정
kubectl get events --sort-by='.lastTimestamp' | grep -E "Provisioned|Registered"

# 일반적인 프로비저닝 타임라인
# - EC2 인스턴스 시작: 10-30초
# - AMI 부팅: 20-40초
# - kubelet 등록: 5-10초
# - Pod 스케줄링: 1-5초
# 총 예상 시간: 40-90초
```

### 빠른 프로비저닝을 위한 NodeClass 설정

```yaml
# 빠른 프로비저닝을 위한 NodeClass 설정
apiVersion: eks.amazonaws.com/v1
kind: NodeClass
metadata:
  name: fast-boot
spec:
  amiFamily: Bottlerocket  # AL2023보다 빠른 부팅 시간

  # EBS 최적화
  blockDeviceMappings:
    - deviceName: /dev/xvda
      ebs:
        volumeSize: 50Gi  # 필요한 만큼만
        volumeType: gp3
        iops: 3000
        throughput: 125
```

### 프로비저닝 속도 최적화 팁

| 최적화 항목      | 설명                           | 예상 개선     |
| ----------- | ---------------------------- | --------- |
| AMI 선택      | Bottlerocket은 AL2023보다 빠른 부팅 | 10-20초 단축 |
| EBS 볼륨 크기   | 필요한 최소 크기 사용                 | 5-10초 단축  |
| 다양한 인스턴스 타입 | 가용성 높은 타입 선택 가능              | 가용성 향상    |
| 리전 내 AZ 분산  | 용량 부족 시 대체 AZ 사용             | 가용성 향상    |

***

< [이전: NodePool 구성](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode/02-nodepool-configuration) | [목차](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode) | [다음: Spot 전략](https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode/04-spot-strategies) >


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://atomoh.gitbook.io/aws/amazon-eks/eks-auto-mode/03-scaling-behavior.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.