add ko pages

2020-06-01 09:09:39 -04:00
parent 283572af58
commit 6bfc167c79
168 changed files with 1360 additions and 1190 deletions
@@ -1,10 +1,10 @@
 ---
 title: 크론잡
-content_template: templates/concept
+content_type: concept
 weight: 80
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< feature-state for_k8s_version="v1.8" state="beta" >}}

@@ -28,8 +28,8 @@ kube-controller-manager 컨테이너에 설정된 시간대는 크론잡 컨트
 63자라는 제약 조건이 있기 때문이다.


-{{% /capture %}}
-{{% capture body %}}
+
+<!-- body -->

 ## 크론잡

@@ -77,12 +77,13 @@ Cannot determine if job needs to be started. Too many missed start time (> 100).
 크론 잡은 오직 그 일정에 맞는 잡 생성에 책임이 있고,
 잡은 그 잡이 대표하는 파드 관리에 책임이 있다.

-{{% /capture %}}
-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 [크론 표현 포맷](https://pkg.go.dev/github.com/robfig/cron?tab=doc#hdr-CRON_Expression_Format)은
 크론잡 `schedule` 필드의 포맷을 문서화 한다.

 크론 잡 생성과 작업에 대한 지침과 크론잡 매니페스트의
 예는 [크론 잡으로 자동화된 작업 실행하기](/docs/tasks/job/automated-tasks-with-cron-jobs/)를 참조한다.

-{{% /capture %}}
+
@@ -1,10 +1,10 @@
 ---
 title: 데몬셋
-content_template: templates/concept
+content_type: concept
 weight: 50
 ---

-{{% capture overview %}}
+<!-- overview -->

 _데몬셋_ 은 모든(또는 일부) 노드가 파드의 사본을 실행하도록 한다. 노드가 클러스터에 추가되면 
 파드도 추가된다. 노드가 클러스터에서 제거되면 해당 파드는 가비지(garbage)로 
@@ -20,10 +20,10 @@ _데몬셋_ 은 모든(또는 일부) 노드가 파드의 사본을 실행하도
 더 복잡한 구성에서는 단일 유형의 데몬에 여러 데몬셋을 사용할 수 있지만, 
 각기 다른 하드웨어 유형에 따라 서로 다른 플래그, 메모리, CPU 요구가 달라진다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 데몬셋 사양 작성

@@ -226,4 +226,4 @@ Kubelet이 감시하는 특정 디렉토리에 파일을 작성하는 파드를
 디플로이먼트를 사용한다. 파드 사본이 항상 모든 호스트 또는 특정 호스트에서 실행되는 것이 중요하고, 
 다른 파드의 실행 이전에 필요한 경우에는 데몬셋을 사용한다.

-{{% /capture %}}
+
@@ -5,11 +5,11 @@ feature:
  description: >
    쿠버네티스는 애플리케이션 또는 애플리케이션의 설정 변경시 점진적으로 롤아웃하는 동시에 애플리케이션을 모니터링해서 모든 인스턴스가 동시에 종료되지 않도록 보장한다. 만약 어떤 문제가 발생하면 쿠버네티스는 변경 사항을 롤백한다. 성장하는 디플로이먼트 솔루션 생태계를 이용한다.

-content_template: templates/concept
+content_type: concept
 weight: 30
 ---

-{{% capture overview %}}
+<!-- overview -->

 _디플로이먼트_ 는 [파드](/ko/docs/concepts/workloads/pods/pod/)와 
 [레플리카셋](/ko/docs/concepts/workloads/controllers/replicaset/)에 대한 선언적 업데이트를 제공한다.
@@ -20,10 +20,10 @@ _디플로이먼트_ 는 [파드](/ko/docs/concepts/workloads/pods/pod/)와
 디플로이먼트가 소유하는 레플리카셋은 관리하지 말아야 한다. 사용자의 유스케이스가 다음에 포함되지 않는 경우 쿠버네티스 리포지터리에 이슈를 올릴 수 있다.
 {{< /note >}}

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 유스케이스

@@ -1165,4 +1165,4 @@ API 버전 `apps/v1` 에서는 `.spec.selector` 와 `.metadata.labels` 이 설
 일시 중지된 디플로이먼트는 PodTemplateSpec에 대한 변경 사항이 일시중지 된 경우 새 롤아웃을 트리거 하지 않는다.
 디플로이먼트는 생성시 기본적으로 일시 중지되지 않는다.

-{{% /capture %}}
+
@@ -1,18 +1,18 @@
 ---
 title: 가비지(Garbage) 수집
-content_template: templates/concept
+content_type: concept
 weight: 60
 ---

-{{% capture overview %}}
+<!-- overview -->

 쿠버네티스의 가비지 수집기는 한때 소유자가 있었지만, 더 이상
 소유자가 없는 오브젝트들을 삭제하는 역할을 한다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 소유자(owner)와 종속(dependent)

@@ -168,15 +168,16 @@ kubectl delete replicaset my-repset --cascade=false

 [#26120](https://github.com/kubernetes/kubernetes/issues/26120)을 추적한다.

-{{% /capture %}}


-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 [디자인 문서 1](https://git.k8s.io/community/contributors/design-proposals/api-machinery/garbage-collection.md)

 [디자인 문서 2](https://git.k8s.io/community/contributors/design-proposals/api-machinery/synchronous-garbage-collection.md)

-{{% /capture %}}
+


@@ -1,6 +1,6 @@
 ---
 title: 잡 - 실행부터 완료까지
-content_template: templates/concept
+content_type: concept
 feature:
  title: 배치 실행
  description: >
@@ -8,7 +8,7 @@ feature:
 weight: 70
 ---

-{{% capture overview %}}
+<!-- overview -->

 잡에서 하나 이상의 파드를 생성하고 지정된 수의 파드가 성공적으로 종료되도록 한다.
 파드가 성공적으로 완료되면, 성공적으로 완료된 잡을 추적한다.  지정된 수의
@@ -21,10 +21,10 @@ weight: 70

 잡을 사용하면 여러 파드를 병렬로 실행할 수도 있다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 예시 잡 실행하기

@@ -475,4 +475,4 @@ spec:

 [`크론잡`](/ko/docs/concepts/workloads/controllers/cron-jobs/)을 사용해서 Unix 도구인 `cron`과 유사하게 지정된 시간/일자에 실행되는 잡을 생성할 수 있다.

-{{% /capture %}}
+
@@ -1,18 +1,18 @@
 ---
 title: 레플리카셋
-content_template: templates/concept
+content_type: concept
 weight: 10
 ---

-{{% capture overview %}}
+<!-- overview -->

 레플리카셋의 목적은 레플리카 파드 집합의 실행을 항상 안정적으로 유지하는 것이다.
 이처럼 레플리카셋은 보통 명시된 동일 파드 개수에 대한 가용성을 보증하는데 사용한다.


-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 레플리카셋의 작동 방식

@@ -362,4 +362,4 @@ kubectl autoscale rs frontend --max=10 --min=3 --cpu-percent=50
 설명된 설정-기반의 셀렉터의 요건을 지원하지 않는다는 점을 제외하면 유사하다.
 따라서 레플리카셋이 레플리케이션 컨트롤러보다 선호된다.

-{{% /capture %}}
+
@@ -6,11 +6,11 @@ feature:
  description: >
    오류가 발생한 컨테이너를 재시작하고, 노드가 죽었을 때 컨테이너를 교체하기 위해 다시 스케줄하고, 사용자 정의 상태 체크에 응답하지 않는 컨테이너를 제거하며, 서비스를 제공할 준비가 될 때까지 클라이언트에 해당 컨테이너를 알리지 않는다.

-content_template: templates/concept
+content_type: concept
 weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< note >}}
 [`ReplicaSet`](/ko/docs/concepts/workloads/controllers/replicaset/) 을 구성하는 [`Deployment`](/ko/docs/concepts/workloads/controllers/deployment/) 가 현재 권장되는 레플리케이션 설정 방법이다.
@@ -20,10 +20,10 @@ _레플리케이션 컨트롤러_ 는 언제든지 지정된 수의 파드 레
 실행 중임을 보장한다.
 다시 말하면, 레플리케이션 컨트롤러는 파드 또는 동일 종류의 파드의 셋이 항상 기동되고 사용 가능한지 확인한다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 레플리케이션 컨트롤러의 동작방식

@@ -282,4 +282,4 @@ API 오브젝트에 대한 더 자세한 것은

 [스테이트리스 애플리케이션 레플리케이션 컨트롤러 실행하기](/docs/tutorials/stateless-application/run-stateless-ap-replication-controller/) 를 참조하라.

-{{% /capture %}}
+
@@ -1,17 +1,17 @@
 ---
 title: 스테이트풀셋
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---

-{{% capture overview %}}
+<!-- overview -->

 스테이트풀셋은 애플리케이션의 스테이트풀을 관리하는데 사용하는 워크로드 API 오브젝트이다.

 {{< glossary_definition term_id="statefulset" length="all" >}}
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 스테이트풀셋 사용

@@ -262,12 +262,13 @@ web-0이 실패할 경우 web-1은 web-0이 Running 및 Ready 상태가
 실행하려고 시도한 모든 파드를 삭제해야 한다.
 그러면 스테이트풀셋은 되돌린 템플릿을 사용해서 파드를 다시 생성하기 시작 한다.

-{{% /capture %}}
-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * [스테이트풀 애플리케이션의 배포](/ko/docs/tutorials/stateful-application/basic-stateful-set/)의 예시를 따른다.
 * [카산드라와 스테이트풀셋 배포](/ko/docs/tutorials/stateful-application/cassandra/)의 예시를 따른다.
 * [레플리케이티드(replicated) 스테이트풀 애플리케이션 실행하기](/docs/tasks/run-application/run-replicated-stateful-application/)의 예시를 따른다.

-{{% /capture %}}
+

@@ -1,10 +1,10 @@
 ---
 title: 완료된 리소스를 위한 TTL 컨트롤러
-content_template: templates/concept
+content_type: concept
 weight: 65
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< feature-state for_k8s_version="v1.12" state="alpha" >}}

