From 68cd3e3a04b8d539fcdc7826c015ad327f152241 Mon Sep 17 00:00:00 2001 From: Yoon Date: Mon, 19 Aug 2019 10:34:04 +0900 Subject: [PATCH] ko: translate setup/production-environment/tools/ha-topology (#15819) * ko: translate setup/production-environment/tools/ha-topology * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md Co-Authored-By: Seokho Son * Update ha-topology.md --- .../tools/kubeadm/_index.md | 4 ++ .../tools/kubeadm/ha-topology.md | 70 +++++++++++++++++++ 2 files changed, 74 insertions(+) create mode 100644 content/ko/docs/setup/production-environment/tools/kubeadm/_index.md create mode 100644 content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md diff --git a/content/ko/docs/setup/production-environment/tools/kubeadm/_index.md b/content/ko/docs/setup/production-environment/tools/kubeadm/_index.md new file mode 100644 index 0000000000000..091b2a31d211e --- /dev/null +++ b/content/ko/docs/setup/production-environment/tools/kubeadm/_index.md @@ -0,0 +1,4 @@ +--- +title: "kubeadm으로 클러스터 구성하기" +weight: 10 +--- diff --git a/content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md b/content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md new file mode 100644 index 0000000000000..ac6cab8aa5334 --- /dev/null +++ b/content/ko/docs/setup/production-environment/tools/kubeadm/ha-topology.md @@ -0,0 +1,70 @@ +--- +reviewers: +title: 고가용성 토폴로지 선택 +content_template: templates/concept +weight: 50 +--- + +{{% capture overview %}} + +이 페이지는 고가용성(HA) 쿠버네티스 클러스터의 토플로지를 구성하는 두 가지 선택 사항을 설명한다. + +다음과 같이 HA 클러스터를 구성할 수 있다. + +- etcd 노드와 컨트롤 플레인 노드를 함께 위치시키는 중첩된(stacked) 컨트롤 플레인 노드 방식 +- etcd와 컨트롤 플레인이 분리된 노드에서 운영되는 외부 etcd 노드 방식 + +HA 클러스터를 구성하기 전에 각 토플로지의 장단점을 주의 깊게 고려해야 한다. + +{{% /capture %}} + +{{% capture body %}} + +## 중첩된 etcd 토플로지 + +중첩된 HA 클러스터는 etcd에서 제공하는 분산 데이터 저장소 클러스터를, +컨트롤 플레인 구성 요소를 실행하는 kubeadm으로 관리되는 노드에 의해서 형성된 클러스터 상단에 +중첩하는 [토플로지](https://en.wikipedia.org/wiki/Network_topology)이다. + +각 컨트롤 플레인 노드는 `kube-apiserver`, `kube-scheduler`, `kube-controller-manager` 인스턴스를 운영한다. +`kube-apiserver`는 로드 밸런서를 이용하여 워커 노드에 노출되어 있다. + +각 컨트롤 플레인 노드는 지역 etcd 맴버를 생성하고 +이 etcd 맴버는 오직 해당 노드의 `kube-apiserver`와 통신한다. +비슷한 방식이 지역의 `kube-controller-manager`와 `kube-scheduler`에도 적용된다. + +이 토플로지는 컨트롤 플레인과 etcd 맴버가 같은 노드에 묶여 있다. +이는 외부 etcd 노드의 클러스터를 구성하는 것보다는 단순하며 복제 관리도 간단하다. + +그러나 중첩된 클러스터는 커플링에 실패할 위험이 있다. 한 노드가 다운되면 etcd 맴버와 컨트롤 플레인을 모두 잃어버리고, +중복성도 손상된다. 더 많은 컨트롤 플레인 노드를 추가하여 이 위험을 완화할 수 있다. + +그러므로 HA 클러스터를 위해 최소 3개인 중첩된 컨트롤 플레인 노드를 운영해야 한다. + +이는 kubeadm의 기본 토플로지이다. 지역 etcd 맴버는 +`kubeadm init`와 `kubeadm join --control-plane` 을 이용할 때에 컨트롤 플레인 노드에 자동으로 생성된다. + +![중첩된 etcd 토플로지](/images/kubeadm/kubeadm-ha-topology-stacked-etcd.svg) + +## 외부 etcd 토플로지 + +외부 etcd를 이용하는 HA 클러스터는 etcd로 제공한 분산된 데이터 스토리지 클러스터가 컨트롤 플레인 구성 요소를 운영하는 노드로 형성하는 클러스터의 외부에 있는 [토플로지](https://en.wikipedia.org/wiki/Network_topology)이다. + +중첩된 etcd 토플로지와 유사하게, 외부 etcd 토플로지에 각 컨트롤 플레인 노드는 `kube-apiserver`, `kube-scheduler`, `kube-controller-manager`의 인스턴스를 운영한다. 그리고 `kube-apiserver`는 로드 밸런서를 이용하여 워커노드에 노출한다. 그러나 etcd 맴버는 분리된 호스트에서 운영되고, 각 etcd 호스트는 각 컨트롤 플레인 노드의 `kube-apiserver`와 통신한다. + +이 토플로지는 컨트롤 플레인과 etcd 맴버를 분리한다. 이는 그러므로 +컨트롤 플레인 인스턴스나 etcd 맴버를 잃는 충격이 덜하고, +클러스터 중복성에 있어 중첩된 HA 토플로지만큼 영향을 미치지 않는다. + +그러나, 이 토플로지는 중첩된 토플로지에 비해 호스트 개수가 두배나 필요하다. +이 토플로지로 HA 클러스터를 구성하기 위해서는 최소한 3개의 컨트롤 플레인과 3개의 etcd 노드가 필요하다. + +![외부 etcd 토플로지](/images/kubeadm/kubeadm-ha-topology-external-etcd.svg) + +{{% /capture %}} + +{{% capture whatsnext %}} + +- [kubeadm을 이용하여 고가용성 클러스터 구성하기](/docs/setup/production-environment/tools/kubeadm/high-availability/) + +{{% /capture %}}