Skip to content

Commit 4ec807f

Browse files
authored
Merge pull request #29826 from ClaudiaJKang/outdated-ko-1-22-p3
[ko] Update outdated files in dev-1.22-ko.1 (p3)
2 parents 827156f + 6cdf420 commit 4ec807f

File tree

8 files changed

+97
-61
lines changed

8 files changed

+97
-61
lines changed

content/ko/docs/reference/glossary/api-eviction.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: API를 이용한 축출(Eviction)
33
id: api-eviction
44
date: 2021-04-27
5-
full_link: /docs/concepts/scheduling-eviction/pod-eviction/#api-eviction
5+
full_link: /ko/docs/concepts/scheduling-eviction/api-eviction/
66
short_description: >
77
API를 이용한 축출은 축출 API를 사용하여 파드의 정상 종료를 트리거하는
88
축출 오브젝트를 만드는 프로세스이다

content/ko/docs/reference/kubectl/kubectl.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -328,7 +328,31 @@ kubectl [flags]
328328
</tbody>
329329
</table>
330330

331+
## {{% heading "envvars" %}}
331332

333+
<table style="width: 100%; table-layout: fixed;">
334+
<colgroup>
335+
<col span="1" style="width: 10px;" />
336+
<col span="1" />
337+
</colgroup>
338+
<tbody>
339+
340+
<tr>
341+
<td colspan="2">KUBECONFIG</td>
342+
</tr>
343+
<tr>
344+
<td></td><td style="line-height: 130%; word-wrap: break-word;">kubectl 구성 ("kubeconfig") 파일 경로. 기본: "$HOME/.kube/config"</td>
345+
</tr>
346+
347+
<tr>
348+
<td colspan="2">KUBECTL_COMMAND_HEADERS</td>
349+
</tr>
350+
<tr>
351+
<td></td><td style="line-height: 130%; word-wrap: break-word;">false로 설정하면, 호출된 kubectl 명령(쿠버네티스 버전 v1.22 이상)을 자세히 설명하는 추가 HTTP 헤더를 해제</td>
352+
</tr>
353+
354+
</tbody>
355+
</table>
332356

333357
## {{% heading "seealso" %}}
334358

content/ko/docs/reference/kubectl/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ kubectl [command] [TYPE] [NAME] [flags]
8787
`cluster-info` | `kubectl cluster-info [flags]` | 클러스터의 마스터와 서비스에 대한 엔드포인트 정보를 표시한다.
8888
`completion` | `kubectl completion SHELL [options]` | 지정된 셸(bash 또는 zsh)에 대한 셸 완성 코드를 출력한다.
8989
`config` | `kubectl config SUBCOMMAND [flags]` | kubeconfig 파일을 수정한다. 세부 사항은 개별 하위 명령을 참고한다.
90-
`convert` | `kubectl convert -f FILENAME [options]` | 다른 API 버전 간에 구성 파일을 변환한다. YAML 및 JSON 형식이 모두 허용된다.
90+
`convert` | `kubectl convert -f FILENAME [options]` | 다른 API 버전 간에 구성 파일을 변환한다. YAML 및 JSON 형식이 모두 허용된다. 참고 - `kubectl-convert` 플러그인을 설치해야 한다.
9191
`cordon` | `kubectl cordon NODE [options]` | 노드를 스케줄 불가능(unschedulable)으로 표시한다.
9292
`cp` | `kubectl cp <file-spec-src> <file-spec-dest> [options]` | 컨테이너에서 그리고 컨테이너로 파일 및 디렉터리를 복사한다.
9393
`create` | `kubectl create -f FILENAME [flags]` | 파일이나 표준입력에서 하나 이상의 리소스를 생성한다.

content/ko/docs/reference/scheduling/config.md

Lines changed: 65 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,16 @@ weight: 20
1818
각 단계는 익스텐션 포인트(extension point)를 통해 노출된다. 플러그인은 이러한
1919
익스텐션 포인트 중 하나 이상을 구현하여 스케줄링 동작을 제공한다.
2020

