110 lines
4.0 KiB
Markdown
110 lines
4.0 KiB
Markdown
---
|
|
title: 파드 스케줄링 준비성(readiness)
|
|
content_type: concept
|
|
weight: 40
|
|
---
|
|
|
|
<!-- overview -->
|
|
|
|
{{< feature-state for_k8s_version="v1.26" state="alpha" >}}
|
|
|
|
파드는 생성되면 스케줄링 될 준비가 된 것으로 간주된다. 쿠버네티스 스케줄러는
|
|
모든 Pending 중인 파드를 배치할 노드를 찾기 위한 철저한 조사 과정을 수행한다. 그러나 일부 파드는
|
|
오랜 기간 동안 "필수 리소스 누락" 상태에 머물 수 있다.
|
|
이러한 파드는 실제로 스케줄러(그리고 클러스터 오토스케일러와 같은 다운스트림 통합자)
|
|
불필요한 방식으로 작동하게 만들 수 있다.
|
|
|
|
파드의 `.spec.schedulingGates`를 지정하거나 제거함으로써,
|
|
파드가 스케줄링 될 준비가 되는 시기를 제어할 수 있다.
|
|
|
|
<!-- body -->
|
|
|
|
## 파드 스케줄링게이트(schedulingGates) 구성하기
|
|
|
|
`스케줄링게이트(schedulingGates)` 필드는 문자열 목록을 포함하며, 각 문자열 리터럴은
|
|
파드가 스케줄링 가능한 것으로 간주되기 전에 충족해야 하는 기준으로 인식된다. 이 필드는
|
|
파드가 생성될 때만 초기화할 수 있다(클라이언트에 의해 생성되거나, 어드미션 중에 변경될 때).
|
|
생성 후 각 스케줄링게이트는 임의의 순서로 제거될 수 있지만, 새로운 스케줄링게이트의 추가는 허용되지 않는다.
|
|
|
|
{{<mermaid>}}
|
|
stateDiagram-v2
|
|
s1: 파드 생성
|
|
s2: 파드 스케줄링 게이트됨
|
|
s3: 파드 스케줄링 준비됨
|
|
s4: 파드 실행
|
|
if: 스케줄링 게이트가 비어 있는가?
|
|
[*] --> s1
|
|
s1 --> if
|
|
s2 --> if: 스케줄링 게이트 제거됨
|
|
if --> s2: 아니오
|
|
if --> s3: 네
|
|
s3 --> s4
|
|
s4 --> [*]
|
|
{{< /mermaid >}}
|
|
|
|
## 사용 예시
|
|
|
|
파드가 스케줄링 될 준비가 되지 않았다고 표시하려면, 다음과 같이 하나 이상의 스케줄링 게이트를 생성하여 표시할 수 있다.
|
|
|
|
{{< codenew file="pods/pod-with-scheduling-gates.yaml" >}}
|
|
|
|
파드가 생성된 후에는 다음 명령을 사용하여 상태를 확인할 수 있다.
|
|
|
|
```bash
|
|
kubectl get pod test-pod
|
|
```
|
|
|
|
출력은 파드가 `SchedulingGated` 상태임을 보여준다.
|
|
|
|
```none
|
|
NAME READY STATUS RESTARTS AGE
|
|
test-pod 0/1 SchedulingGated 0 7s
|
|
```
|
|
|
|
다음 명령을 실행하여 `schedulingGates` 필드를 확인할 수도 있다.
|
|
|
|
```bash
|
|
kubectl get pod test-pod -o jsonpath='{.spec.schedulingGates}'
|
|
```
|
|
|
|
출력은 다음과 같다.
|
|
|
|
```none
|
|
[{"name":"foo"},{"name":"bar"}]
|
|
```
|
|
|
|
스케줄러에게 이 파드가 스케줄링 될 준비가 되었음을 알리기 위해, 수정된 매니페스트를 다시 적용하여
|
|
`schedulingGates`를 완전히 제거할 수 있다.
|
|
|
|
{{< codenew file="pods/pod-without-scheduling-gates.yaml" >}}
|
|
|
|
`schedulingGates`가 지워졌는지 확인하려면 다음 명령을 실행하여 확인할 수 있다.
|
|
|
|
```bash
|
|
kubectl get pod test-pod -o jsonpath='{.spec.schedulingGates}'
|
|
```
|
|
|
|
출력은 비어 있을 것이다. 그리고 다음 명령을 실행하여 최신 상태를 확인할 수 있다.
|
|
|
|
```bash
|
|
kubectl get pod test-pod -o wide
|
|
```
|
|
|
|
test-pod가 CPU/메모리 리소스를 요청하지 않았기 때문에, 이 파드의 상태는 이전의 `SchedulingGated`에서
|
|
`Running`으로 전환됐을 것이다.
|
|
|
|
```none
|
|
NAME READY STATUS RESTARTS AGE IP NODE
|
|
test-pod 1/1 Running 0 15s 10.0.0.4 node-2
|
|
```
|
|
|
|
## 가시성(Observability)
|
|
|
|
스케줄링을 시도했지만 스케줄링할 수 없다고 클레임되거나 스케줄링할 준비가 되지 않은 것으로 명시적으로 표시된 파드를
|
|
구분하기 위해 `scheduler_pending_pods` 메트릭은 `”gated"`라는 새로운 레이블과 함께 제공된다.
|
|
`scheduler_pending_pods{queue="gated"}`를 사용하여 메트릭 결과를 확인할 수 있다.
|
|
|
|
## {{% heading "whatsnext" %}}
|
|
|
|
* 자세한 내용은 [PodSchedulingReadiness KEP](https://github.com/kubernetes/enhancements/blob/master/keps/sig-scheduling/3521-pod-scheduling-readiness)를 참고한다.
|