@@ -18,12 +18,12 @@ TTL 컨트롤러는 실행이 완료된 리소스 오브젝트의 수명을
 [기능 게이트](/docs/reference/command-line-tools-reference/feature-gates/) 로 `TTLAfterFinished` 를 활성화 할 수 있다.


-{{% /capture %}}




-{{% capture body %}}
+
+<!-- body -->

 ## TTL 컨트롤러

@@ -75,12 +75,13 @@ TTL 컨트롤러는 쿠버네티스 리소스에
 에서 NTP를 실행해야 한다. 시계가 항상 정확한 것은 아니지만, 그 차이는 
 아주 작아야 한다. 0이 아닌 TTL을 설정할때는 이 위험에 대해 유의해야 한다.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 [자동으로 잡 정리](/ko/docs/concepts/workloads/controllers/jobs-run-to-completion/#완료된-잡을-자동으로-정리)

 [디자인 문서](https://github.com/kubernetes/enhancements/blob/master/keps/sig-apps/0026-ttl-after-finish.md)

-{{% /capture %}}
+
@@ -1,10 +1,10 @@
 ---
 title: 중단(disruption)
-content_template: templates/concept
+content_type: concept
 weight: 60
 ---

-{{% capture overview %}}
+<!-- overview -->
 이 가이드는 고가용성 애플리케이션을 구성하려는 소유자와
 파드에서 발생하는 장애 유형을 이해하기
 원하는 애플리케이션 소유자를 위한 것이다.
@@ -12,10 +12,10 @@ weight: 60
 또한 클러스터의 업그레이드와 오토스케일링과 같은 
 클러스터의 자동화 작업을 하려는 관리자를 위한 것이다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 자발적 중단과 비자발적 중단

@@ -242,13 +242,14 @@ Pod Disruption Budgets를 사용할 필요가 없다.
     자발적 중단를 허용하는 작업의 대부분은 오토스케일링과
     비자발적 중단를 지원하는 작업과 겹친다.

-{{% /capture %}}


-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * [Pod Disruption Budget 설정하기](/docs/tasks/run-application/configure-pdb/)의 단계를 따라서 애플리케이션을 보호한다.

 * [노드 비우기](/docs/tasks/administer-cluster/safely-drain-node/)에 대해 자세히 알아보기

-{{% /capture %}}
+
@@ -1,10 +1,10 @@
 ---
 title: 임시(Ephemeral) 컨테이너
-content_template: templates/concept
+content_type: concept
 weight: 80
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< feature-state state="alpha" for_k8s_version="v1.16" >}}

