From 008ff42253d4667304ada7ce611370c22cfa70f8 Mon Sep 17 00:00:00 2001
From: Kevin Park <krapi0314@gmail.com>
Date: Fri, 7 Apr 2023 22:06:22 +0900
Subject: [PATCH] [ko] translate pod-scheduling-readiness.md into Korean

---
 .../pod-scheduling-readiness.md               | 109 ++++++++++++++++++
 .../pods/pod-with-scheduling-gates.yaml       |  11 ++
 .../pods/pod-without-scheduling-gates.yaml    |   8 ++
 3 files changed, 128 insertions(+)
 create mode 100644 content/ko/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md
 create mode 100644 content/ko/examples/pods/pod-with-scheduling-gates.yaml
 create mode 100644 content/ko/examples/pods/pod-without-scheduling-gates.yaml

diff --git a/content/ko/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md b/content/ko/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md
new file mode 100644
index 0000000000..78472fa483
--- /dev/null
+++ b/content/ko/docs/concepts/scheduling-eviction/pod-scheduling-readiness.md
@@ -0,0 +1,109 @@
+---
+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)를 참고한다.
diff --git a/content/ko/examples/pods/pod-with-scheduling-gates.yaml b/content/ko/examples/pods/pod-with-scheduling-gates.yaml
new file mode 100644
index 0000000000..b0b012fb72
--- /dev/null
+++ b/content/ko/examples/pods/pod-with-scheduling-gates.yaml
@@ -0,0 +1,11 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: test-pod
+spec:
+  schedulingGates:
+  - name: foo
+  - name: bar
+  containers:
+  - name: pause
+    image: registry.k8s.io/pause:3.6
diff --git a/content/ko/examples/pods/pod-without-scheduling-gates.yaml b/content/ko/examples/pods/pod-without-scheduling-gates.yaml
new file mode 100644
index 0000000000..5638b6e97a
--- /dev/null
+++ b/content/ko/examples/pods/pod-without-scheduling-gates.yaml
@@ -0,0 +1,8 @@
+apiVersion: v1
+kind: Pod
+metadata:
+  name: test-pod
+spec:
+  containers:
+  - name: pause
+    image: registry.k8s.io/pause:3.6