본문으로 건너뛰기
버전: 1.0

3. Install Prerequisite

이 페이지에서는 쿠버네티스를 설치하기에 앞서, 클러스터와 클라이언트에 설치 혹은 설정해두어야 하는 컴포넌트들에 대한 매뉴얼을 설명합니다.

Install apt packages​

추후 클라이언트와 클러스터의 원활한 통신을 위해서는 Port-Forwarding을 수행해야 할 일이 있습니다. Port-Forwarding을 위해서는 클러스터에 다음 패키지를 설치해 주어야 합니다.

sudo apt-get update
sudo apt-get install -y socat

Install Docker​

  1. 도커 설치에 필요한 APT 패키지들을 설치합니다.

    sudo apt-get update && sudo apt-get install -y ca-certificates curl gnupg lsb-release

  2. 도커의 공식 GPG key를 추가합니다.

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

  3. apt 패키지 매니저로 도커를 설치할 때, stable Repository에서 받아오도록 설정합니다.

    echo \
    "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

  4. 현재 설치할 수 있는 도커 버전을 확인합니다.

    sudo apt-get update && apt-cache madison docker-ce

    출력되는 버전 중 5:20.10.11~3-0~ubuntu-focal 버전이 있는지 확인합니다.

    apt-cache madison docker-ce | grep 5:20.10.11~3-0~ubuntu-focal

    정상적으로 추가가 된 경우 다음과 같이 출력됩니다.

    docker-ce | 5:20.10.11~3-0~ubuntu-focal | https://download.docker.com/linux/ubuntu focal/stable amd64 Packages

  5. 5:20.10.11~3-0~ubuntu-focal 버전의 도커를 설치합니다.

    sudo apt-get install -y containerd.io docker-ce=5:20.10.11~3-0~ubuntu-focal docker-ce-cli=5:20.10.11~3-0~ubuntu-focal

  6. 도커가 정상적으로 설치된 것을 확인합니다.

    sudo docker run hello-world

    명령어 실행 후 다음과 같은 메시지가 보이면 정상적으로 설치된 것을 의미합니다.

    mlops@ubuntu:~$ sudo docker run hello-world

    Hello from Docker!
    This message shows that your installation appears to be working correctly.

    To generate this message, Docker took the following steps:
    1. The Docker client contacted the Docker daemon.
    2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
       (amd64)
    3. The Docker daemon created a new container from that image which runs the
       executable that produces the output you are currently reading.
    4. The Docker daemon streamed that output to the Docker client, which sent it
       to your terminal.

    To try something more ambitious, you can run an Ubuntu container with:
    $ docker run -it ubuntu bash

    Share images, automate workflows, and more with a free Docker ID:
    https://hub.docker.com/

    For more examples and ideas, visit:
    https://docs.docker.com/get-started/

  7. docker 관련 command를 sudo 키워드 없이 사용할 수 있게 하도록 다음 명령어를 통해 권한을 추가합니다.

    sudo groupadd docker
    sudo usermod -aG docker $USER
    newgrp docker

  8. sudo 키워드 없이 docker command를 사용할 수 있게 된 것을 확인하기 위해, 다시 한번 docker run을 실행합니다.

    docker run hello-world

    명령어 실행 후 다음과 같은 메시지가 보이면 정상적으로 권한이 추가된 것을 의미합니다.

    mlops@ubuntu:~$ docker run hello-world

    Hello from Docker!
    This message shows that your installation appears to be working correctly.

    To generate this message, Docker took the following steps:
    1. The Docker client contacted the Docker daemon.
    2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
       (amd64)
    3. The Docker daemon created a new container from that image which runs the
       executable that produces the output you are currently reading.
    4. The Docker daemon streamed that output to the Docker client, which sent it
       to your terminal.

    To try something more ambitious, you can run an Ubuntu container with:
    $ docker run -it ubuntu bash

    Share images, automate workflows, and more with a free Docker ID:
    https://hub.docker.com/

    For more examples and ideas, visit:
    https://docs.docker.com/get-started/

Turn off Swap Memory​

kubelet 이 정상적으로 동작하게 하기 위해서는 클러스터 노드에서 swap이라고 불리는 가상메모리를 꺼 두어야 합니다. 다음 명령어를 통해 swap을 꺼 둡니다.
(클러스터와 클라이언트를 같은 데스크톱에서 사용할 때 swap 메모리를 종료하면 속도의 저하가 있을 수 있습니다) 

sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab
sudo swapoff -a

Install Kubectl​

kubectl 은 쿠버네티스 클러스터에 API를 요청할 때 사용하는 클라이언트 툴입니다. 클라이언트 노드에 설치해두어야 합니다.

  1. 현재 폴더에 kubectl v1.21.7 버전을 다운받습니다.

    curl -LO https://dl.k8s.io/release/v1.21.7/bin/linux/amd64/kubectl

    # Or if you use arm64
    curl -LO https://dl.k8s.io/release/v1.21.7/bin/linux/arm64/kubectl

  1. kubectl 을 사용할 수 있도록 파일의 권한과 위치를 변경합니다.

    sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl

  2. 정상적으로 설치되었는지 확인합니다.

    kubectl version --client

    다음과 같은 메시지가 보이면 정상적으로 설치된 것을 의미합니다.

    Client Version: version.Info{Major:"1", Minor:"21", GitVersion:"v1.21.7", GitCommit:"1f86634ff08f37e54e8bfcd86bc90b61c98f84d4", GitTreeState:"clean", BuildDate:"2021-11-17T14:41:19Z", GoVersion:"go1.16.10", Compiler:"gc", Platform:"linux/amd64"}

  3. 여러 개의 쿠버네티스 클러스터를 사용하는 경우, 여러 개의 kubeconfig 파일을 관리해야 하는 경우가 있습니다.
    여러 개의 kubeconfig 파일 혹은 여러 개의 kube-context를 효율적으로 관리하는 방법은 다음과 같은 문서를 참고하시기 바랍니다.

References​