[ko] Update outdated files in dev-1.24-ko.1 (M18-M31)

2022-05-22 10:32:30 +09:00
parent e6d993feb3
commit cb3b57ca58
13 changed files with 103 additions and 201 deletions
@@ -28,7 +28,7 @@ card:

 컨트롤 플레인 컴포넌트는 클러스터 내 어떠한 머신에서든지 동작할 수 있다. 그러나
 간결성을 위하여, 구성 스크립트는 보통 동일 머신 상에 모든 컨트롤 플레인 컴포넌트를 구동시키고,
-사용자 컨테이너는 해당 머신 상에 동작시키지 않는다. 여러 VM에서
+사용자 컨테이너는 해당 머신 상에 동작시키지 않는다. 여러 머신에서
 실행되는 컨트롤 플레인 설정의 예제를 보려면
 [kubeadm을 사용하여 고가용성 클러스터 만들기](/docs/setup/production-environment/tools/kubeadm/high-availability/)를 확인해본다.

@@ -22,7 +22,7 @@ card:
 쿠버네티스 API를 사용하면 쿠버네티스의 API 오브젝트(예:
 파드(Pod), 네임스페이스(Namespace), 컨피그맵(ConfigMap) 그리고 이벤트(Event))를 질의(query)하고 조작할 수 있다.

-대부분의 작업은 [kubectl](/ko/docs/reference/kubectl/overview/)
+대부분의 작업은 [kubectl](/ko/docs/reference/kubectl/)
 커맨드 라인 인터페이스 또는 API를 사용하는
 [kubeadm](/ko/docs/reference/setup-tools/kubeadm/)과
 같은 다른 커맨드 라인 도구를 통해 수행할 수 있다.
@@ -82,18 +82,42 @@ IDL(인터페이스 정의 언어) 파일을 참고한다.

 ### OpenAPI V3

-{{< feature-state state="alpha"  for_k8s_version="v1.23" >}}
+{{< feature-state state="beta"  for_k8s_version="v1.24" >}}

-쿠버네티스 v1.23은 OpenAPI v3 API 발행(publishing)에 대한 초기 지원을 제공한다. 
-이는 알파 기능이며 기본적으로 비활성화되어 있다.
+쿠버네티스 {{< param "version" >}} 버전은 OpenAPI v3 API 발행(publishing)에 대한 베타 지원을 제공한다. 
+이는 베타 기능이며 기본적으로 활성화되어 있다.
 kube-apiserver 구성 요소에 
