Skip to content

Commit 3ec9363

Browse files
committed
[ko] Update outdated files in dev-1.24-ko.1 M115-M138
1 parent 507491e commit 3ec9363

17 files changed

+306
-242
lines changed

content/ko/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information.md

Lines changed: 64 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -6,19 +6,15 @@ weight: 40
66

77
88

9-
본 페이지는 파드가 DownwardAPIVolumeFile을 사용하여 파드에서 실행되는 컨테이너에
10-
자신에 대한 정보를 노출하는 방법에 대해 설명한다. DownwardAPIVolumeFile은 파드 필드와
11-
컨테이너 필드를 노출할 수 있다.
12-
13-
9+
본 페이지는 파드가
10+
[`DownwardAPIVolumeFile`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core)을 사용하여
11+
파드에서 실행되는 컨테이너에 자신에 대한 정보를 노출하는 방법에 대해 설명한다.
12+
`DownwardAPIVolumeFile`은 파드 필드와 컨테이너 필드를 노출할 수 있다.
1413

1514
## {{% heading "prerequisites" %}}
1615

17-
1816
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
1917

20-
21-
2218
2319

2420
## 다운워드(Downward) API
@@ -28,7 +24,8 @@ weight: 40
2824
* [환경 변수](/ko/docs/tasks/inject-data-application/environment-variable-expose-pod-information/#다운워드-downward-api)
2925
* 볼륨 파일
3026

31-
파드 및 컨테이너 필드를 노출하는 이 두 가지 방법을 *다운워드 API*라고 한다.
27+
파드 및 컨테이너 필드를 노출하는 이 두 가지 방법을
28+
"다운워드 API"라고 한다.
3229

3330
## 파드 필드 저장
3431

@@ -42,11 +39,14 @@ weight: 40
4239

4340
`downwardAPI` 아래의 배열을 살펴보자. 배열의 각 요소는
4441
[DownwardAPIVolumeFile](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core)이다.
45-
첫 번째 요소는 파드의 `metadata.labels` 필드 값이 `labels`라는 파일에 저장되어야 함을 지정한다.
46-
두 번째 요소는 파드의 `annotations` 필드 값이 `annotations`라는 파일에 저장되어야 함을 지정한다.
42+
첫 번째 요소는 파드의 `metadata.labels` 필드 값이
43+
`labels`라는 파일에 저장되어야 함을 지정한다.
44+
두 번째 요소는 파드의 `annotations` 필드 값이
45+
`annotations`라는 파일에 저장되어야 함을 지정한다.
4746

4847
{{< note >}}
49-
이 예제의 필드는 파드에 있는 컨테이너의 필드가 아니라 파드 필드이다.
48+
이 예제의 필드는 파드에 있는 컨테이너의 필드가 아니라
49+
파드 필드이다.
5050
{{< /note >}}
5151

5252
파드를 생성한다.
@@ -78,7 +78,7 @@ build="two"
7878
builder="john-doe"
7979
```
8080

81-
파드에서 실행 중인 컨테이너의 셸을 가져오자.
81+
파드에서 실행 중인 컨테이너의 셸을 가져온다.
8282

8383
```shell
8484
kubectl exec -it kubernetes-downwardapi-volume-example -- sh
@@ -90,7 +90,8 @@ kubectl exec -it kubernetes-downwardapi-volume-example -- sh
9090
/# cat /etc/podinfo/labels
9191
```
9292

93-
출력을 통해 모든 파드의 레이블이 `labels` 파일에 기록되었음을 확인할 수 있다.
93+
출력을 통해 모든 파드의 레이블이
94+
`labels` 파일에 기록되었음을 확인할 수 있다.
9495

9596
```shell
9697
cluster="test-cluster1"
@@ -130,12 +131,12 @@ total 8
130131

131132
심볼릭 링크를 사용하면 메타데이터의 동적(dynamic) 원자적(atomic) 갱신이 가능하다.
132133
업데이트는 새 임시 디렉터리에 기록되고, `..data` 심볼릭 링크는
133-
[rename(2)](http://man7.org/linux/man-pages/man2/rename.2.html)을 사용하여
134-
원자적(atomic)으로 갱신한다.
134+
[rename(2)](http://man7.org/linux/man-pages/man2/rename.2.html)을 사용하여 원자적(atomic)으로 갱신한다.
135135

136136
{{< note >}}
137137
다운워드 API를 [subPath](/ko/docs/concepts/storage/volumes/#using-subpath)
138-
볼륨 마운트로 사용하는 컨테이너는 다운워드 API 업데이트를 수신하지 않는다.
138+
볼륨 마운트로 사용하는 컨테이너는
139+
다운워드 API 업데이트를 수신하지 않는다.
139140
{{< /note >}}
140141

141142
셸을 종료한다.
@@ -146,15 +147,19 @@ total 8
146147

147148
## 컨테이너 필드 저장
148149

149-
이전 연습에서는 파드 필드를 DownwardAPIVolumeFile에 저장하였다.
150-
이 다음 연습에서는 컨테이너 필드를 저장한다. 다음은 하나의 컨테이너를 가진 파드의 구성 파일이다.
150+
이전 연습에서는 파드 필드를
151+
[`DownwardAPIVolumeFile`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core)에 저장하였다.
152+
이 다음 연습에서는 컨테이너 필드를 저장한다.
153+
다음은 하나의 컨테이너를 가진 파드의 구성 파일이다.
151154

152155
{{< codenew file="pods/inject/dapi-volume-resources.yaml" >}}
153156

154-
구성 파일에서 파드에 `downwardAPI` 볼륨이 있고 컨테이너는 `/etc/podinfo`에 볼륨을
155-
마운트하는 것을 확인할 수 있다.
157+
구성 파일에서 파드에 [`downwardAPI` 볼륨](/ko/docs/concepts/storage/volumes/#downwardapi)이 있고
158+
컨테이너는 `/etc/podinfo`
159+
볼륨을 마운트하는 것을 확인할 수 있다.
156160

157-
`downwardAPI` 아래의 `items` 배열을 살펴보자. 배열의 각 요소는 DownwardAPIVolumeFile이다.
161+
`downwardAPI` 아래의 `items` 배열을 살펴보자. 배열의 각 요소는
162+
[`DownwardAPIVolumeFile`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core)이다.
158163

159164
첫 번째 요소는 `client-container`라는 컨테이너에서
160165
`1m`으로 지정된 형식의 `limits.cpu` 필드 값이
@@ -178,45 +183,56 @@ kubectl exec -it kubernetes-downwardapi-volume-example-2 -- sh
178183
```shell
179184
/# cat /etc/podinfo/cpu_limit
180185
```
186+
181187
비슷한 명령을 통해 `cpu_request`, `mem_limit`
182188
`mem_request` 파일을 확인할 수 있다.
183189

184-
185-
186190
187191

192+
188193
## 다운워드 API의 기능
189194

190-
다음 정보는 환경 변수 및 `downwardAPI` 볼륨을 통해 컨테이너에서 사용할 수 있다.
195+
다음 정보는 환경 변수 및 `downwardAPI` 볼륨을 통해
196+
컨테이너에서 사용할 수 있다.
191197

192198
* `fieldRef`를 통해 다음 정보를 사용할 수 있다.
199+
193200
* `metadata.name` - 파드의 이름
194201
* `metadata.namespace` - 파드의 네임스페이스(Namespace)
195202
* `metadata.uid` - 파드의 UID
196-
* `metadata.labels['']` - 파드의 레이블 `` 값 (예를 들어, `metadata.labels['mylabel']`)
197-
* `metadata.annotations['']` - 파드의 어노테이션 `` 값 (예를 들어, `metadata.annotations['myannotation']`)
203+
* `metadata.labels['']` - 파드의 레이블 ``
204+
(예를 들어, `metadata.labels['mylabel']`)
205+
* `metadata.annotations['']` - 파드의 어노테이션 ``
206+
(예를 들어, `metadata.annotations['myannotation']`)
207+
198208
* `resourceFieldRef`를 통해 다음 정보를 사용할 수 있다.
209+
199210
* 컨테이너의 CPU 한도(limit)
200211
* 컨테이너의 CPU 요청(request)
201212
* 컨테이너의 메모리 한도(limit)
202213
* 컨테이너의 메모리 요청(request)
203-
* 컨테이너의 hugepages 한도(limit) (`DownwardAPIHugePages` [기능 게이트(feature gate)](/ko/docs/reference/command-line-tools-reference/feature-gates/)가 활성화된 경우)
204-
* 컨테이너의 hugepages 요청(request) (`DownwardAPIHugePages` [기능 게이트(feature gate)](/ko/docs/reference/command-line-tools-reference/feature-gates/)가 활성화된 경우)
214+
* 컨테이너의 hugepages 한도(limit) (`DownwardAPIHugePages`
215+
[기능 게이트(feature gate)](/ko/docs/reference/command-line-tools-reference/feature-gates/)가 활성화된 경우)
216+
* 컨테이너의 hugepages 요청(request) (`DownwardAPIHugePages`
217+
[기능 게이트(feature gate)](/ko/docs/reference/command-line-tools-reference/feature-gates/)가 활성화된 경우)
205218
* 컨테이너의 임시-스토리지 한도(limit)
206219
* 컨테이너의 임시-스토리지 요청(request)
207220

208-
`downwardAPI` 볼륨 `fieldRef`를 통해 다음 정보를 사용할 수 있다.
221+
`downwardAPI` 볼륨 `fieldRef`를 통해
222+
다음 정보를 사용할 수 있다.
209223

210224
* `metadata.labels` - 한 줄에 하나의 레이블이 있는
211-
`label-key="escaped-label-value"` 형식의 모든 파드 레이블
212-
* `metadata.annotations` - 한 줄에 하나의 어노테이션이 있는 `annotation-key="escaped-annotation-value"` 형식의 모든 파드 어노테이션
225+
`label-key="escaped-label-value"` 형식의 모든 파드 레이블
226+
* `metadata.annotations` - 한 줄에 하나의 어노테이션이 있는
227+
`annotation-key="escaped-annotation-value"` 형식의 모든 파드 어노테이션
213228

214229
환경 변수를 통해 다음 정보를 사용할 수 있다.
215230

216231
* `status.podIP` - 파드의 IP 주소
217-
* `spec.serviceAccountName` - 파드의 서비스 계정 이름, v1.4.0-alpha.3부터 사용 가능
218-
* `spec.nodeName` - 노드의 이름, v1.4.0-alpha.3부터 사용 가능
219-
* `status.hostIP` - 노드의 IP, v1.7.0-alpha.1 이후 사용 가능
232+
* `spec.serviceAccountName` - 파드의 서비스 계정 이름
233+
* `spec.nodeName` - 스케줄러가 항상 파드를 스케줄링하려고 시도할
234+
노드의 이름
235+
* `status.hostIP` - 파드가 할당될 노드의 IP 주소
220236

221237
{{< note >}}
222238
컨테이너에 대해 CPU 및 메모리 한도(limit)가 지정되지 않은 경우 다운워드 API는 기본적으로
@@ -231,7 +247,8 @@ CPU 및 메모리에 대해 할당 가능한 노드 값으로 설정한다.
231247

232248
## 다운워드 API에 대한 동기
233249

234-
컨테이너가 쿠버네티스에 과도하게 결합되지 않고 자체에 대한 정보를 갖는 것이 때때로 유용하다.
250+
컨테이너가 쿠버네티스에 과도하게 결합되지 않고
251+
자체에 대한 정보를 갖는 것이 때때로 유용하다.
235252
다운워드 API를 사용하면 컨테이너가 쿠버네티스 클라이언트 또는 API 서버를 사용하지 않고
236253
자체 또는 클러스터에 대한 정보를 사용할 수 있다.
237254

@@ -241,19 +258,16 @@ CPU 및 메모리에 대해 할당 가능한 노드 값으로 설정한다.
241258
더 나은 옵션은 파드의 이름을 식별자로 사용하고
242259
파드의 이름을 잘 알려진 환경 변수에 삽입하는 것이다.
243260

244-
245-
246-
247261
## {{% heading "whatsnext" %}}
248262

249-
250-
* [PodSpec](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core)
251-
* [볼륨](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#volume-v1-core)
252-
* [DownwardAPIVolumeSource](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumesource-v1-core)
253-
* [DownwardAPIVolumeFile](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core)
254-
* [ResourceFieldSelector](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#resourcefieldselector-v1-core)
255-
256-
257-
258-
259-
263+
* 파드의 목표 상태(desired state)를 정의하는
264+
[`PodSpec`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#podspec-v1-core) API 정의를 확인한다.
265+
* 컨테이너가 접근할 파드 내의 일반 볼륨을 정의하는
266+
[`Volume`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#volume-v1-core) API 정의를 확인한다.
267+
* 다운워드 API 정보를 포함하는 볼륨을 정의하는
268+
[`DownwardAPIVolumeSource`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumesource-v1-core) API 정의를 확인한다.
269+
* 다운워드 API 볼륨 내 파일을 채우기 위한
270+
오브젝트 또는 리소스 필드로의 레퍼런스를 포함하는
271+
[`DownwardAPIVolumeFile`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#downwardapivolumefile-v1-core) API 정의를 확인한다.
272+
* 컨테이너 리소스 및 이들의 출력 형식을 지정하는
273+
[`ResourceFieldSelector`](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#resourcefieldselector-v1-core) API 정의를 확인한다.

content/ko/docs/tasks/job/parallel-processing-expansion.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@ spec:
201201
spec:
202202
containers:
203203
- name: c
204-
image: busybox
204+
image: busybox:1.28
205205
command: ["sh", "-c", "echo Processing URL {{ url }} && sleep 5"]
206206
restartPolicy: Never
207207
{% endfor %}

content/ko/docs/tasks/manage-daemon/update-daemon-set.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ weight: 10
3434
데몬셋의 롤링 업데이트 기능을 사용하려면,
3535
`.spec.updateStrategy.type``RollingUpdate` 를 설정해야 한다.
3636

37-
[`.spec.updateStrategy.rollingUpdate.maxUnavailable`](/ko/docs/concepts/workloads/controllers/deployment/#최대-불가max-unavailable)
37+
[`.spec.updateStrategy.rollingUpdate.maxUnavailable`](/docs/reference/kubernetes-api/workload-resources/daemon-set-v1/#DaemonSetSpec)
3838
(기본값은 1),
39-
[`.spec.minReadySeconds`](/ko/docs/concepts/workloads/controllers/deployment/#최소-대기-시간초)
39+
[`.spec.minReadySeconds`](/docs/reference/kubernetes-api/workload-resources/daemon-set-v1/#DaemonSetSpec)
4040
(기본값은 0),
4141
[`.spec.updateStrategy.rollingUpdate.maxSurge`](/docs/reference/kubernetes-api/workload-resources/daemon-set-v1/#DaemonSetSpec)
4242
(베타 기능, 기본값은 0)를

content/ko/docs/tasks/network/validate-dual-stack.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ content_type: task
1616

1717

1818
* 이중 스택 네트워킹을 위한 제공자 지원 (클라우드 제공자 또는 기타 제공자들은 라우팅 가능한 IPv4/IPv6 네트워크 인터페이스를 제공하는 쿠버네티스 노드들을 제공해야 한다.)
19-
* 이중 스택을 지원하는 [네트워크 플러그인](/ko/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/) (예: Calico, Cilium 또는 Kubenet)
19+
* 이중 스택 네트워킹을 지원하는 [네트워크 플러그인](/ko/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/)
2020
* [이중 스택 활성화](/ko/docs/concepts/services-networking/dual-stack/) 클러스터
2121

2222
{{< version-check >}}

content/ko/docs/tasks/run-application/access-api-from-pod.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -47,10 +47,11 @@ weight: 120
4747
호스트 이름을 사용하여 API 서버를 쿼리할 수 있다. 공식 클라이언트 라이브러리는
4848
이를 자동으로 수행한다.
4949

50-
API 서버를 인증하는 권장 방법은 [서비스 어카운트](/docs/tasks/configure-pod-container/configure-service-account/)
51-
자격 증명을 사용하는 것이다. 기본적으로, 파드는
52-
서비스 어카운트와 연결되어 있으며, 해당 서비스 어카운트에 대한 자격 증명(토큰)은
53-
해당 파드에 있는 각 컨테이너의 파일시스템 트리의
50+
API 서버를 인증하는 권장 방법은
51+
[서비스 어카운트](/docs/tasks/configure-pod-container/configure-service-account/) 자격 증명을 사용하는 것이다.
52+
기본적으로, 파드는 서비스 어카운트와 연결되어 있으며,
53+
해당 서비스 어카운트에 대한 자격 증명(토큰)은
54+
해당 파드에 있는 각 컨테이너의 파일시스템 트리의
5455
`/var/run/secrets/kubernetes.io/serviceaccount/token` 에 있다.
5556

5657
사용 가능한 경우, 인증서 번들은 각 컨테이너의

content/ko/docs/tasks/run-application/horizontal-pod-autoscale-walkthrough.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ php-apache Deployment/php-apache/scale 0% / 50% 1 10 1
152152
```shell
153153
# 부하 생성을 유지하면서 나머지 스텝을 수행할 수 있도록,
154154
# 다음의 명령을 별도의 터미널에서 실행한다.
155-
kubectl run -i --tty load-generator --rm --image=busybox --restart=Never -- /bin/sh -c "while sleep 0.01; do wget -q -O- http://php-apache; done"
155+
kubectl run -i --tty load-generator --rm --image=busybox:1.28 --restart=Never -- /bin/sh -c "while sleep 0.01; do wget -q -O- http://php-apache; done"
156156
```
157157

158158
이제 아래 명령을 실행한다.
@@ -321,7 +321,7 @@ object:
321321
metric:
322322
name: requests-per-second
323323
describedObject:
324-
apiVersion: networking.k8s.io/v1beta1
324+
apiVersion: networking.k8s.io/v1
325325
kind: Ingress
326326
name: main-route
327327
target:
@@ -367,7 +367,7 @@ spec:
367367
metric:
368368
name: requests-per-second
369369
describedObject:
370-
apiVersion: networking.k8s.io/v1beta1
370+
apiVersion: networking.k8s.io/v1
371371
kind: Ingress
372372
name: main-route
373373
target:
@@ -390,7 +390,7 @@ status:
390390
metric:
391391
name: requests-per-second
392392
describedObject:
393-
apiVersion: networking.k8s.io/v1beta1
393+
apiVersion: networking.k8s.io/v1
394394
kind: Ingress
395395
name: main-route
396396
current:

content/ko/docs/tasks/run-application/horizontal-pod-autoscale.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -329,17 +329,17 @@ API에 접속하려면 클러스터 관리자는 다음을 확인해야 한다.
329329
* 해당 API 등록:
330330

331331
* 리소스 메트릭의 경우, 일반적으로 이것은 [메트릭-서버](https://github.com/kubernetes-sigs/metrics-server)가 제공하는 `metrics.k8s.io` API이다.
332-
클러스터 애드온으로 시작할 수 있다.
332+
클러스터 애드온으로 실행할 수 있다.
333333

334334
* 사용자 정의 메트릭의 경우, 이것은 `custom.metrics.k8s.io` API이다. 메트릭 솔루션 공급 업체에서 제공하는 "어댑터" API 서버에서 제공한다.
335335
사용 가능한 쿠버네티스 메트릭 어댑터가 있는지 확인하려면 사용하고자 하는 메트릭 파이프라인을 확인한다.
336336

337337
* 외부 메트릭의 경우, 이것은 `external.metrics.k8s.io` API이다. 위에 제공된 사용자 정의 메트릭 어댑터에서 제공될 수 있다.
338338

339339
이런 다양한 메트릭 경로와 각각의 다른 점에 대한 상세 내용은 관련 디자인 제안서인
340-
[HPA V2](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/autoscaling/hpa-v2.md),
341-
[custom.metrics.k8s.io](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/instrumentation/custom-metrics-api.md),
342-
[external.metrics.k8s.io](https://github.com/kubernetes/community/blob/master/contributors/design-proposals/instrumentation/external-metrics-api.md)를 참조한다.
340+
[HPA V2](https://github.com/kubernetes/design-proposals-archive/blob/main/autoscaling/hpa-v2.md),
341+
[custom.metrics.k8s.io](https://github.com/kubernetes/design-proposals-archive/blob/main/instrumentation/custom-metrics-api.md),
342+
[external.metrics.k8s.io](https://github.com/kubernetes/design-proposals-archive/blob/main/instrumentation/external-metrics-api.md)를 참조한다.
343343

344344
어떻게 사용하는지에 대한 예시는 [커스텀 메트릭 사용하는 작업 과정](/ko/docs/tasks/run-application/horizontal-pod-autoscale-walkthrough/#다양한-메트릭-및-사용자-정의-메트릭을-기초로한-오토스케일링)과
345345
[외부 메트릭스 사용하는 작업 과정](/ko/docs/tasks/run-application/horizontal-pod-autoscale-walkthrough/#쿠버네티스-오브젝트와-관련이-없는-메트릭을-기초로한-오토스케일링)을 참조한다.
@@ -514,7 +514,7 @@ Horizontal Pod Autoscaler는 모든 API 리소스와 마찬가지로 `kubectl`
514514

515515
또한 Horizontal Pod Autoscaler를 생성할 수 있는 `kubectl autoscale`이라는 특별한 명령이 있다.
516516
예를 들어 `kubectl autoscale rs foo --min=2 --max=5 --cpu-percent=80`을
517-
실행하면 레플리케이션 셋 *foo* 에 대한 오토스케일러가 생성되고, 목표 CPU 사용률은 `80 %`,
517+
실행하면 레플리카셋 *foo* 에 대한 오토스케일러가 생성되고, 목표 CPU 사용률은 `80 %`,
518518
그리고 2와 5 사이의 레플리카 개수로 설정된다.
519519

520520
## 암시적 유지 관리 모드 비활성화

0 commit comments

Comments
 (0)