Ko: Second Korean l10n work for release-1.20

- Update outdated files in the dev-1.20-ko.2(p1) (#25915) - Update outdated files in the dev-1.20-ko.2(p2) (#25916) - Fix issue with links to already translated ko documents (#25991) - Translate reference/glossary/dynamic-volume-provisioning.md in Korean (#26047) Co-authored-by: seokho-son <shsongist@gmail.com> Co-authored-by: Jerry Park <jaehwa@gmail.com> Co-authored-by: santachopa <santachopa@naver.com>
2021-01-02 23:07:59 +09:00
parent 85933681d0
commit bfd90bff5f
42 changed files with 437 additions and 252 deletions
@@ -30,7 +30,7 @@ card:

 {{< glossary_tooltip text="kubectl" term_id="kubectl" >}}이 설치되었는지 확인하려면,
 `kubectl version --client`을 실행한다. kubectl 버전은 클러스터의 API 서버 버전과
-[마이너 버전 하나 차이 이내](/docs/setup/release/version-skew-policy/#kubectl)여야
+[마이너 버전 하나 차이 이내](/ko/docs/setup/release/version-skew-policy/#kubectl)여야
 한다.


@@ -383,7 +383,3 @@ export KUBECONFIG=$KUBECONFIG_SAVED

 * [kubeconfig 파일을 사용하여 클러스터 접근 구성하기](/ko/docs/concepts/configuration/organize-cluster-access-kubeconfig/)
 * [kubectl config](/docs/reference/generated/kubectl/kubectl-commands#config)
-
-
-
-
@@ -125,6 +125,7 @@ min-kubernetes-server-version: v1.10

 1.  	`kubectl port-forward` 명령어는 파드 이름과 같이 리소스 이름을 사용하여 일치하는 파드를 선택해 포트 포워딩하는 것을 허용한다.

+
    ```shell
    # redis-master-765d459796-258hz 를 파드 이름으로 변경한다.
    kubectl port-forward redis-master-765d459796-258hz 7000:6379
@@ -157,10 +158,16 @@ min-kubernetes-server-version: v1.10
    위의 명령어들은 모두 동일하게 동작한다. 이와 유사하게 출력된다.

    ```
-    I0710 14:43:38.274550    3655 portforward.go:225] Forwarding from 127.0.0.1:7000 -> 6379
-    I0710 14:43:38.274797    3655 portforward.go:225] Forwarding from [::1]:7000 -> 6379
+    Forwarding from 127.0.0.1:7000 -> 6379
+    Forwarding from [::1]:7000 -> 6379
    ```

+{{< note >}}
+
+`kubectl port-forward` 는 프롬프트를 리턴하지 않으므로, 이 연습을 계속하려면 다른 터미널을 열어야 한다.
+
+{{< /note >}}
+
 2.  Redis 커맨드라인 인터페이스를 실행한다.

    ```shell
@@ -179,7 +186,23 @@ min-kubernetes-server-version: v1.10
    PONG
    ```

+### 선택적으로 _kubectl_ 이 로컬 포트를 선택하게 하기 {#let-kubectl-choose-local-port}

+만약 특정 로컬 포트가 필요하지 않다면, `kubectl` 이 로컬 포트를 선택 및 할당하게 하여,
+조금 더 단순한 문법으로 로컬 포트 충돌 관리를 위한
+부담을 줄일 수 있다.
+
+```shell
+kubectl port-forward deployment/redis-master :6379
+```
+
+`kubectl` 도구는 사용 중이 아닌 로컬 포트 번호를 찾는다. (낮은 포트 번호는
+다른 애플리케이션에서 사용될 것이므로, 낮은 포트 번호를 피해서) 출력은 다음과 같을 것이다.
+
+```
+Forwarding from 127.0.0.1:62162 -> 6379
+Forwarding from [::1]:62162 -> 6379
+```


 <!-- discussion -->
@@ -193,8 +216,7 @@ min-kubernetes-server-version: v1.10
 {{< note >}}
 `kubectl port-forward` 는 TCP 포트에서만 구현된다.
 UDP 프로토콜에 대한 지원은
-[이슈 47862](https://github.com/kubernetes/kubernetes/issues/47862)
-에서 추적되고 있다.
+[이슈 47862](https://github.com/kubernetes/kubernetes/issues/47862)에서 추적되고 있다.
 {{< /note >}}


@@ -148,7 +148,7 @@ http 클라이언트가 루트 인증서를 사용하도록 하려면 특별한

 일부 클러스터에서, API 서버는 인증이 필요하지 않다.
 로컬 호스트에서 제공되거나, 방화벽으로 보호될 수 있다. 이에 대한 표준은
-없다. [쿠버네티스 API에 대한 접근 제어](/docs/concepts/security/controlling-access)은
+없다. [쿠버네티스 API에 대한 접근 제어](/ko/docs/concepts/security/controlling-access)은
 클러스터 관리자로서 이를 구성하는 방법에 대해 설명한다. 이러한 접근 방식은 향후
 고 가용성 지원과 충돌할 수 있다.

@@ -1,4 +1,6 @@
 ---
+
+
 title: kubeadm 클러스터 업그레이드
 content_type: task
 weight: 20
@@ -229,6 +231,14 @@ sudo systemctl restart kubelet
 {{% /tab %}}
 {{< /tabs >}}

+### "kubeadm upgrade" 호출
+
+-  워커 노드의 경우 로컬 kubelet 구성을 업그레이드한다.
+
+    ```shell
+    sudo kubeadm upgrade node
+    ```
+
 ### 노드 드레인

 -  스케줄 불가능(unschedulable)으로 표시하고 워크로드를 축출하여 유지 보수할 노드를 준비한다.
@@ -238,14 +248,6 @@ sudo systemctl restart kubelet
    kubectl drain <node-to-drain> --ignore-daemonsets
    ```

-### kubeadm 업그레이드 호출
-
-  워커 노드의 경우 로컬 kubelet 구성을 업그레이드한다.
-
-    ```shell
-    sudo kubeadm upgrade node
-    ```
-
 ### kubelet과 kubectl 업그레이드

 -  kubelet 및 kubectl을 업그레이드한다.
@@ -1,4 +1,6 @@
 ---
+
+
 title: 파드와 레플리케이션컨트롤러(ReplicationController) 디버그하기
 content_type: task
 ---
@@ -48,7 +50,7 @@ kubectl describe pods ${POD_NAME}
 * 클러스터에 노드를 더 추가하기.

 * pending 상태인 파드를 위한 공간을 확보하기 위해
-  [불필요한 파드 종료하기](/ko/docs/concepts/workloads/pods/#pod-termination)
+  [불필요한 파드 종료하기](/ko/docs/concepts/workloads/pods/pod-lifecycle/#pod-termination)

 * 파드가 노드보다 크지 않은지 확인한다. 예를 들어 모든
  노드가 `cpu:1` 의 용량을 가지고 있을 경우, `cpu: 1.1` 을 요청하는 파드는
@@ -6,7 +6,7 @@ content_type: task

 <!-- overview -->

-이 가이드는 [kubectl](/docs/reference/kubectl/kubectl/) 확장을 설치하고 작성하는 방법을 보여준다. 핵심 `kubectl` 명령을 쿠버네티스 클러스터와 상호 작용하기 위한 필수 구성 요소로 생각함으로써, 클러스터 관리자는
+이 가이드는 [kubectl](/ko/docs/reference/kubectl/kubectl/) 확장을 설치하고 작성하는 방법을 보여준다. 핵심 `kubectl` 명령을 쿠버네티스 클러스터와 상호 작용하기 위한 필수 구성 요소로 생각함으로써, 클러스터 관리자는
 플러그인을 이러한 구성 요소를 활용하여 보다 복잡한 동작을 만드는 수단으로 생각할 수 있다. 플러그인은 새로운 하위 명령으로 `kubectl` 을 확장하고, 주요 배포판에 포함되지 않은 `kubectl` 의 새로운 사용자 정의 기능을 허용한다.


@@ -1,4 +1,6 @@
 ---
+
+
 title: HugePages 관리
 content_type: task
 description: 클러스터에서 huge page를 스케줄할 수 있는 리소스로 구성하고 관리한다.
@@ -102,17 +104,18 @@ spec:

 - Huge page 요청(requests)은 제한(limits)과 같아야 한다. 제한이 지정되었지만, 요청은 지정되지 않은 경우
  이것이 기본값이다.
- Huge page는 컨테이너 범위에서 격리되므로, 각 컨테이너에는 컨테이너 사양에서 요청한대로 cgroup 샌드박스에 대한 제한이 있다.
+- Huge page는 컨테이너 범위에서 격리되므로, 각 컨테이너에는 컨테이너 사양에서 요청한대로
+  cgroup 샌드박스에 대한 제한이 있다.
 - Huge page가 지원하는 EmptyDir 볼륨은 파드 요청보다 더 많은 huge page 메모리를
  사용하지 말아야 한다.
 - `shmget()` 의 `SHM_HUGETLB` 를 통해 huge page를 사용하는 애플리케이션은
  `proc/sys/vm/hugetlb_shm_group` 과 일치하는 보충 그룹(supplemental group)으로 실행해야 한다.
 - 네임스페이스에서의 huge page 사용은 `hugepages-<size>` 토큰을 사용하는 `cpu` 또는 `memory` 와 같은
-다른 컴퓨트 리소스와 비슷한 리소스쿼터(ResourceQuota)를 통해 제어할 수
-있다.
- 다양한 크기의 huge page 지원이 기능 게이트로 제공된다. {{<
-glossary_tooltip text="kubelet" term_id="kubelet" >}} 및 {{<
-glossary_tooltip text="kube-apiserver"
-term_id="kube-apiserver" >}} (`--feature-gates=HugePageStorageMediumSize=true`)의
-`HugePageStorageMediumSize` [기능
-게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를 사용하여 비활성화할 수 있다.
+  다른 컴퓨트 리소스와 비슷한 리소스쿼터(ResourceQuota)를 통해 제어할 수
+  있다.
+- 다양한 크기의 huge page 지원이 기능 게이트로 제공된다.
+  {{<glossary_tooltip text="kubelet" term_id="kubelet" >}} 및
+  {{<glossary_tooltip text="kube-apiserver" term_id="kube-apiserver" >}}
+  (`--feature-gates=HugePageStorageMediumSize=true`)의 `HugePageStorageMediumSize`
+  [기능 게이트](/ko/docs/reference/command-line-tools-reference/feature-gates/)를
+  사용하여 비활성화할 수 있다.
@@ -47,8 +47,7 @@ Kustomize는 쿠버네티스 구성을 사용자 정의화하는 도구이다.

 ### 리소스 생성

-컨피그 맵과 시크릿은 파드같은 다른 쿠버네티스 오브젝트에서 사용되는 설정이나 민감한 데이터를 가지고 있다.
-컨피그 맵이나 시크릿의 실질적인 소스는 일반적으로 `.properties` 파일이나 ssh key 파일과 같은 것들은 클러스터 외부에 있다.
+컨피그 맵과 시크릿은 파드와 같은 다른 쿠버네티스 오브젝트에서 사용되는 설정이나 민감한 데이터를 가지고 있다. 컨피그 맵이나 시크릿의 실질적인 소스는 일반적으로 `.properties` 파일이나 ssh key 파일과 같은 것들은 클러스터 외부에 있다.
 Kustomize는 시크릿과 컨피그 맵을 파일이나 문자열에서 생성하는 `secretGenerator`와 `configMapGenerator`를 가지고 있다.

 #### configMapGenerator
@@ -591,7 +590,7 @@ spec:
      containers:
      - name: my-nginx
        image: nginx
-        command: ["start", "--host", "\$(MY_SERVICE_NAME)"]
+        command: ["start", "--host", "$(MY_SERVICE_NAME)"]
 EOF

 # service.yaml 파일 생성
@@ -655,10 +654,10 @@ spec:

 ## Base와 Overlay

-Kustomize는 **base**와 **overlay**의 개념을 가지고 있다. **base**는 `kustomization.yaml`과 함께 사용되는 디렉터리다. 이는
+Kustomize는 **base** 와 **overlay** 의 개념을 가지고 있다. **base** 는 `kustomization.yaml` 과 함께 사용되는 디렉터리다. 이는
 사용자 정의와 관련된 리소스들의 집합을 포함한다. `kustomization.yaml`의 내부에 표시되는 base는 로컬 디렉터리이거나 원격 리포지터리의 디렉터리가
-될 수 있다. **overlay**는 `kustomization.yaml`이 있는 디렉터리로
-다른 kustomization 디렉터리들을 `bases`로 참조한다. **base**는 overlay에 대해서 알지 못하며 여러 overlay들에서 사용될 수 있다.
+될 수 있다. **overlay** 는 `kustomization.yaml`이 있는 디렉터리로
+다른 kustomization 디렉터리들을 `bases`로 참조한다. **base** 는 overlay에 대해서 알지 못하며 여러 overlay들에서 사용될 수 있다.
 한 overlay는 다수의 base들을 가질 수 있고, base들에서 모든 리소스를 구성할 수 있으며,
 이들의 위에 사용자 정의도 가질 수 있다.

@@ -9,7 +9,7 @@ card:
 ---

 <!-- overview -->
-쿠버네티스 커맨드 라인 도구인 [kubectl](/docs/reference/kubectl/kubectl/)을 사용하면,
+쿠버네티스 커맨드 라인 도구인 [kubectl](/ko/docs/reference/kubectl/kubectl/)을 사용하면,
 쿠버네티스 클러스터에 대해 명령을 실행할 수 있다.
 kubectl을 사용하여 애플리케이션을 배포하고, 클러스터 리소스를 검사 및 관리하며
 로그를 볼 수 있다. kubectl 작업의 전체 목록에 대해서는,
@@ -526,4 +526,4 @@ compinit
 * [애플리케이션을 시작하고 노출하는 방법에 대해 배운다.](/ko/docs/tasks/access-application-cluster/service-access-application-cluster/)
 * 직접 생성하지 않은 클러스터에 접근해야하는 경우,
  [클러스터 접근 공유 문서](/ko/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)를 참고한다.
-* [kubectl 레퍼런스 문서](/docs/reference/kubectl/kubectl/) 읽기
+* [kubectl 레퍼런스 문서](/ko/docs/reference/kubectl/kubectl/) 읽기