Merge pull request #29941 from seokho-son/outdate-1.22-ko.1-m52

[ko] Update outdated files in dev-1.22-ko.1 (M52)

Author: k8s-ci-robot

content/ko/docs/setup/production-environment/tools/kubeadm/control-plane-flags.md

@@ -1,78 +1,108 @@
 ---
-reviewers:
-title: kubeadm으로 컨트롤 플레인 사용자 정의하기
+
+
+title: kubeadm API로 컴포넌트 사용자 정의하기
 content_type: concept
 weight: 40
 ---
 
 <!-- overview -->
 
+이 페이지는 kubeadm이 배포하는 컴포넌트(component)들을 사용자 정의하는 방법을 다룬다. 컨트롤 플레인 컴포넌트에
+대해서는 `ClusterConfiguration` 구조에서 플래그를 사용하거나 노드당 패치를 사용할 수 있다. kubelet과
+kube-proxy의 경우, `KubeletConfiguration`과 `KubeProxyConfiguration`을 각각 사용할 수 있다.
+
+이 모든 옵션이 kubeadm 구성 API를 통해 가용하다.
+구성의 각 필드 상세 사항은
+[API 참조 페이지](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm/v1beta3)에서 찾아볼 수 있다.
+
+{{< note >}}
+kubeadm의 CoreDNS 디플로이먼트 사용자 정의는 현재 제공되지 않는다.
+`kube-system/coredns` {{< glossary_tooltip text="컨피그맵" term_id="configmap" >}}을 수동으로
+패치하고, 그 이후에 CoreDNS {{< glossary_tooltip text="파드" term_id="pod" >}}를 다시 생성해야 한다. 또는,
+기본 CoreDNS 디플로이먼트를 생략하고 자체 변형(variant)을 배포할 수 있다.
+더 자세한 사항은 [kubeadm에서 초기화 단계 사용하기](/docs/reference/setup-tools/kubeadm/kubeadm-init/#init-phases)을 참고한다.
+{{< /note >}}
+
+<!-- body -->
+
 {{< feature-state for_k8s_version="v1.12" state="stable" >}}
 
-kubeadm의 `ClusterConfiguration` 오브젝트는 API 서버, 컨트롤러매니저, 스케줄러와 같은 컨트롤 플레인 구성요소에 전달되는
-기본 플래그 `extraArgs` 필드를 노출한다. 이 구성요소는 다음 필드를 사용하도록 정의되어 있다.
+## `ClusterConfiguration`의 플래그로 컨트롤 플레인 사용자 정의하기
+
+kubeadm의 `ClusterConfiguration` 오브젝트는 API 서버, 컨트롤러매니저, 스케줄러, Etcd와 같은 컨트롤 플레인 컴포넌트에 전달되는
+기본 플래그를 사용자가 덮어쓸 수 있도록 노출한다.
+이 컴포넌트는 다음 구조체를 사용하여 정의된다.
 
 - `apiServer`
 - `controllerManager`
 - `scheduler`
+- `etcd`
 
-`extraArgs` 필드는 `key: value` 쌍으로 구성되어 있다. 컨트롤 플레인 구성요소를 위한 플래그를 대체하려면 다음을 수행한다.
+이 구조체들은 공통 필드인 `extraArgs`를 포함하며, 이 필드는 `키: 값` 쌍으로 구성된다.
+컨트롤 플레인 컴포넌트를 위한 플래그를 덮어쓰려면 다음을 수행한다.
 
-1.  사용자 구성에서 적절한 필드를 추가한다.
-2.  필드에 대체할 플래그를 추가한다.
+1.  사용자 구성에 적절한 `extraArgs` 필드를 추가한다.
+2.  `extraArgs` 필드에 플래그를 추가한다.
 3.  `kubeadm init`에 `--config <CONFIG YAML 파일>` 파라미터를 추가해서 실행한다.
 
-각 필드의 구성에서 자세한 정보를 보려면,
-[API 참고 문서](/docs/reference/config-api/kubeadm-config.v1beta2/)에서 확인해 볼 수 있다.
-
 {{< note >}}
-`kubeadm config print init-defaults`를 실행하고 원하는 파일에 출력을 저장하여 기본값인 `ClusterConfiguration` 오브젝트를 생성할 수 있다.
+`kubeadm config print init-defaults`를 실행하고 원하는 파일에 출력을
+저장하여 기본값들로 구성된 `ClusterConfiguration` 오브젝트를 생성할 수 있다.
 {{< /note >}}
 
+{{< note >}}
+`ClusterConfiguration` 오브젝트는 현재 kubeadm 클러스터에서 전역(global)으로 사용된다. 즉, 사용자가 추가하는 모든 플래그는
+다른 노드에 있는 동일한 컴포넌트에도 모두 적용될 것이다. 다른 노드에서
+컴포넌트별로 개별 구성을 적용하려면 [패치](#patches)를 사용하면 된다.
+{{< /note >}}
 
+{{< note >}}
+플래그(키)를 복제하거나 동일한 플래그 `--foo`를 여러 번 전달하는 것은 현재 지원하지 않는다.
+이 문제를 해결하려면 [패치](#patches)를 사용해야 한다.
+{{< /note >}}
 
-<!-- body -->
-
-## APIServer 플래그
+### APIServer 플래그
 
 자세한 내용은 [kube-apiserver 레퍼런스 문서](/docs/reference/command-line-tools-reference/kube-apiserver/)를 확인한다.
 
-예시:
+사용 예시:
+
 ```yaml
-apiVersion: kubeadm.k8s.io/v1beta2
+apiVersion: kubeadm.k8s.io/v1beta3
 kind: ClusterConfiguration
 kubernetesVersion: v1.16.0
 apiServer:
   extraArgs:
-    advertise-address: 192.168.0.103
     anonymous-auth: "false"
     enable-admission-plugins: AlwaysPullImages,DefaultStorageClass
     audit-log-path: /home/johndoe/audit.log
 ```
 
-## 컨트롤러매니저 플래그
+### 컨트롤러매니저 플래그
 
 자세한 내용은 [kube-controller-manager 레퍼런스 문서](/docs/reference/command-line-tools-reference/kube-controller-manager/)를 확인한다.
 
-예시:
+사용 예시:
+
 ```yaml
-apiVersion: kubeadm.k8s.io/v1beta2
+apiVersion: kubeadm.k8s.io/v1beta3
 kind: ClusterConfiguration
 kubernetesVersion: v1.16.0
 controllerManager:
   extraArgs:
     cluster-signing-key-file: /home/johndoe/keys/ca.key
-    bind-address: 0.0.0.0
     deployment-controller-sync-period: "50"
 ```
 
-## 스케줄러 플래그
+### 스케줄러 플래그
 
 자세한 내용은 [kube-scheduler 레퍼런스 문서](/docs/reference/command-line-tools-reference/kube-scheduler/)를 확인한다.
 
-예시:
+사용 예시:
+
 ```yaml
-apiVersion: kubeadm.k8s.io/v1beta2
+apiVersion: kubeadm.k8s.io/v1beta3
 kind: ClusterConfiguration
 kubernetesVersion: v1.16.0
 scheduler:
@@ -85,3 +115,96 @@ scheduler:
       readOnly: true
       pathType: "File"
 ```
+
+### Etcd 플래그
+
+자세한 사항은 [etcd 서버 문서](https://etcd.io/docs/)를 확인한다.
+
+사용 예시:
+
+```yaml
+apiVersion: kubeadm.k8s.io/v1beta3
+kind: ClusterConfiguration
+etcd:
+  local:
+    extraArgs:
+      election-timeout: 1000
+```
+
+## 패치를 통해 컨트롤 플레인 사용자 정의하기 {#patches}
+
+{{< feature-state for_k8s_version="v1.22" state="beta" >}}
+
+Kubeadm을 사용하면 패치 파일이 있는 디렉토리를 개별 노드에 대한 `InitConfiguration`과 `JoinConfiguration`에
+전달할 수 있다. 이 패치는 컨트롤 플레인 컴포넌트 메니패스트가 디스크에 기록되기 전에
+최종 사용자 정의 단계로 사용될 수 있다.
+
+`--config <YOUR CONFIG YAML>`을 사용하여 이 파일을 `kubeadm init`에 전달할 수 있다.
+
+```yaml
+apiVersion: kubeadm.k8s.io/v1beta3
+kind: InitConfiguration
+nodeRegistration:
+  patches:
+    directory: /home/user/somedir
+```
+
+{{< note >}}
+`kubeadm init`의 경우, `---`로 구분된 `ClusterConfiguration`과 `InitConfiguration`을 모두
+포함하는 파일을 전달할 수 있다.
+{{< /note >}}
+
+`--config <YOUR CONFIG YAML>`을 사용하여 이 파일을 `kubeadm join`에 전달할 수 있다.
+
+```yaml
+apiVersion: kubeadm.k8s.io/v1beta3
+kind: JoinConfiguration
+nodeRegistration:
+  patches:
+    directory: /home/user/somedir
+```
+
+디렉토리는 `target[suffix][+patchtype].extension` 형태의 파일을 포함해야 한다.
+예를 들면, `kube-apiserver0+merge.yaml` 또는 단순히 `etcd.json`의 형태이다.
+
+- `target`은 `kube-apiserver`, `kube-controller-manager`, `kube-scheduler` 그리고 `etcd` 중 하나가 될 수 있다.
+- `patchtype`은 `strategic`, `merge` 그리고 `json` 중 하나가 될 수 있으며
+[kubectl에서 지원하는](/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch) 패치 형식을 준수해야 한다.
+`patchtype`의 기본값은 `strategic`이다.
+- `extension`은 `json` 또는 `yaml` 중 하나여야 한다.
+- `suffix`는 어떤 패치가 먼저 적용되는지를 결정하는 데 사용할 수 있는 영숫자 형태의
+선택적 문자열이다.
+
+{{< note >}}
+`kubeadm upgrade`를 사용하여 kubeadm 노드를 업그레이드하는 경우, 업그레이드 이후에도
+사용자 정의를 유지하려면 동일한 패치를 다시 제공해야 한다. 이는 동일한 디렉토리로 지정된 `--patches`
+플래그를 사용하여 처리할 수 있다. `kubeadm upgrade`는 동일 목적으로 재사용할 수 있는 구성
+API 구조를 현재는 지원하지 않는다.
+{{< /note >}}
+
+## kubelet 사용자 정의하기
+
+kubelet을 사용자 정의하려면, `KubeletConfiguration`을 동일한 구성 파일 내에서 `---`로 구분된 `ClusterConfiguration`이나 `InitConfiguration` 다음에 추가하면
+된다. 그런 다음 `kubeadm init`에 해당 파일을 전달한다.
+
+{{< note >}}
+kubeadm은 클러스터의 모든 노드에 동일한 `KubeletConfiguration`을 적용한다. 노드별 설정을
+적용하려면 kubelet 플래그를 덮어쓰기(overrides)로 사용하여, `InitConfiguration` 및
+`JoinConfiguration` 모두에서 지원되는 `nodeRegistration.kubeletExtraArgs`에 전달할 수 있다.
+일부 kubelet 플래그는 더 이상 사용되지 않는다(deprecated). 따라서 사용하기 전에 [kubelet 참조 문서](/docs/reference/command-line-tools-reference/kubelet)를 통해
+상태를 확인해야 한다.
+{{< /note >}}
+
+자세한 사항은 [kubeadm을 통해 클러스터의 각 kubelet 구성하기](/docs/setup/production-environment/tools/kubeadm/kubelet-integration)에서 살펴본다.
+
+## kube-proxy 사용자 정의하기
+
+kube-proxy를 사용자 정의하려면, `KubeProxyConfiguration`을 `---`로 구분된 `ClusterConfiguration`이나 `InitConfiguration`
+다음에 두고 `kubeadm init`에 전달하면 된다.
+
+자세한 사항은 [API 참조 페이지](https://godoc.org/k8s.io/kubernetes/cmd/kubeadm/app/apis/kubeadm/v1beta3)에서 살펴볼 수 있다.
+
+{{< note >}}
+kubeadm은 kube-proxy를 {{< glossary_tooltip text="데몬셋" term_id="daemonset" >}}으로 배포한다. 이것은
+`KubeProxyConfiguration`이 클러스터의 모든 kube-proxy 인스턴스에 적용된다는 것을 의미한다.
+{{< /note >}}