-`OpenAPIV3` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를 이용하여 
-이 알파 기능을 활성화할 수 있다.
+`OpenAPIV3` [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를 비활성화하여 
+이 베타 기능을 비활성화할 수 있다.

-이 기능이 활성화되면, 쿠버네티스 API 서버는 
-통합된(aggregated) OpenAPI v3 스펙을 쿠버네티스 그룹 버전별로 
-`/openapi/v3/apis/<group>/<version>` 엔드포인트에 제공한다. 
-사용할 수 있는 요청 헤더는 아래의 표를 참고한다.
+`/openapi/v3` 디스커버리 엔드포인트는 사용 가능한 모든 
+그룹/버전의 목록을 제공한다. 이 엔드포인트는 JSON 만을 반환한다.
+이러한 그룹/버전은 다음과 같은 형식으로 제공된다.
+```json
+{
+    "paths": {
+        ...
+        "api/v1": {
+            "serverRelativeURL": "/openapi/v3/api/v1?hash=CC0E9BFD992D8C59AEC98A1E2336F899E8318D3CF4C68944C3DEC640AF5AB52D864AC50DAA8D145B3494F75FA3CFF939FCBDDA431DAD3CA79738B297795818CF"
+        },
+        "apis/admissionregistration.k8s.io/v1": {
+            "serverRelativeURL": "/openapi/v3/apis/admissionregistration.k8s.io/v1?hash=E19CC93A116982CE5422FC42B590A8AFAD92CDE9AE4D59B5CAAD568F083AD07946E6CB5817531680BCE6E215C16973CD39003B0425F3477CFD854E89A9DB6597"
+        },
+        ...
+}
+```
+
+위의 상대 URL은 변경 불가능한(immutable) OpenAPI 상세를 가리키고 있으며, 
+이는 클라이언트에서의 캐싱을 향상시키기 위함이다. 
+같은 목적을 위해 API 서버는 적절한 HTTP 캐싱 헤더를 
+설정한다(`Expires`를 1년 뒤로, `Cache-Control`을 `immutable`). 
+사용 중단된 URL이 사용되면, API 서버는 최신 URL로의 리다이렉트를 반환한다.
+
+쿠버네티스 API 서버는 
+쿠버네티스 그룹 버전에 따른 OpenAPI v3 스펙을 
+`/openapi/v3/apis/<group>/<version>?hash=<hash>` 엔드포인트에 게시한다.
+
+사용 가능한 요청 헤더 목록은 아래의 표를 참고한다.

 <table>
  <caption style="display:none"> OpenAPI v3 질의에 사용할 수 있는 유효한 요청 헤더 값</caption>
@@ -126,9 +150,6 @@ kube-apiserver 구성 요소에
  </tbody>
 </table>

-`/openapi/v3` 디스커버리 엔드포인트는 사용 가능한 모든 
-그룹/버전의 목록을 제공한다. 이 엔드포인트는 JSON 만을 반환한다.
-
 ## 지속성

 쿠버네티스는 오브젝트의 직렬화된 상태를
@@ -63,7 +63,7 @@ spec과 status간의 차이에 대응한다.
 [`kubectl apply`](/docs/reference/generated/kubectl/kubectl-commands#apply) 커맨드를 이용하는 것이다. 다음 예시와 같다.

 ```shell
-kubectl apply -f https://k8s.io/examples/application/deployment.yaml --record
+kubectl apply -f https://k8s.io/examples/application/deployment.yaml
 ```

 그 출력 내용은 다음과 유사하다.
@@ -83,14 +83,22 @@ deployment.apps/nginx-deployment created

 오브젝트 `spec`에 대한 정확한 포맷은 모든 쿠버네티스 오브젝트마다 다르고, 그 오브젝트 특유의 중첩된 필드를 포함한다. [쿠버네티스 API 레퍼런스](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/) 는 쿠버네티스를 이용하여 생성할 수 있는 오브젝트에 대한 모든 spec 포맷을 살펴볼 수 있도록 해준다.

-예를 들어, API 내 파드에 대한 상세 정보는 [`spec` 필드](/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec)에 대한 레퍼런스에서,
-디플로이먼트에 대한 상세 정보는 [`spec` 필드](/docs/reference/kubernetes-api/workload-resources/deployment-v1/#DeploymentSpec)에 대한 레퍼런스에서 확인할 수 있다.
-해당 API 레퍼런스 페이지에서 PodSpec과 DeploymentSpec에 대해 언급된 내용을 볼 수 있다. 이 이름들은 쿠버네티스가 API를 구현하는데 사용한 Go 언어 코드 구현의 세부 내용이다.
-
+예를 들어, 파드 API 레퍼런스를 보려면 
+[`spec` 필드](/docs/reference/kubernetes-api/workload-resources/pod-v1/#PodSpec)를 참조한다. 
+각 파드에 대해, `.spec` 필드는 파드 및 파드의 원하는 상태(desired state)를 
+기술한다(예: 파드의 각 컨테이너에 대한 컨테이너 이미지). 
+오브젝트 상세에 대한 또 다른 예시는 스테이트풀셋 API의 
+[`spec` 필드](/docs/reference/kubernetes-api/workload-resources/stateful-set-v1/#StatefulSetSpec)이다. 
+스테이트풀셋의 경우, `.spec` 필드는 스테이트풀셋 및 스테이트풀셋의 원하는 상태(desired state)를 기술한다. 
+스테이트풀셋의 `.spec`에는 파드 오브젝트에 대한 
+[템플릿](/ko/docs/concepts/workloads/pods/#파드-템플릿)이 존재한다. 
+이 템플릿은 스테이트풀셋 명세를 만족시키기 위해 
+스테이트풀셋 컨트롤러가 생성할 파드에 대한 상세 사항을 설명한다.
+서로 다른 종류의 오브젝트는 서로 다른 `.status`를 가질 수 있다. 
+다시 한번 말하자면, 각 API 레퍼런스 페이지는 각 오브젝트 타입에 대해 해당 `.status` 필드의 구조와 내용에 대해 소개한다. 

 ## {{% heading "whatsnext" %}}

-
 * [파드](/ko/docs/concepts/workloads/pods/)와 같이, 가장 중요하고 기본적인 쿠버네티스 오브젝트에 대해 배운다.
 * 쿠버네티스의 [컨트롤러](/ko/docs/concepts/architecture/controller/)에 대해 배운다.
 * API 개념의 더 많은 설명은 [쿠버네티스 API 사용](/ko/docs/reference/using-api/)을 본다.