21-
[KubeSchedulerConfiguration (v1beta1)](/docs/reference/config-api/kube-scheduler-config.v1beta1/)
21+
KubeSchedulerConfiguration ([v1beta1](/docs/reference/config-api/kube-scheduler-config.v1beta1/)
22+
또는 [v1beta2](/docs/reference/config-api/kube-scheduler-config.v1beta2/))
2223
구조에 맞게 파일을 작성하고,
2324
`kube-scheduler --config <filename>`을 실행하여
2425
스케줄링 프로파일을 지정할 수 있다.
2526

2627
최소 구성은 다음과 같다.
2728

2829
```yaml
29-
apiVersion: kubescheduler.config.k8s.io/v1beta1
30+
apiVersion: kubescheduler.config.k8s.io/v1beta2
3031
kind: KubeSchedulerConfiguration
3132
clientConnection:
3233
kubeconfig: /etc/srv/kubernetes/kube-scheduler/kubeconfig
@@ -48,38 +49,41 @@ clientConnection:
4849
스케줄링은 다음 익스텐션 포인트를 통해 노출되는 일련의 단계에서
4950
발생한다.
5051

51-
1. `QueueSort`: 이 플러그인은 스케줄링 대기열에서 보류 중인 파드를
52+
1. `queueSort`: 이 플러그인은 스케줄링 대기열에서 보류 중인 파드를
5253
정렬하는 데 사용되는 정렬 기능을 제공한다. 대기열 정렬 플러그인은 한 번에 단 하나만 활성화될 수 있다.
5354
사용할 수 있다.
54-
1. `PreFilter`: 이 플러그인은 필터링하기 전에 파드 또는 클러스터에 대한 정보를
55+
1. `preFilter`: 이 플러그인은 필터링하기 전에 파드 또는 클러스터에 대한 정보를
5556
사전 처리하거나 확인하는 데 사용된다. 이 플러그인은 파드를 unschedulable로
5657
표시할 수 있다.
57-
1. `Filter`: 이 플러그인은 스케줄링 정책의 단정(Predicates)과 동일하며
58+
1. `filter`: 이 플러그인은 스케줄링 정책의 단정(Predicates)과 동일하며
5859
파드를 실행할 수 없는 노드를 필터링하는 데 사용된다. 필터는
5960
구성된 순서대로 호출된다. 노드가 모든 필터를 통과하지 않으면 파드는 unschedulable로
6061
표시된다.
61-
1. `PreScore`: 이것은 사전 스코어링 작업을 수행하는 데 사용할 수 있는
62+
1. `postFilter`: 이 플러그인은 파드의 실행 가능한 노드를 찾을 수 없을 때,
63+
구성된 순서대로 호출된다. `postFilter` 플러그인이 파드 _schedulable_ 을 표시하는 경우,
64+
나머지 플러그인은 호출 되지 않는다.
65+
1. `preScore`: 이것은 사전 스코어링 작업을 수행하는 데 사용할 수 있는
6266
정보성 익스텐션 포인트이다.
63-
1. `Score`: 이 플러그인은 필터링 단계를 통과한 각 노드에 점수를
67+
1. `score`: 이 플러그인은 필터링 단계를 통과한 각 노드에 점수를
6468
제공한다. 그런 다음 스케줄러는 가중치 합계가 가장 높은
6569
노드를 선택한다.
66-
1. `Reserve`: 지정된 파드에 리소스가 예약된 경우 플러그인에
70+
1. `reserve`: 지정된 파드에 리소스가 예약된 경우 플러그인에
6771
알리는 정보성 익스텐션 포인트이다. 플러그인은 또한
6872
`Reserve` 도중 또는 이후에 실패한 경우 호출 되는 `Unreserve` 호출을
6973
구현한다.
70-
1. `Permit`: 이 플러그인은 파드 바인딩을 방지하거나 지연시킬 수 있다.
71-
1. `PreBind`: 이 플러그인은 파드가 바인딩되기 전에 필요한 모든 작업을 수행한다.
72-
1. `Bind`: 플러그인은 파드를 노드에 바인딩한다. Bind 플러그인은 순서대로 호출되며
73-
일단 바인딩이 완료되면 나머지 플러그인은 건너뛴다. Bind
74+
1. `permit`: 이 플러그인은 파드 바인딩을 방지하거나 지연시킬 수 있다.
75+
1. `preBind`: 이 플러그인은 파드가 바인딩되기 전에 필요한 모든 작업을 수행한다.
76+
1. `bind`: 플러그인은 파드를 노드에 바인딩한다. `bind` 플러그인은 순서대로 호출되며
77+
일단 바인딩이 완료되면 나머지 플러그인은 건너뛴다. bind
7478
플러그인은 적어도 하나 이상 필요하다.
75-
1. `PostBind`: 파드가 바인드된 후 호출되는
79+
1. `postBind`: 파드가 바인드된 후 호출되는
7680
정보성 익스텐션 포인트이다.
7781

7882
각 익스텐션 포인트에 대해 특정 [기본 플러그인](#스케줄링-플러그인)을 비활성화하거나
7983
자체 플러그인을 활성화할 수 있다. 예를 들면, 다음과 같다.
8084

8185
```yaml
82-
apiVersion: kubescheduler.config.k8s.io/v1beta1
86+
apiVersion: kubescheduler.config.k8s.io/v1beta2
8387
kind: KubeSchedulerConfiguration
8488
profiles:
8589
- plugins:
@@ -99,106 +103,111 @@ profiles:
99103