@@ -19,9 +19,9 @@ weight: 80
 이 알파 기능은 향후 크게 변경되거나, 완전히 제거될 수 있다.
 {{< /warning >}}

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 임시 컨테이너 이해하기

@@ -188,4 +188,4 @@ Ephemeral Containers:
 kubectl attach -it example-pod -c debugger
 ```

-{{% /capture %}}
+
@@ -1,19 +1,19 @@
 ---
 title: 초기화 컨테이너
-content_template: templates/concept
+content_type: concept
 weight: 40
 ---

-{{% capture overview %}}
+<!-- overview -->
 이 페이지는 초기화 컨테이너에 대한 개요를 제공한다. 초기화 컨테이너는
 {{< glossary_tooltip text="파드" term_id="pod" >}}의 앱 컨테이너들이 실행되기 전에 실행되는 특수한 컨테이너이며, 앱 이미지에는 없는
 유틸리티 또는 설정 스크립트 등을 포함할 수 있다.

 초기화 컨테이너는 `containers` 배열(앱 컨테이너를 기술하는)과 나란히
 파드 스펙에 명시할 수 있다.
-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 초기화 컨테이너 이해하기

@@ -314,12 +314,13 @@ myapp-pod   1/1       Running   0          9m
  동안 종료되었다. 그리고 초기화 컨테이너의 완료 기록이 가비지 수집
  때문에 유실되었다.

-{{% /capture %}}


-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * [초기화 컨테이너를 가진 파드 생성하기](/docs/tasks/configure-pod-container/configure-pod-initialization/#creating-a-pod-that-has-an-init-container)
 * [초기화 컨테이너 디버깅](/docs/tasks/debug-application-cluster/debug-init-containers/) 알아보기

-{{% /capture %}}
+
@@ -1,20 +1,20 @@
 ---
 title: 파드 라이프사이클
-content_template: templates/concept
+content_type: concept
 weight: 30
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< comment >}}Updated: 4/14/2015{{< /comment >}}
 {{< comment >}}Edited and moved to Concepts section: 2/2/17{{< /comment >}}

 이 페이지는 파드의 라이프사이클을 설명한다.

-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 파드의 단계(phase)

@@ -388,10 +388,11 @@ spec:
     * 노드 컨트롤러가 파드의 `phase`를 Failed로 설정한다.
     * 만약 컨트롤러로 실행되었다면, 파드는 어딘가에서 재생성된다.

-{{% /capture %}}


-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 * Hands-on 경험하기
  [컨테이너 라이프사이클 이벤트에 핸들러 부착하기](/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/).
@@ -401,6 +402,6 @@ spec:

 * [컨테이너 라이프사이클 후크(hook)](/ko/docs/concepts/containers/container-lifecycle-hooks/)에 대해 더 배우기.

-{{% /capture %}}
+


@@ -1,18 +1,18 @@
 ---
 title: 파드(Pod) 개요
-content_template: templates/concept
+content_type: concept
 weight: 10
 card:
  name: concepts
  weight: 60
 ---

-{{% capture overview %}}
+<!-- overview -->
 이 페이지는 쿠버네티스 객체 모델 중 가장 작은 배포 가능한 객체인 `파드` 에 대한 개요를 제공한다.
-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->
 ## 파드에 대해 이해하기

 *파드* 는 쿠버네티스 애플리케이션의 기본 실행 단위이다. 쿠버네티스 객체 모델 중 만들고 배포할 수 있는 가장 작고 간단한 단위이다. 파드는 {{< glossary_tooltip term_id="cluster" text="클러스터" >}} 에서의 Running 프로세스를 나타낸다.
@@ -104,12 +104,13 @@ metadata:

 노드에서 "kubelet"이 파드 템플릿과 업데이트에 관련된 세부 정보를 직접 관찰하거나 관리하지 않으며, 이러한 세부 정보는 추상화되지 않는다. 이러한 추상화와 분리는 시스템 시맨틱을 단순화하며, 기존 코드를 변경하지 않고 클러스터의 동작을 확장할 수 있도록 한다.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+
 * [파드](/ko/docs/concepts/workloads/pods/pod/)에 대해 더 배워보자.
 * [분산 시스템 툴킷: 복합 컨테이너의 패턴](https://kubernetes.io/blog/2015/06/the-distributed-system-toolkit-patterns)은 둘 이상의 컨테이너가 있는 파드의 공통 레이아웃에 대해 설명한다.
 * 파드의 동작에 대해 더 알아보자.
  * [파드 종료](/ko/docs/concepts/workloads/pods/pod/#파드의-종료)
  * [파드 라이프사이클](/ko/docs/concepts/workloads/pods/pod-lifecycle/)
-{{% /capture %}}
+
@@ -1,18 +1,18 @@
 ---
 title: 파드 토폴로지 분배 제약 조건
-content_template: templates/concept
+content_type: concept
 weight: 50
 ---

-{{% capture overview %}}
+<!-- overview -->

 {{< feature-state for_k8s_version="v1.18" state="beta" >}}

 사용자는 _토폴로지 분배 제약 조건_ 을 사용해서 지역, 영역, 노드 그리고 기타 사용자-정의 토폴로지 도메인과 같이 장애-도메인으로 설정된 클러스터에 걸쳐 파드가 분산되는 방식을 제어할 수 있다. 이를 통해 고가용성뿐만 아니라, 효율적인 리소스 활용의 목적을 이루는 데 도움이 된다.

-{{% /capture %}}

-{{% capture body %}}
+
+<!-- body -->

 ## 필수 구성 요소

@@ -245,4 +245,4 @@ profiles:
 - 디플로이먼트를 스케일링 다운하면 그 결과로 파드의 분포가 불균형이 될 수 있다.
 - 파드와 일치하는 테인트(taint)가 된 노드가 존중된다. [이슈 80921](https://github.com/kubernetes/kubernetes/issues/80921)을 본다.

-{{% /capture %}}
+
@@ -1,15 +1,15 @@
 ---
 title: 파드
-content_template: templates/concept
+content_type: concept
 weight: 20
 ---

-{{% capture overview %}}
+<!-- overview -->
 _파드_ 는 쿠버네티스에서 생성되고 관리될 수 있는 배포 가능한 최소 컴퓨팅 단위이다.
-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->

 ## 파드는 무엇인가?
 _파드_ 는 (고래 떼(pod of whales)나 콩꼬투리(pea pod)와 마찬가지로) 하나 이상의(도커 컨테이너 같은) 컨테이너 그룹이다.
@@ -203,4 +203,4 @@ spec.containers[0].securityContext.privileged: forbidden '<*>(0xc20b222db0)true'
 파드 오브젝트에 대한 매니페스트를 생성할때는 지정된 이름이 유효한
 [DNS 서브도메인 이름](/ko/docs/concepts/overview/working-with-objects/names/#dns-서브도메인-이름들)인지 확인해야 한다.

-{{% /capture %}}
+
@@ -1,19 +1,19 @@
 ---
 title: 파드 프리셋
-content_template: templates/concept
+content_type: concept
 weight: 50
 ---

-{{% capture overview %}}
+<!-- overview -->
 {{< feature-state for_k8s_version="v1.6" state="alpha" >}}

 이 페이지는 파드프리셋(PodPreset)에 대한 개요를 제공한다. 파드프리셋은 파드 생성 시간에 파드에
 특정 정보를 주입하기 위한 오브젝트이다. 해당 정보에는
 시크릿, 볼륨, 볼륨 마운트, 환경 변수가 포함될 수 있다.
-{{% /capture %}}


-{{% capture body %}}
+
+<!-- body -->
 ## 파드 프리셋 이해하기

 파드프리셋은 파드 생성 시간에 파드에 추가적인 런타임 요구사항을
@@ -79,12 +79,13 @@ weight: 50
 있을 것이다. 이 경우에는, 다음과 같은 양식으로 어노테이션을 파드 스펙에
 추가한다. `podpreset.admission.kubernetes.io/exclude: "true"`.

-{{% /capture %}}

-{{% capture whatsnext %}}
+
+## {{% heading "whatsnext" %}}
+

 [파드프리셋을 사용하여 파드에 데이터 주입하기](/docs/tasks/inject-data-application/podpreset/)를 본다.

 배경에 대한 자세한 정보를 위해서는, [파드프리셋을 위한 디자인 제안](https://git.k8s.io/community/contributors/design-proposals/service-catalog/pod-preset.md)을 본다.

-{{% /capture %}}
+