[ko] Update outdated files in dev-1.24-ko.1 M89-M98

2022-05-31 11:31:44 +09:00
parent 507491e619
commit 5790f7ab03
8 changed files with 190 additions and 351 deletions
@@ -8,21 +8,21 @@ weight: 20
 ---
 <!-- overview -->

+{{% dockershim-removal %}}
+
 파드가 노드에서 실행될 수 있도록 클러스터의 각 노드에
 {{< glossary_tooltip text="컨테이너 런타임" term_id="container-runtime" >}}을
 설치해야 한다. 이 페이지에서는 관련된 항목을 설명하고
 노드 설정 관련 작업을 설명한다.

-<!-- body -->
-
 쿠버네티스 {{< skew currentVersion >}}에서는 
 {{< glossary_tooltip term_id="cri" text="컨테이너 런타임 인터페이스">}}(CRI) 요구사항을 만족하는 
 런타임을 사용해야 한다.

 더 자세한 정보는 [CRI 버전 지원](#cri-versions)을 참조한다.

-이 페이지에는 리눅스 환경의 쿠버네티스에서 여러 공통 컨테이너 런타임을 사용하는 방법에 대한
-세부 정보가 있다.
+이 페이지는 쿠버네티스에서 
+여러 공통 컨테이너 런타임을 사용하는 방법에 대한 개요를 제공한다.

 - [containerd](#containerd)
 - [CRI-O](#cri-o)
@@ -30,12 +30,27 @@ weight: 20
 - [미란티스 컨테이너 런타임](#mcr)

 {{< note >}}
-다른 운영 체제의 경우, 해당 플랫폼과 관련된 문서를 찾아보자.
+쿠버네티스 v1.24 이전 릴리스는 
+_dockershim_ 이라는 구성 요소를 사용하여 도커 엔진과의 직접 통합을 지원했다. 
+이 특별한 직접 통합은 
+더 이상 쿠버네티스에 포함되지 않는다(이 제거는 
+v1.20 릴리스의 일부로 [공지](/blog/2020/12/08/kubernetes-1-20-release-announcement/#dockershim-deprecation)되었다). 
+이 제거가 어떻게 영향을 미치는지 알아보려면 
+[Dockershim 사용 중단이 영향을 미치는지 확인하기](/docs/tasks/administer-cluster/migrating-from-dockershim/check-if-dockershim-deprecation-affects-you/) 문서를 확인한다. 
+dockershim을 사용하던 환경에서 이전(migrating)하는 방법을 보려면, 
+[dockershim에서 이전하기](/docs/tasks/administer-cluster/migrating-from-dockershim/)를 확인한다.
+
+v{{< skew currentVersion >}} 이외의 쿠버네티스 버전을 사용하고 있다면, 
+해당 버전의 문서를 참고한다.
 {{< /note >}}

+
+<!-- body -->
+
 ## cgroup 드라이버

-Control group은 프로세스에 할당된 리소스를 제한하는데 사용된다.
+리눅스에서, {{< glossary_tooltip text="control group" term_id="cgroup" >}}은 
+프로세스에 할당된 리소스를 제한하는데 사용된다.

 리눅스 배포판의 init 시스템이 [systemd](https://www.freedesktop.org/wiki/Software/systemd/)인
 경우, init 프로세스는 root control group(`cgroup`)을
@@ -64,7 +79,7 @@ kubelet을 재시작하는 것은 에러를 해결할 수 없을 것이다.
 교체하거나, 자동화를 사용하여 다시 설치한다.
 {{< /caution >}}

-## cgroup v2
+### Cgroup 버전 2 {#cgroup-v2}

 cgroup v2는 cgroup Linux API의 다음 버전이다. 
 cgroup v1과는 다르게 각 컨트롤러마다 다른 계층 대신 단일 계층이 있다.
@@ -102,8 +117,8 @@ cgroup v2를 사용하려면 CRI 런타임에서도 cgroup v2를 지원해야

 ### kubeadm으로 생성한 클러스터의 드라이버를 `systemd`로 변경하기

-kubeadm으로 생성한 클러스터의 cgroup 드라이버를 `systemd`로 변경하려면
-[변경 가이드](/docs/tasks/administer-cluster/kubeadm/configure-cgroup-driver/)를 참고한다.
+기존에 kubeadm으로 생성한 클러스터의 cgroup 드라이버를 `systemd`로 변경하려면, 
+[cgroup 드라이버 설정하기](/docs/tasks/administer-cluster/kubeadm/configure-cgroup-driver/)를 참고한다.

 ## CRI 버전 지원 {#cri-versions}

@@ -120,95 +135,47 @@ kubelet은 대신 (사용 중단된) v1alpha2 API를 사용하도록 설정된

 ### containerd

-이 섹션에는 containerd를 CRI 런타임으로 사용하는 데 필요한 단계가 포함되어 있다.
+이 섹션에는 containerd를 CRI 런타임으로 사용하는 데 필요한 단계를 간략하게 설명한다.

 다음 명령을 사용하여 시스템에 containerd를 설치한다.

-필수 구성 요소를 설치 및 구성한다.
+1. 필수 구성 요소를 설치 및 구성한다.

-```shell
-cat <<EOF | sudo tee /etc/modules-load.d/containerd.conf
-overlay
-br_netfilter
-EOF
-
-sudo modprobe overlay
-sudo modprobe br_netfilter
-
-# 필요한 sysctl 파라미터를 설정하면 재부팅 후에도 유지된다.
-cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
-net.bridge.bridge-nf-call-iptables  = 1
-net.ipv4.ip_forward                 = 1
-net.bridge.bridge-nf-call-ip6tables = 1
-EOF
-
-# 재부팅하지 않고 sysctl 파라미터 적용
-sudo sysctl --system
-```
-
-containerd를 설치한다.
-
-{{< tabs name="tab-cri-containerd-installation" >}}
-{{% tab name="Linux" %}}
-
-1. 공식 도커 리포지터리에서 `containerd.io` 패키지를 설치한다.
-각 리눅스 배포판에 대한 도커 리포지터리를 설정하고
-`containerd.io` 패키지를 설치하는 방법은
-[도커 엔진 설치](https://docs.docker.com/engine/install/#server)에서 찾을 수 있다.
-
-2. containerd 설정
+   (이 지침은 리눅스 노드에만 적용된다)

   ```shell
-   sudo mkdir -p /etc/containerd
-   containerd config default | sudo tee /etc/containerd/config.toml
+   cat <<EOF | sudo tee /etc/modules-load.d/containerd.conf
+   overlay
+   br_netfilter
+   EOF
+
+   sudo modprobe overlay
+   sudo modprobe br_netfilter
+
+   # 필요한 sysctl 파라미터를 설정하면 재부팅 후에도 유지된다.
+   cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
+   net.bridge.bridge-nf-call-iptables  = 1
+   net.ipv4.ip_forward                 = 1
+   net.bridge.bridge-nf-call-ip6tables = 1
+   EOF
+
+   # 재부팅하지 않고 sysctl 파라미터 적용
+   sudo sysctl --system
   ```

-3. containerd 재시작
+1. containerd를 설치한다.

-   ```shell
-   sudo systemctl restart containerd
-   ```
+   [containerd 시작하기](https://github.com/containerd/containerd/blob/main/docs/getting-started.md) 
+   문서를 확인하고, 
+   유효한 환경 설정 파일(`config.toml`)을 작성하는 부분까지의 
+   가이드를 따른다. 
+   리눅스에서, 이 파일은 `/etc/containerd/config.toml`에 존재한다. 
+   윈도우에서, 이 파일은 `C:\Program Files\containerd\config.toml`에 존재한다.

-{{% /tab %}}
-{{% tab name="Windows (PowerShell)" %}}
+리눅스에서, containerd를 위한 기본 CRI 소켓은 `/run/containerd/containerd.sock`이다.
+윈도우에서, 기본 CRI 엔드포인트는 `npipe://./pipe/containerd-containerd`이다.

-PowerShell 세션을 시작하고 `$Version`을 원하는 버전으로
-설정(예: `$Version:"1.4.3"`)한 후 다음 명령을 실행한다.
-
-1. containerd 다운로드
-
-   ```powershell
-   curl.exe -L https://github.com/containerd/containerd/releases/download/v$Version/containerd-$Version-windows-amd64.tar.gz -o containerd-windows-amd64.tar.gz
-   tar.exe xvf .\containerd-windows-amd64.tar.gz
-   ```
-
-2. 추출과 설정
-
-   ```powershell
-   Copy-Item -Path ".\bin\" -Destination "$Env:ProgramFiles\containerd" -Recurse -Force
-   cd $Env:ProgramFiles\containerd\
-   .\containerd.exe config default | Out-File config.toml -Encoding ascii
-
-   # 설정을 검토한다. 설정에 따라 다음을 조정할 수 있다.
-   # - sandbox_image (쿠버네티스 일시중지 이미지)
-   # - cni bin 폴더와 conf 폴더 위치
-   Get-Content config.toml
-
-   # (선택사항 - 그러나 적극 권장함) Windows 디펜더 검사에서 containerd 제외
-   Add-MpPreference -ExclusionProcess "$Env:ProgramFiles\containerd\containerd.exe"
-   ```
-
-3. containerd 실행
-
-   ```powershell
-   .\containerd.exe --register-service
-   Start-Service containerd
-   ```
-
-{{% /tab %}}
-{{< /tabs >}}
-
-#### `systemd` cgroup 드라이버의 사용 {#containerd-systemd}
+#### `systemd` cgroup 드라이버 환경 설정하기 {#containerd-systemd}

 `/etc/containerd/config.toml` 의 `systemd` cgroup 드라이버를 `runc` 에서 사용하려면, 다음과 같이 설정한다.

@@ -219,7 +186,7 @@ PowerShell 세션을 시작하고 `$Version`을 원하는 버전으로
    SystemdCgroup = true
 ```

-이 변경 사항을 적용하는 경우 containerd를 재시작한다.
+이 변경 사항을 적용하려면, containerd를 재시작한다.

 ```shell
 sudo systemctl restart containerd
@@ -232,176 +199,14 @@ kubeadm을 사용하는 경우,

 이 섹션은 CRI-O를 컨테이너 런타임으로 설치하는 필수적인 단계를 담고 있다.

-시스템에 CRI-O를 설치하기 위해서 다음의 커맨드를 사용한다.
-
-{{< note >}}
-CRI-O 메이저와 마이너 버전은 쿠버네티스 메이저와 마이너 버전이 일치해야 한다.
-더 자세한 정보는 [CRI-O 호환 매트릭스](https://github.com/cri-o/cri-o#compatibility-matrix-cri-o--kubernetes)를 본다.
-{{< /note >}}
-
-필수 구성 요소를 설치하고 구성한다.
-
-```shell
-# .conf 파일을 만들어 부팅 시 모듈을 로드한다
-cat <<EOF | sudo tee /etc/modules-load.d/crio.conf
-overlay
-br_netfilter
-EOF
-
-sudo modprobe overlay
-sudo modprobe br_netfilter
-
-# 요구되는 sysctl 파라미터 설정, 이 설정은 재부팅 간에도 유지된다.
-cat <<EOF | sudo tee /etc/sysctl.d/99-kubernetes-cri.conf
-net.bridge.bridge-nf-call-iptables  = 1
-net.ipv4.ip_forward                 = 1
-net.bridge.bridge-nf-call-ip6tables = 1
-EOF
-
-sudo sysctl --system
-```
-
-{{< tabs name="tab-cri-cri-o-installation" >}}
-{{% tab name="Debian" %}}
-
-다음의 운영 체제에서 CRI-O를 설치하려면, 환경 변수 `OS` 를
-아래의 표에서 적절한 필드로 설정한다.
-
-| 운영 체제          | `$OS`             |
-| ---------------- | ----------------- |
-| Debian Unstable  | `Debian_Unstable` |
-| Debian Testing   | `Debian_Testing`  |
-
-<br />
-그런 다음, `$VERSION` 을 사용자의 쿠버네티스 버전과 일치하는 CRI-O 버전으로 설정한다.
-예를 들어, CRI-O 1.20을 설치하려면, `VERSION=1.20` 로 설정한다.
-사용자의 설치를 특정 릴리스에 고정할 수 있다.
-버전 1.20.0을 설치하려면, `VERSION=1.20:1.20.0` 을 설정한다.
-<br />
-
-그런 다음, 아래를 실행한다.
-```shell
-cat <<EOF | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list
-deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/ /
-EOF
-cat <<EOF | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable:cri-o:$VERSION.list
-deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable:/cri-o:/$VERSION/$OS/ /
-EOF
-
-curl -L https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable:cri-o:$VERSION/$OS/Release.key | sudo apt-key --keyring /etc/apt/trusted.gpg.d/libcontainers.gpg add -
-curl -L https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/Release.key | sudo apt-key --keyring /etc/apt/trusted.gpg.d/libcontainers.gpg add -
-
-sudo apt-get update
-sudo apt-get install cri-o cri-o-runc
-```
-
-{{% /tab %}}
-
-{{% tab name="Ubuntu" %}}
-
-다음의 운영 체제에서 CRI-O를 설치하려면, 환경 변수 `OS` 를
-아래의 표에서 적절한 필드로 설정한다.
-
-| 운영 체제          | `$OS`             |
-| ---------------- | ----------------- |
-| Ubuntu 20.04     | `xUbuntu_20.04`   |
-| Ubuntu 19.10     | `xUbuntu_19.10`   |
-| Ubuntu 19.04     | `xUbuntu_19.04`   |
-| Ubuntu 18.04     | `xUbuntu_18.04`   |
-
-<br />
-그런 다음, `$VERSION` 을 사용자의 쿠버네티스 버전과 일치하는 CRI-O 버전으로 설정한다.
-예를 들어, CRI-O 1.20을 설치하려면, `VERSION=1.20` 로 설정한다.
-사용자의 설치를 특정 릴리스에 고정할 수 있다.
-버전 1.20.0을 설치하려면, `VERSION=1.20:1.20.0` 을 설정한다.
-<br />
-
-그런 다음, 아래를 실행한다.
-```shell
-cat <<EOF | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list
-deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/ /
-EOF
-cat <<EOF | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable:cri-o:$VERSION.list
-deb http://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable:/cri-o:/$VERSION/$OS/ /
-EOF
-
-curl -L https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/Release.key | sudo apt-key --keyring /etc/apt/trusted.gpg.d/libcontainers.gpg add -
-curl -L https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable:cri-o:$VERSION/$OS/Release.key | sudo apt-key --keyring /etc/apt/trusted.gpg.d/libcontainers-cri-o.gpg add -
-
-apt-get update
-apt-get install cri-o cri-o-runc
-```
-{{% /tab %}}
-
-{{% tab name="CentOS" %}}
-
-다음의 운영 체제에서 CRI-O를 설치하려면, 환경 변수 `OS` 를
-아래의 표에서 적절한 필드로 설정한다.
-
-| 운영 체제          | `$OS`             |
-| ---------------- | ----------------- |
-| Centos 8         | `CentOS_8`        |
-| Centos 8 Stream  | `CentOS_8_Stream` |
-| Centos 7         | `CentOS_7`        |
-
-<br />
-그런 다음, `$VERSION` 을 사용자의 쿠버네티스 버전과 일치하는 CRI-O 버전으로 설정한다.
-예를 들어, CRI-O 1.20을 설치하려면, `VERSION=1.20` 로 설정한다.
-사용자의 설치를 특정 릴리스에 고정할 수 있다.
-버전 1.20.0을 설치하려면, `VERSION=1.20:1.20.0` 을 설정한다.
-<br />
-
-그런 다음, 아래를 실행한다.
-```shell
-sudo curl -L -o /etc/yum.repos.d/devel:kubic:libcontainers:stable.repo https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/$OS/devel:kubic:libcontainers:stable.repo
-sudo curl -L -o /etc/yum.repos.d/devel:kubic:libcontainers:stable:cri-o:$VERSION.repo https://download.opensuse.org/repositories/devel:kubic:libcontainers:stable:cri-o:$VERSION/$OS/devel:kubic:libcontainers:stable:cri-o:$VERSION.repo
-sudo yum install cri-o
-```
-
-{{% /tab %}}
-
-{{% tab name="openSUSE Tumbleweed" %}}
-
-```shell
-sudo zypper install cri-o
-```
-{{% /tab %}}
-{{% tab name="Fedora" %}}
-
-`$VERSION` 을 사용자의 쿠버네티스 버전과 일치하는 CRI-O 버전으로 설정한다.
-예를 들어, CRI-O 1.20을 설치하려면, `VERSION=1.20` 로 설정한다.
-
-사용할 수 있는 버전을 찾으려면 다음을 실행한다.
-```shell
-sudo dnf module list cri-o
-```
-CRI-O는 Fedora에서 특정 릴리스를 고정하여 설치하는 방법은 지원하지 않는다.
-
-그런 다음, 아래를 실행한다.
-```shell
-sudo dnf module enable cri-o:$VERSION
-sudo dnf install cri-o
-```
-
-{{% /tab %}}
-{{< /tabs >}}
-
-CRI-O를 시작한다.
-
-```shell
-sudo systemctl daemon-reload
-sudo systemctl enable crio --now
-```
-
-자세한 사항은 [CRI-O 설치 가이드](https://github.com/cri-o/cri-o/blob/master/install.md)를
-참고한다.
-
+CRI-O를 설치하려면, [CRI-O 설치 방법](https://github.com/cri-o/cri-o/blob/main/install.md#readme)을 따른다.

 #### cgroup 드라이버

-CRI-O는 기본적으로 systemd cgroup 드라이버를 사용한다. `cgroupfs` cgroup 드라이버로
-전환하려면, `/etc/crio/crio.conf` 를 수정하거나 `/etc/crio/crio.conf.d/02-cgroup-manager.conf` 에
-드롭-인(drop-in) 구성을 배치한다. 예를 들면, 다음과 같다.
+CRI-O는 기본적으로 systemd cgroup 드라이버를 사용하며, 이는 대부분의 경우에 잘 동작할 것이다. 
+`cgroupfs` cgroup 드라이버로 전환하려면, `/etc/crio/crio.conf` 를 수정하거나 
+`/etc/crio/crio.conf.d/02-cgroup-manager.conf` 에 드롭-인(drop-in) 구성을 배치한다. 
+예를 들면 다음과 같다.

 ```toml
 [crio.runtime]
@@ -410,27 +215,27 @@ cgroup_manager = "cgroupfs"
 ```

 또한 `cgroupfs` 와 함께 CRI-O를 사용할 때 `pod` 값으로 설정해야 하는
-변경된 `conmon_cgroup` 에 유의한다. 일반적으로 kubelet(일반적으로 kubeadm을 통해 수행됨)과
+변경된 `conmon_cgroup` 에 유의해야 한다. 일반적으로 kubelet(일반적으로 kubeadm을 통해 수행됨)과
 CRI-O의 cgroup 드라이버 구성을 동기화 상태로
 유지해야 한다.

+CRI-O의 경우, CRI 소켓은 기본적으로 `/var/run/crio/crio.sock`이다.
+
 ### 도커 엔진 {#docker}

-도커 엔진은 모든 것을 시작한 컨테이너 런타임이다. 
-이전에는 간단히 도커로 알려졌던 이 컨테이너 런타임은 다양한 형태로 사용할 수 있다.
-[도커 엔진 설치하기](https://docs.docker.com/engine/install/)에서 
-이 런타임 설치의 옵션들을 확인할 수 있다.
+{{< note >}}
+아래의 지침은 
+당신이 도커 엔진과 쿠버네티스를 통합하는 데 
+[`cri-dockerd`](https://github.com/Mirantis/cri-dockerd) 어댑터를 사용하고 있다고 가정한다.
+{{< /note >}}

-도커 엔진은 쿠버네티스 {{< skew currentVersion >}}와 직접 호환되며, 이는 사용 중단된 `dockershim` 컴포넌트를 활용하기 때문에 가능하다. 
-더 많은 정보와 맥락을 보려면, [Dockershim 사용 중단 FAQ](/dockershim)를 참고한다.
+1. 각 노드에서, [도커 엔진 설치하기](https://docs.docker.com/engine/install/#server)에 따라 
+   리눅스 배포판에 맞게 도커를 설치한다.

-지원되는 {{< glossary_tooltip term_id="cri" text="컨테이너 런타임 인터페이스">}}(CRI)를 통해 
-쿠버네티스에서 도커 엔진을 사용할 수 있게 해 주는 
-써드파티 어댑터를 찾아볼 수도 있다.
+2. [`cri-dockerd`](https://github.com/Mirantis/cri-dockerd) 소스 코드 저장소의 지침대로 
+   `cri-dockerd`를 설치한다.

-다음 CRI 어댑터는 도커 엔진과 함께 동작하도록 설계되었다.
-
- 미란티스의 [`cri-dockerd`](https://github.com/Mirantis/cri-dockerd)
+`cri-dockerd`의 경우, CRI 소켓은 기본적으로 `/run/cri-dockerd.sock`이다.

 ### 미란티스 컨테이너 런타임 {#mcr}

@@ -439,3 +244,14 @@ CRI-O의 cgroup 드라이버 구성을 동기화 상태로

 오픈소스인 [`cri-dockerd`](https://github.com/Mirantis/cri-dockerd) 컴포넌트를 이용하여 쿠버네티스에서 미란티스 컨테이너 런타임을 사용할 수 있으며, 
 이 컴포넌트는 MCR에 포함되어 있다.
+
+미란티스 컨테이너 런타임을 설치하는 방법에 대해 더 알아보려면, 
+[MCR 배포 가이드](https://docs.mirantis.com/mcr/20.10/install.html)를 참고한다.
+
+CRI 소켓의 경로를 찾으려면 
+`cri-docker.socket`라는 이름의 systemd 유닛을 확인한다.
+
+## {{% heading "whatsnext" %}}
+
+컨테이너 런타임과 더불어, 클러스터에는 
+동작하는 [네트워크 플러그인](/ko/docs/concepts/cluster-administration/networking/#쿠버네티스-네트워크-모델의-구현-방법)도 필요하다.