100104
### 스케줄링 플러그인
101105

102-
1. `UnReserve`: 파드가 예약된 후 거부되고 `Permit` 플러그인에 의해 보류된 경우
103-
호출되는 정보성 익스텐션 포인트이다.
104-
105-
## 스케줄링 플러그인
106-
107106
기본적으로 활성화된 다음의 플러그인은 이들 익스텐션 포인트 중
108107
하나 이상을 구현한다.
109108

110-
- `SelectorSpread`: {{< glossary_tooltip text="서비스" term_id="service" >}},
111-
{{< glossary_tooltip text="레플리카셋(ReplicaSets)" term_id="replica-set" >}} 및
112-
{{< glossary_tooltip text="스테이트풀셋(StatefulSets)" term_id="statefulset" >}}에
113-
속하는 파드에 대해 노드 간 분산을 선호한다.
114-
익스텐션 포인트: `PreScore`, `Score`.
115109
- `ImageLocality`: 파드가 실행하는 컨테이너 이미지가 이미 있는 노드를
116110
선호한다.
117-
익스텐션 포인트: `Score`.
111+
익스텐션 포인트: `score`.
118112
- `TaintToleration`: [테인트(taint)와 톨러레이션(toleration)](/ko/docs/concepts/scheduling-eviction/taint-and-toleration/)을
119113
구현한다.
120-
익스텐션 포인트 구현: `Filter`, `Prescore`, `Score`.
114+
익스텐션 포인트 구현: `filter`, `preScore`, `score`.
121115
- `NodeName`: 파드 명세 노드 이름이 현재 노드와 일치하는지 확인한다.
122-
익스텐션 포인트: `Filter`.
116+
익스텐션 포인트: `filter`.
123117
- `NodePorts`: 노드에 요청된 파드 포트에 대해 사용 가능한 포트가 있는지 확인한다.
124-
익스텐션 포인트: `PreFilter`, `Filter`.
118+
익스텐션 포인트: `preFilter`, `filter`.
125119
- `NodePreferAvoidPods`: 노드 {{< glossary_tooltip text="어노테이션" term_id="annotation" >}}
126120
`scheduler.alpha.kubernetes.io/preferAvoidPods` 에 따라
127121
노드 점수를 매긴다.
128-
익스텐션 포인트: `Score`.
122+
익스텐션 포인트: `score`.
129123
- `NodeAffinity`: [노드 셀렉터](/ko/docs/concepts/scheduling-eviction/assign-pod-node/#노드-셀렉터-nodeselector)와
130124
[노드 어피니티](/ko/docs/concepts/scheduling-eviction/assign-pod-node/#노드-어피니티)를
131125
구현한다.
132-
익스텐션 포인트: `Filter`, `Score`.
126+
익스텐션 포인트: `filter`, `score`.
133127
- `PodTopologySpread`: [파드 토폴로지 분배](/ko/docs/concepts/workloads/pods/pod-topology-spread-constraints/)를
134128
구현한다.
135-
익스텐션 포인트: `PreFilter`, `Filter`, `PreScore`, `Score`.
129+
익스텐션 포인트: `preFilter`, `filter`, `preScore`, `score`.
136130
- `NodeUnschedulable`: `.spec.unschedulable` 이 true로 설정된 노드를
137131
필터링한다.
138-
익스텐션 포인트: `Filter`.
132+
익스텐션 포인트: `filter`.
139133
- `NodeResourcesFit`: 노드에 파드가 요청하는 모든 리소스가 있는지
140-
확인한다.
141-
익스텐션 포인트: `PreFilter`, `Filter`.
134+
확인한다. 점수는 `LeastAllocated`(기본값), `MostAllocated`, `RequestedToCapacityRatio` 등 3가지 전략 중 하나를 사용할 수 있다.
135+
익스텐션 포인트: `preFilter`, `filter`, `score`.
142136
- `NodeResourcesBalancedAllocation`: 파드가 스케줄된 경우, 보다 균형잡힌 리소스 사용량을
143137
얻을 수 있는 노드를 선호한다.
144-
익스텐션 포인트: `Score`.
138+
익스텐션 포인트: `score`.
145139
- `NodeResourcesLeastAllocated`: 리소스 할당이 적은 노드를
146140
선호한다.
147141
익스텐션 포인트: `Score`.
148142
- `VolumeBinding`: 노드에 요청된 {{< glossary_tooltip text="볼륨" term_id="volume" >}}이 있는지
149143
또는 바인딩할 수 있는지 확인한다.
150-
익스텐션 포인트: `PreFilter`, `Filter`, `Reserve`, `PreBind`, `Score`.
144+
익스텐션 포인트: `preFilter`, `filter`, `reserve`, `preBind`, `score`.
151145
{{< note >}}
152-
`Score` 익스텐션 포인트는 `VolumeCapacityPriority` 기능이
146+
`score` 익스텐션 포인트는 `VolumeCapacityPriority` 기능이
153147
활성화되어 있어야 활성화되며,
154148
요청된 볼륨 사이즈를 만족하는 가장 작은 PV들을 우선순위 매긴다.
155149
{{< /note >}}
156150
- `VolumeRestrictions`: 노드에 마운트된 볼륨이 볼륨 제공자에 특정한
157151
제한 사항을 충족하는지 확인한다.
158-
익스텐션 포인트: `Filter`.
152+
익스텐션 포인트: `filter`.
159153
- `VolumeZone`: 요청된 볼륨이 가질 수 있는 영역 요구 사항을 충족하는지
160154
확인한다.
161-
익스텐션 포인트: `Filter`.
155+
익스텐션 포인트: `filter`.
162156
- `NodeVolumeLimits`: 노드에 대해 CSI 볼륨 제한을 충족할 수 있는지
163157
확인한다.
164-
익스텐션 포인트: `Filter`.
158+
익스텐션 포인트: `filter`.
165159
- `EBSLimits`: 노드에 대해 AWS EBS 볼륨 제한을 충족할 수 있는지 확인한다.
166-
익스텐션 포인트: `Filter`.
160+
익스텐션 포인트: `filter`.
167161
- `GCEPDLimits`: 노드에 대해 GCP-PD 볼륨 제한을 충족할 수 있는지 확인한다.
168-
익스텐션 포인트: `Filter`.
162+
익스텐션 포인트: `filter`.
169163
- `AzureDiskLimits`: 노드에 대해 Azure 디스크 볼륨 제한을 충족할 수 있는지
170164
확인한다.
171-
익스텐션 포인트: `Filter`.
165+
익스텐션 포인트: `filter`.
172166
- `InterPodAffinity`: [파드 간 어피니티 및 안티-어피니티](/ko/docs/concepts/scheduling-eviction/assign-pod-node/#파드간-어피니티와-안티-어피니티)를
173167
구현한다.
174-
익스텐션 포인트: `PreFilter`, `Filter`, `PreScore`, `Score`.
168+
익스텐션 포인트: `preFilter`, `filter`, `preScore`, `score`.
175169
- `PrioritySort`: 기본 우선 순위 기반 정렬을 제공한다.
176-
익스텐션 포인트: `QueueSort`.
170+
익스텐션 포인트: `queueSort`.
177171
- `DefaultBinder`: 기본 바인딩 메커니즘을 제공한다.
178-
익스텐션 포인트: `Bind`.
172+
익스텐션 포인트: `bind`.
179173
- `DefaultPreemption`: 기본 선점 메커니즘을 제공한다.
180-
익스텐션 포인트: `PostFilter`.
174+
익스텐션 포인트: `postFilter`.
181175

182176
기본으로 활성화되지 않는 다음의 플러그인을
183177
컴포넌트 구성 API를 통해 활성화할 수도 있다.
184178

179+
- `SelectorSpread`: {{< glossary_tooltip text="Services" term_id="service" >}},
180+
{{< glossary_tooltip text="ReplicaSets" term_id="replica-set" >}}와
181+
{{< glossary_tooltip text="StatefulSets" term_id="statefulset" >}}에 속하는 파드의 경우,
182+
노드간에 퍼지는 것을 선호한다.
183+
익스텐션 포인트: `preScore`, `score`.
184+
- `CinderLimits`: 노드에 대해 [OpenStack Cinder](https://docs.openstack.org/cinder/)
185+
볼륨 제한이 충족될 수 있는지 확인한다.
186+
익스텐션 포인트: `filter`.
187+
188+
다음 플러그인은 더 이상 사용되지 않으며 `v1beta1`에서만
189+
사용할 수 있다.
190+
191+
- `NodeResourcesLeastAllocated`: 리소스 할당이 낮은 노드를
192+
선호한다.
193+
Extension points: `score`.
185194
- `NodeResourcesMostAllocated`: 리소스 할당이 많은 노드를
186195
선호한다.
187-
익스텐션 포인트: `Score`.
196+
익스텐션 포인트: `score`.
188197
- `RequestedToCapacityRatio`: 할당된 리소스의 구성된 기능에 따라 노드를
189198
선호한다.
190-
익스텐션 포인트: `Score`.
191-
- `CinderVolume`: 노드에 대해 OpenStack Cinder 볼륨 제한을 충족할 수 있는지
192-
확인한다.
193-
익스텐션 포인트: `Filter`.
199+
익스텐션 포인트: `score`.
194200
- `NodeLabel`: Filters and / or scores a node according to configured
195201
{{< glossary_tooltip text="label(s)" term_id="label" >}}.
196202
익스텐션 포인트: `Filter`, `Score`.
197203
- `ServiceAffinity`: {{< glossary_tooltip text="서비스" term_id="service" >}}에
198204
속한 파드가 구성된 레이블로 정의된 노드 집합에 맞는지
199205
확인한다. 이 플러그인은 또한 서비스에 속한 파드를 노드 간에
200206
분산하는 것을 선호한다.
201-
익스텐션 포인트: `PreFilter`, `Filter`, `Score`.
207+
익스텐션 포인트: `preFilter`, `filter`, `score`.
208+
- `NodePreferAvoidPods`: 노드 주석 `scheduler.alpha.kubernetes.io/preferAvoidPods`에 따라
209+
노드의 우선 순위를 지정한다.
210+
익스텐션 포인트: `score`.
202211

203212
### 여러 프로파일
204213

@@ -211,7 +220,7 @@ profiles:
211220
실행된다.
212221

213222
```yaml
214-
apiVersion: kubescheduler.config.k8s.io/v1beta1
223+
apiVersion: kubescheduler.config.k8s.io/v1beta2
215224
kind: KubeSchedulerConfiguration
216225
profiles:
217226
- schedulerName: default-scheduler
@@ -243,7 +252,7 @@ profiles:
243252
{{< /note >}}
244253

245254
{{< note >}}
246-
모든 프로파일은 QueueSort 익스텐션 포인트에서 동일한 플러그인을 사용해야 하며
255+
모든 프로파일은 `queueSort` 익스텐션 포인트에서 동일한 플러그인을 사용해야 하며
247256
동일한 구성 파라미터(해당하는 경우)를 가져야 한다. 그 이유는 스케줄러가 보류 중 상태인 파드 대기열을
248257
단 하나만 가질 수 있기 때문이다.
249258
{{< /note >}}
@@ -253,3 +262,4 @@ profiles:
253262
* [kube-scheduler 레퍼런스](/docs/reference/command-line-tools-reference/kube-scheduler/) 읽어보기
254263
* [스케줄링](/ko/docs/concepts/scheduling-eviction/kube-scheduler/)에 대해 알아보기
255264
* [kube-scheduler configuration (v1beta1)](/docs/reference/config-api/kube-scheduler-config.v1beta1/) 레퍼런스 읽어보기
265+
* [kube-scheduler configuration (v1beta2)](/docs/reference/config-api/kube-scheduler-config.v1beta2/) 레퍼런스 읽어보기

content/ko/docs/reference/scheduling/policies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,5 +98,5 @@ weight: 10
9898

9999
* [스케줄링](/ko/docs/concepts/scheduling-eviction/kube-scheduler/)에 대해 배우기
100100
* [kube-scheduler 프로파일](/docs/reference/scheduling/profiles/)에 대해 배우기
101-
* [kube-scheduler configuration 레퍼런스 (v1beta1)](/docs/reference/config-api/kube-scheduler-config.v1beta1) 읽어보기
101+
* [kube-scheduler configuration 레퍼런스 (v1beta2)](/docs/reference/config-api/kube-scheduler-config.v1beta2) 읽어보기
102102
* [kube-scheduler Policy 레퍼런스 (v1)](/docs/reference/config-api/kube-scheduler-policy-config.v1/) 읽어보기

content/ko/docs/reference/tools/_index.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ no_list: true
88
---
99

1010
<!-- overview -->
11-
쿠버네티스는 쿠버네티스 시스템으로 작업하는 데 도움이되는 몇 가지 기본 제공 도구를 포함한다.
12-
11+
쿠버네티스는 쿠버네티스 시스템으로 작업하는 데 필요한 공통적으로 사용되거나 관련성 있는 여러 내장 도구와 외부 도구를 포함한다.
1312

1413
<!-- body -->
1514

content/ko/docs/reference/using-api/health-checks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ curl -k 'https://localhost:6443/readyz?verbose&exclude=etcd'
9191

9292
{{< feature-state state="alpha" >}}
9393

94-
각 개별 헬스 체크는 http 엔드포인트를 노출하고 개별적으로 체크가 가능하다.
94+
각 개별 헬스 체크는 HTTP 엔드포인트를 노출하고 개별적으로 체크가 가능하다.
9595
개별 체크를 위한 스키마는 `/livez/<healthcheck-name>` 이고, 여기서 `livez``readyz` 는 API 서버의 활성 상태 또는 준비 상태인지를 확인할 때 사용한다.
9696
`<healthcheck-name>` 경로 위에서 설명한 `verbose` 플래그를 사용해서 찾을 수 있고, `[+]``ok` 사이의 경로를 사용한다.
9797
이러한 개별 헬스 체크는 머신에서 사용되서는 안되며, 운영자가 시스템의 현재 상태를 디버깅하는데 유용하다.

content/ko/docs/setup/best-practices/cluster-large.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,3 +121,6 @@ _A_ 영역에 있는 컨트롤 플레인 호스트로만 전달한다. 단일
121121
[클러스터 오토스케일러](https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler#readme)는
122122
여러 클라우드 프로바이더와 통합되어 클러스터의 리소스 요구 수준에 맞는
123123
노드 수를 실행할 수 있도록 도와준다.
124+
125+
[addon resizer](https://github.com/kubernetes/autoscaler/tree/master/addon-resizer#readme)는
126+
클러스터 스케일이 변경될 때 자동으로 애드온 크기를 조정할 수 있도록 도와준다.

0 commit comments

Comments
 (0)