From 170e2be5df72564323ee43a744a186dab390dcfd Mon Sep 17 00:00:00 2001 From: zerobig Date: Mon, 5 Nov 2018 08:32:13 +0900 Subject: [PATCH] Translate concepts/overview/components in Korean #10717 --- .../ko/docs/concepts/overview/components.md | 107 ++++++++++++++++++ .../ko/docs/reference/glossary/controller.md | 18 +++ content/ko/docs/reference/glossary/etcd.md | 20 ++++ .../docs/reference/glossary/kube-apiserver.md | 17 +++ .../glossary/kube-controller-manager.md | 18 +++ 5 files changed, 180 insertions(+) create mode 100644 content/ko/docs/concepts/overview/components.md create mode 100644 content/ko/docs/reference/glossary/controller.md create mode 100644 content/ko/docs/reference/glossary/etcd.md create mode 100644 content/ko/docs/reference/glossary/kube-apiserver.md create mode 100644 content/ko/docs/reference/glossary/kube-controller-manager.md diff --git a/content/ko/docs/concepts/overview/components.md b/content/ko/docs/concepts/overview/components.md new file mode 100644 index 0000000000000..f6d26fb4b4d8d --- /dev/null +++ b/content/ko/docs/concepts/overview/components.md @@ -0,0 +1,107 @@ +--- +reviewers: +- lavalamp +title: 쿠버네티스 컴포넌트 +content_template: templates/concept +weight: 20 +--- + +{{% capture overview %}} +이 문서는 기능 수행하는 쿠버네티스 클러스터를 제공하기 위해 필요한 +다양한 바이너리 컴포넌트들에 대해 요약하여 정리한다 +{{% /capture %}} + +{{% capture body %}} +## 마스터 컴포넌트 + +마스터 컴포넌트는 클러스터의 컨트롤 플레인을 제공한다. 마스터 컴포넌트는 클러스터에 관한 전반적인 결정 +(예를 들어, 스케줄링)을 수행하고 클러스터 이벤트(레플리케이션 컨트롤러의 '레플리카' 필드가 요구조건을 충족되지 않을 경우 새로운 파드를 구동 시키는 것)를 감지하고 반응한다. + +마스터 컴포넌트는 클러스터 내 어떠한 머신에서든지 동작 될 수 있다. 그러나, +간결성을 위하여, 구성 스크립트는 보통 동일 머신 상에 모든 마스터 컴포넌트를 구동시키고, +사용자 컨테이너는 해당 머신 상에 동작시키지 않는다. 다중-마스터-VM 설치 예제를 보려면 +[고가용성 클러스터 구성하기](/docs/admin/high-availability/)를 확인해본다. + +### kube-apiserver + +{{< glossary_definition term_id="kube-apiserver" length="all" >}} + +### etcd + +{{< glossary_definition term_id="etcd" length="all" >}} + +### 큐브-스케줄러 + +{{< glossary_definition term_id="kube-scheduler" length="all" >}} + +### 큐브-컨트롤러-매니저 + +{{< glossary_definition term_id="kube-controller-manager" length="all" >}} + +이들 컨트롤러는 다음을 포함한다. + + * 노드 컨트롤러: 노드가 다운되었을 때 통지와 대응에 관한 책임을 가진다. + * 레플리케이션 컨트롤러: 시스템의 모든 레플리케이션 컨트롤러 오브젝트에 대해 알맞는 수의 파드들을 + 유지시켜 주는 책임을 가진다. + * 엔드포인트 컨트롤러: 엔드포인트 오브젝트를 채운다(즉, 서비스 & 파드를 가입시킨다.) + * 서비스 계정 & 토큰 컨트롤러: 새로운 네임스페이스에 대한 기본 계정과 API 접근 토큰을 생성한다. + +### 클라우드-컨트롤러-매니저 + +[클라우드-컨트롤러-매니저](/docs/tasks/administer-cluster/running-cloud-controller/)는 바탕을 이루는 클라우드 제공사업자와 상호작용하는 컨트롤러를 작동시킨다. 클라우드-컨트롤러-매니저 바이너리는 쿠버네티스 릴리스 1.6에서 도입된 알파 기능이다. + +클라우드-컨트롤러-매니저는 클라우드-제공사업자-특유 컨트롤러 루프만을 동작시킨다. 이 컨트롤러 루프는 큐브-컨트롤러-매니저에서 비활성 시켜야만 한다. 큐브-컨트롤러-매니저를 구동시킬 때 `--cloud-provider` 플래그를 `external`로 설정함으로써 이 컨트롤러 루프를 비활성 시킬 수 있다. + +클라우드-컨트롤러-매니저는 클라우드 밴더 코드와 쿠버네티스 코어가 서로 독립적으로 발전시켜 나갈 수 있도록 해준다. 이전 릴리스에서는, 코어 쿠버네티스 코드가 기능상으로 클라우드-제공사업자-특유 코드에 대해 의존적이었다. 향후 릴리스에서, 클라우드 밴더에 따른 코드는 클라우드 밴더 자체에 의해 유지되도록 하여야만 하며, 쿠버네티스가 동작하는 동안 클라우드-컨트롤러-매니저에 연계되도록 하여야만 한다. + +다음 컨트롤러들은 클라우드 제공사업자의 의존성을 갖는다. + + * 노드 컨트롤러: 노드가 응답을 멈추고 나서 클라우드 상에서 삭제되어 졌는지 확정하기 위해 클라우드 제공사업자에게 확인하는 것 + * 라우트 컨트롤러: 바탕을 이루는 클라우드 인프라에 경로를 구성하는 것 + * 서비스 컨트롤러: 클라우드 제공사업자 로드밸런서를 생성, 업데이트 그리고 삭제하는 것 + * 볼륨 컨트롤러: 볼륨의 생성, 부착 그리고 마운트 하는 것과 볼륨을 조정하기 위해 클라우드 제공사업자와 상호작용 하는 것 + +## 노드 컴포넌트 + +노드 컴포넌트는 동작중인 파드를 유지시키고 쿠버네티스 런타임 환경을 제공하며, 모든 노드 상에서 동작한다. + +### kubelet + +{{< glossary_definition term_id="kubelet" length="all" >}} + +### kube-proxy + +[kube-proxy](/docs/admin/kube-proxy/)는 호스트 상에서 네트워크 규칙을 유지하고 연결에 대한 포워딩을 수행함으로서 쿠버네티스 서비스 추상화가 가능하도록 해준다. + +### 컨테이너 런타임 + +컨테이너 런타임은 컨테이너의 동작을 책임지는 소프트웨어다. 쿠버네티스는 몇몇의 런타임을 지원하는데 [Docker](http://www.docker.com), [rkt](https://coreos.com/rkt/), [runc](https://github.com/opencontainers/runc) 그리고 OCI [runtime-spec](https://github.com/opencontainers/runtime-spec)을 충족하는 모든 런타임 등이 있다. + +## 애드온 + +애드온은 클러스터 기능을 이행하는 파드와 서비스다. 이 파드는 디플로이먼트, 레플리케이션 컨트롤러, 기타 등등에 의해 관리될 수도 있다. 네임스페이스를 갖는 애드온 오브젝트는 `kube-system` 네임스페이스 내에서 생성되어 진다. + +선택된 일부 애드온이 아래에 설명되었으며, 사용가능한 전체 확장 애드온 리스트는 +[애드온](/docs/concepts/cluster-administration/addons/)을 참조한다. + +### DNS + +여타 애드온들이 절대적으로 요구되지 않는 반면에, 많은 예시들에서 그것을 필요로 하기때문에 모든 쿠버네티스 클러스터는 [cluster DNS](/docs/concepts/services-networking/dns-pod-service/)를 갖추어야만 한다. + +클러스터 DNS는 구성환경 내 다른 DNS 서버와 더불어, 쿠버네티스 서비스를 위해 DNS 레코드를 제공해주는 DNS 서버다. + +쿠버네티스에 의해 구동되는 컨테이너는 DNS 검색에서 이 DNS 서버를 자동으로 포함시킨다. + +### 웹 UI (대쉬보드) + +[대쉬보드](/docs/tasks/access-application-cluster/web-ui-dashboard/)는 쿠버네티스 클러스터를 위한 범용의 웹 기반 UI다. 사용자로 하여금 클러스터 자체 뿐만 아니라, 클러스터에서 동작하는 애플리케이션에 대한 관리와 고창처리를 할 수 있도록 허용해준다. + +### 컨테이너 리소스 모니터링 + +[컨테이너 리소스 모니터링](/docs/tasks/debug-application-cluster/resource-usage-monitoring/)은 중앙 데이터베이스 내에 컨테이너들에 대한 포괄적인 시계열 메트릭스를 기록하고 그 데이터를 열람하기 위한 UI를 제공해 준다. + +### 클러스터-레벨 로깅 + +A [클러스터-레벨 로깅](/docs/concepts/cluster-administration/logging/) 메커니즘은 검색/열람 인터페이스와 함께 중앙 로그 저장소에 컨테이너 로그를 저장하는 책임을 가진다. + +{{% /capture %}} diff --git a/content/ko/docs/reference/glossary/controller.md b/content/ko/docs/reference/glossary/controller.md new file mode 100644 index 0000000000000..30bd99119d72c --- /dev/null +++ b/content/ko/docs/reference/glossary/controller.md @@ -0,0 +1,18 @@ +--- +title: 컨트롤러 +id: controller +date: 2018-04-12 +full_link: /docs/admin/kube-controller-manager/ +short_description: > + apiserver를 통해 클러스터의 공유 상태를 감시하고 현재 상태를 의도한 상태가 되도록 변경시켜주는 컨트롤러 루프. + +aka: +tags: +- architecture +- fundamental +--- + {{< glossary_tooltip text="apiserver" term_id="kube-apiserver" >}}를 통해 클러스터의 공유 상태를 감시하고 현재 상태를 의도한 상태가 되도록 변경시켜주는 컨트롤러 루프 + + + +최근 쿠버네티스와 함께 출하되는 컨트롤러의 예로는 레플리케이션 컨트롤러, 엔드포인트 컨트롤러, 네임스페이스 컨트롤러, 서비스계정 컨트롤러 등이 있다. diff --git a/content/ko/docs/reference/glossary/etcd.md b/content/ko/docs/reference/glossary/etcd.md new file mode 100644 index 0000000000000..1facfea62adff --- /dev/null +++ b/content/ko/docs/reference/glossary/etcd.md @@ -0,0 +1,20 @@ +--- +title: etcd +id: etcd +date: 2018-04-12 +full_link: /docs/tasks/administer-cluster/configure-upgrade-etcd/ +short_description: > + 일관성 있고 고가용성의 키 밸류 스토어로 전체 클러스터 데이터에 대한 쿠버네티스의 보조 기억 수단으로 이용된다. + + + +aka: +tags: +- architecture +- storage +--- +일관성 있고 고가용성의 키 밸류 스토어로 전체 클러스터 데이터에 대한 쿠버네티스의 보조 기억 수단으로 이용된다. + + + +항상 여러분의 쿠버네티스 클러스터와 관련된 etcd의 데이터를 위해 백업 계획을 세운다. etcd에 관한 보다 상세한 정보는 [etcd 문서](https://github.com/coreos/etcd/blob/master/Documentation/docs.md)를 참고한다. diff --git a/content/ko/docs/reference/glossary/kube-apiserver.md b/content/ko/docs/reference/glossary/kube-apiserver.md new file mode 100644 index 0000000000000..6169c0cc0bbb7 --- /dev/null +++ b/content/ko/docs/reference/glossary/kube-apiserver.md @@ -0,0 +1,17 @@ +--- +title: kube-apiserver +id: kube-apiserver +date: 2018-04-12 +full_link: /docs/reference/generated/kube-apiserver/ +short_description: > + 쿠버네티스 API를 노출시켜주는 마스터 상의 컴포넌트. 쿠버네티스 컨트롤 플레인의 프론트 엔드이다. +aka: +tags: +- architecture +- fundamental +--- + 쿠버네티스 API를 노출시켜주는 마스터 상의 컴포넌트. 쿠버네티스 컨트롤 플레인의 프론트 엔드이다. + + + +수평적으로 규모를 조정하기 위해 설계되었다. 즉, 더 많은 인스턴스를 배포함으로써 규모를 조정한다. See [고가용성 클러스터 구성하기](/docs/admin/high-availability/)를 참고한다. diff --git a/content/ko/docs/reference/glossary/kube-controller-manager.md b/content/ko/docs/reference/glossary/kube-controller-manager.md new file mode 100644 index 0000000000000..e54e56e24a215 --- /dev/null +++ b/content/ko/docs/reference/glossary/kube-controller-manager.md @@ -0,0 +1,18 @@ +--- +title: 큐브-컨트롤러-매니저 +id: kube-controller-manager +date: 2018-04-12 +full_link: /docs/reference/generated/kube-controller-manager/ +short_description: > + 컨트롤러를 동작시키는 마스터 상의 컴포넌트다. + +aka: +tags: +- architecture +- fundamental +--- + {{< glossary_tooltip text="컨트롤러" term_id="controller" >}}를 동작시키는 마스터 상의 컴포넌트다. + + + +논리적으로, 각 {{< glossary_tooltip text="controller" term_id="controller" >}}는 분리된 프로세스이긴 하지만, 복잡도를 줄이기 위해, 하나의 바이너리에 컴파일 되어 하나의 프로세스 내에서 동작한다.