Fifth Korean l10n work for release-1.13. (#12420)

* ko-trans: glossary/kube-scheduler.md (#12269) * ko-trans: Update outdated files partly in dev-1.13-ko.5 (#12246) * ko-trans: Update outdated files partly in dev-1.13-ko.5 (#12267) * Update outdated in tutorials/kubernetes-basics/ for dev-1.13-ko.5 (#12272) * ko/examples/application/deployment.yaml (#12293) * ko-trans: add tutorials/hello-minikube.md #11532 (#12273) * Translate concepts/containers/container-environment-variables in Korean (#12382) * ko: Tutorial compoent rearrange (#12400) * Translate content/ko/docs/concepts/architecture/master-node-communication in Korean #11963 (#12315) * Translate concepts/workloads/pods/podpreset in Korean (#12308) * Translate concepts/workloads/pods/init-containers in Korean (#12298) * ko-trans: add setup/minikube.md #11531 (#12274) * ko/docs/setup/cluster-large.md (#12370) Co-authored-by: Seokho <[email protected]> Co-authored-by: Kim Young Dae <[email protected]> Co-authored-by: Claudia J.Kang <[email protected]> Co-authored-by: Yoon <[email protected]> Co-authored-by: Jmnote <[email protected]> Co-authored-by: June Yi <[email protected]>
kubernetes · Feb 19, 2019 · 89fe74d · 89fe74d
1 parent a7792a6
commit 89fe74d
Show file tree

Hide file tree

Showing 22 changed files with 981 additions and 554 deletions.
diff --git a/content/ko/_index.html b/content/ko/_index.html
@@ -8,7 +8,7 @@
 
 {{< blocks/section id="oceanNodes" >}}
 {{% blocks/feature image="flower" %}}
-### [쿠버네티스]({{< relref "/docs/concepts/overview/what-is-kubernetes" >}})는 컨테이너화된 애플리케이션을 자동으로 배포, 스케일링 및 관리해주는 오픈소스 시스템입니다.
+### [쿠버네티스 (k8s)]({{< relref "/docs/concepts/overview/what-is-kubernetes" >}})는 컨테이너화된 애플리케이션을 자동으로 배포, 스케일링 및 관리해주는 오픈소스 시스템입니다.
 
 애플리케이션을 구성하는 컨테이너들의 쉬운 관리 및 발견을 위해서 컨테이너들을 논리적인 단위로 그룹화합니다. 쿠버네티스는 [Google에서 15년간 프로덕션 워크로드 운영한 경험](http://queue.acm.org/detail.cfm?id=2898444)을 토대로 구축되었으며, 커뮤니티에서 제공한 최상의 아이디어와 방법들이 결합되어 있습니다.
 {{% /blocks/feature %}}
@@ -44,12 +44,12 @@ <h2>150+ 마이크로서비스를 쿠버네티스로 마이그레이션하는
         <br>
         <br>
         <br>
-        <a href="https://www.lfasiallc.com/events/kubecon-cloudnativecon-china-2018/" button id="desktopKCButton">Attend KubeCon in Shanghai on Nov. 13-15, 2018</a>
+        <a href="https://events.linuxfoundation.org/events/kubecon-cloudnativecon-europe-2019" button id="desktopKCButton">Attend KubeCon in Barcelona on May 20-23, 2019</a>
         <br>
         <br>
         <br>
         <br>
-        <a href="https://events.linuxfoundation.org/events/kubecon-cloudnativecon-north-america-2018/" button id="desktopKCButton">Attend KubeCon in Seattle on Dec. 11-13, 2018</a>
+        <a href="https://www.lfasiallc.com/events/kubecon-cloudnativecon-china-2019" button id="desktopKCButton">Attend KubeCon in Shanghai on June 24-26, 2019</a>
 </div>
 <div id="videoPlayer">
     <iframe data-url="https://www.youtube.com/embed/H06qrNmGqyE?autoplay=1" frameborder="0" allowfullscreen></iframe>
@@ -60,3 +60,4 @@ <h2>150+ 마이크로서비스를 쿠버네티스로 마이그레이션하는
 {{< blocks/kubernetes-features >}}
 
 {{< blocks/case-studies >}}
+
diff --git a/content/ko/docs/concepts/architecture/master-node-communication.md b/content/ko/docs/concepts/architecture/master-node-communication.md
@@ -0,0 +1,88 @@
+---
+title: 마스터-노드 커뮤니케이션
+content_template: templates/concept
+weight: 20
+---
+
+{{% capture overview %}}
+
+이 문서는 마스터(실제 apiserver)와 쿠버네티스 클러스터 사이의 커뮤니케이션 경로를 나열해 본다.
+그 목적은 사용자로 하여금 untrusted network(신뢰할 수 없는 네트워크) 상에서
+(또는 클라우드 제공사업자 환경에서 완전히 공인 IP로) 동작될 수 있는
+그러한 클러스터의 네트워크 구성을 강화하기 위해 사용자의 설치를 커스터마이즈 할 수 있도록 해주기 위함이다.
+
+{{% /capture %}}
+
+
+{{% capture body %}}
+
+## 클러스터에서 마스터로
+
+클러스터에서 마스터로의 모든 커뮤니케이션 경로는 apiserver에서 끝난다
+(어떤 다른 마스터 컴포넌트도 원격 서비스를 노출하기 위해 설계되지 않는다).
+전형적인 배포에서, apiserver는 하나 또는 그 이상의 클라이언트 [인증](/docs/reference/access-authn-authz/authentication/) 형태가
+사용가능토록 하여 안전한 HTTPS 포트(443)를 통해 원격 연결에 대해 서비스 리슨하도록 구성된다.
+특히 [익명의 요청](/docs/reference/access-authn-authz/authentication/#anonymous-requests)
+또는 [서비스 계정 토큰](/docs/reference/access-authn-authz/authentication/#service-account-tokens)이   
+허용된 경우에는 하나 또는 그 이상의 [인가](/docs/reference/access-authn-authz/authorization/) 형태가 사용 가능해야만 한다.
+
+노드는 유효한 클라이언트 자격증명과 함께 apiserver에 안전하게 접속할 수 있는
+그런 클러스터용 공인 루트 인증서를 가지고 제공되어야 한다.
+예를 들어, 기본 GKE 배포의 경우, kubelet에 제공되는 클라이언트 자격증명은
+클라이언트 인증서의 형태로 존재한다. kubelet 클라이언트 인증서에 대한 자동화 프로비저닝에 대해서는
+[kubelet TLS bootstrapping](/docs/reference/command-line-tools-reference/kubelet-tls-bootstrapping/)을 참고한다.
+
+apiserver에 접속하려는 파드는 서비스 계정에 영향력을 발휘함으로써 안전하게
+그리 행할 수 있으며 따라서 쿠버네티스는 인스턴스화 될 때 공인 루트 인증서와
+유효한 베어러 토큰을 파드 속으로 자동 주입할 수 있게 된다.
+(모든 네임스페이스 내) `kubernetes` 서비스는 apiserver 상의 HTTPS 엔드포인트로  
+(kube-proxy를 통해) 리다이렉트 되는 가상 IP 주소를 가지고 구성된다.
+
+마스터 컴포넌트는 또한 신뢰할 수 있는 포트를 통해 클러스터 apiserver와 소통한다.
+
+결과적으로, 클러스터 (노드 그리고 노드에서 동작하는 파드)에서
+마스터로의 기본 동작 모드는 기본적으로 안전하며
+신뢰할 수 없는그리고/또는 공인 네트워크 상에서 동작할 수 있다.
+
+## 마스터에서 클러스터로
+
+마스터(apiserver)에서 클러스터로의 두 가지 주된 커뮤니케이션 경로가 존재한다.
+첫 번째는 클러스터 내 각 노드를 동작시키는 apiserver에서 kubelet 프로세스로의
+경로이다. 두 번째는 apiserver에서 apiserver의 프록시 기능을 통한 임의의 노드,
+파드 또는 서비스로의 경로이다.
+
+### apiserver에서 kubelet으로
+
+apiserver에서 kubelet으로의 연결은 다음을 위해 이용된다.
+
+  * 파드에 대한 로그 가져오기
+  * 동작중인 파드에 (kubectl을 통해) 연관짓기
+  * kubelet의 포트 포워딩 기능 제공하기
+
+이 연결은 kubelet의 HTTPS 엔드포인트에서 끝난다. 기본적으로,
+apiserver는 kubelet의 제공 인증서를 확인하지 않는데,
+이는 연결에 대한 중간자 공격을 당하게 하고, 신뢰할 수 없는
+그리고/또는 공인 네트워크에서 운영하기에는 **불안** 하게 만든다.  
+
+이 연결을 확인하려면, apiserver에 kubelet의 제공 인증서 확인을 위해 사용하는
+루트 인증서 번들로 `--kubelet-certificate-authority` 플래그를 이용한다
+
+그것이 불가능한 경우, 신뢰할 수 없는 또는 공인 네트워크에 대한 연결을 피하고 싶다면,
+apiserver와 kubelet 사이에 [SSH 터널링](/docs/tasks/access-application-cluster/port-forward-access-application-cluster/)을
+사용한다.
+
+마지막으로, kubelet API를 안전하게 하기 위해
+[Kubelet 인증 그리고/또는 인가](/docs/admin/kubelet-authentication-authorization/)가 활성화 되어야만 한다.
+
+### apiserver에서 노드, 파드, 그리고 서비스로
+
+apiserver에서 노드, 파드, 또는 서비스로의 연결은 보통 HTTP 연결을
+기본으로 하므로 인증도 암호화도 되지 않는다. API URL 내 노드, 파드, 또는 서비스 이름에
+`https:` 프리픽스를 붙임으로써 안전한 HTTPS 연결로 동작될 수 있지만,
+HTTPS 엔드포인트에 의해 제공되는 인증서를 확인하지 않으며
+클라이언트 자격증명 또한 제공하지 않는다.
+그래서 연결이 암호화될 동안, 어떠한 무결성도 제공되지 않을 것이다.
+이러한 연결들은 신뢰할 수 없는 그리고/또는 공인 네트워크에서 동작하기에
+**현재로서는 안전하지 않다**.
+
+{{% /capture %}}
diff --git a/content/ko/docs/concepts/architecture/nodes.md b/content/ko/docs/concepts/architecture/nodes.md
@@ -171,24 +171,7 @@ DaemonSet 컨트롤러에 의해 생성된 파드는 쿠버네티스 스케줄
 
 쿠버네티스 스케줄러는 노드 상에 모든 노드에 대해 충분한 리소스가 존재하도록 보장한다. 노드 상에 컨테이너에 대한 요청의 합이 노드 용량보다 더 크지 않도록 체크한다. kubelet에 의해 구동된 모든 컨테이너를 포함하지만, [컨테이너 런타임](/docs/concepts/overview/components/#node-components)에 의해 직접 구동된 컨테이너 또는 컨테이너 외부에서 동작하는 임의의 프로세스는 해당되지 않는다.
 
-파드 형태가 아닌 프로세스에 대해 명시적으로 리소스를 확보하려면, 플레이스홀더 파드를 생성할 수 있다. 다음 템플릿을 이용한다.
-
-```yaml
-apiVersion: v1
-kind: Pod
-metadata:
-  name: resource-reserver
-spec:
-  containers:
-  - name: sleep-forever
-    image: k8s.gcr.io/pause:0.8.0
-    resources:
-      requests:
-        cpu: 100m
-        memory: 100Mi
-```
-
-`cpu`와 `memory`값을 확보하고자 하는 리소스의 양만큼 설정한다. 메니페스트 디렉토리 내 파일을 둔다(kubelet 의 `--config=DIR` 플래그). 리소스를 확보하고자 하는 위치에 각 kubelet 에 대해 이를 수행한다.
+파드 형태가 아닌 프로세스에 대해 명시적으로 리소스를 확보하려면, [reserve resources for system daemons](/docs/tasks/administer-cluster/reserve-compute-resources/#system-reserved) 튜토리얼을 따른다.
 
 
 ## API 오브젝트

diff --git a/content/ko/docs/concepts/containers/_index.md b/content/ko/docs/concepts/containers/_index.md
@@ -0,0 +1,5 @@
+---
+title: "컨테이너"
+weight: 40
+---
+
diff --git a/content/ko/docs/concepts/containers/container-environment-variables.md b/content/ko/docs/concepts/containers/container-environment-variables.md
@@ -0,0 +1,60 @@
+---
+title: 컨테이너 환경 변수
+content_template: templates/concept
+weight: 20
+---
+
+{{% capture overview %}}
+
+이 페이지는 컨테이너 환경에서 컨테이너에 가용한 리소스에 대해 설명한다.
+
+{{% /capture %}}
+
+
+{{% capture body %}}
+
+## 컨테이너 환경
+
+쿠버네티스 컨테이너 환경은 컨테이너에 몇 가지 중요한 리소스를 제공한다.
+
+* 하나의 [이미지](/docs/concepts/containers/images/)와 하나 이상의 [볼륨](/docs/concepts/storage/volumes/)이 결합된 파일 시스템.
+* 컨테이너 자신에 대한 정보.
+* 클러스터 내의 다른 오브젝트에 대한 정보.
+
+### 컨테이너 정보
+
+컨테이너의 *호스트네임* 은 컨테이너가 동작 중인 파드의 이름과 같다.
+그것은 `hostname` 커맨드 또는 libc의 
+[`gethostname`](http://man7.org/linux/man-pages/man2/gethostname.2.html) 
+함수 호출을 통해서 구할 수 있다.
+
+파드 이름과 네임스페이스는 
+[다운워드(Downward) API](/docs/tasks/inject-data-application/downward-api-volume-expose-pod-information/)를 통해 환경 변수로 구할 수 있다.
+
+Docker 이미지에 정적으로 명시된 환경 변수와 마찬가지로,
+파드 정의에서의 사용자 정의 환경 변수도 컨테이너가 사용할 수 있다.
+
+### 클러스터 정보
+
+컨테이너가 생성될 때 실행 중이던 모든 서비스의 목록은 환경 변수로 해당 컨테이너에서 사용할 수 
+있다.
+이러한 환경 변수는 Docker 링크 구문과 일치한다.
+
+*bar* 라는 이름의 컨테이너에 매핑되는 *foo* 라는 이름의 서비스에 대해서는, 
+다음의 형태로 변수가 정의된다.
+
+```shell
+FOO_SERVICE_HOST=<서비스가 동작 중인 호스트>
+FOO_SERVICE_PORT=<서비스가 동작 중인 포트>
+```
+
+서비스에 지정된 IP 주소가 있고 [DNS 애드온](http://releases.k8s.io/{{< param "githubbranch" >}}/cluster/addons/dns/)이 활성화된 경우, DNS를 통해서 컨테이너가 서비스를 사용할 수 있다.
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+* [컨테이너 라이프사이클 훅(hooks)](/docs/concepts/containers/container-lifecycle-hooks/)에 대해 더 배워 보기.
+* [컨테이너 라이프사이클 이벤트에 핸들러 부착](/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/) 실제 경험 얻기.
+
+{{% /capture %}}
diff --git a/content/ko/docs/concepts/overview/kubernetes-api.md b/content/ko/docs/concepts/overview/kubernetes-api.md
@@ -123,6 +123,6 @@ API 그룹은 REST 경로와 직렬화된 객체의 `apiVersion` 필드에 명
 데몬셋, 디플로이먼트, HorizontalPodAutoscaler, 인그레스, 잡 및 레플리카셋이 기본적으로 활성화되어 있다.
 다른 확장 리소스는 apiserver의 `--runtime-config`를 설정해서 활성화 시킬 수 있다.
 `--runtime-config`는 쉼표로 분리된 값을 허용한다. 예를 들어 디플로이먼트와 인그레스를 비활성화 시키려면,
-`--runtime-config=extensions/v1beta1/deployments=false,extensions/v1beta1/ingress=false`와 같이 설정한다.
+`--runtime-config=extensions/v1beta1/deployments=false,extensions/v1beta1/ingresses=false`와 같이 설정한다.
 
 {{% /capture %}}