k8s101-install(2/6)

개요

쿠버네티스 설치 방법은 간단한 방법에서 복잡한 방법까지 여러 가지가 있습니다. 간단한 방법은 개인PC에 운영체제에 맞게 구성하여 학습하는 용도로 활용할 수 있고 복잡한 방법은 수고롭지만 직접 클러스터링 된 쿠버네티스를 구성하여 운영환경으로 활용할 수 있습니다. 아니면, 설치 없이 클라우드에서 제공하는 서비스로써 쿠버네티스를 이용하고 이용에 대한 대가를 지불하는 방식도 가능합니다. 지금부터 아래 제시된 영역에 맞추어 쿠버네티스 설치방법을 설명합니다. 제시된 설치 방법 중 쿠버네티스를 활용하고자 하는 목적에 맞는 부분을 취사선택하여 활용하면 되겠습니다.

항목	설명
간단한 쿠버네티스 설치 방법	개인 PC등, 단일노드에 테스트 용으로 설치하는 방법
서비스로 쿠버네티스 이용 방법	AWS, GCP, Azure 등 클라우드 사업자가 제공하는 서비스로서의 쿠버네티스 이용 방법
복잡한 쿠버네티스 설치 방법	여러 노드에 클러스터링된 쿠버네티스 구성 방법

간단한 쿠버네티스 설치 방법

쿠버네티스를 경험하기 위해서는 쿠버네티스가 구성된 환경에 필요합니다. 우리에게는 보통 집에 개인용 데스크탑, 노트북 1대씩은 있어서 이 것을 이용하여 쿠버네티스를 구성하고 싶을 때가 있습니다. 그래서 간단하게 쿠버네티스 기본 기능 정도를 학습해 볼 목적으로 말입니다. 이러한 목적으로 쿠버네티스를 1대의 노드에 설치하는 방법에는 Docker Desktop을 이용하는 방법과 Minikube를 이용하는 방법이 있습니다. 각각 설치 방법을 알아보겠습니다.

설치환경

지금부터 이루어지는 설치 작업은 macOS 환경에서 이루어 집니다. Window 환경에서 작업은 우선 macOS 환경에서 이루어지는 과정을 정리한 후에 추후에 Window 환경에서 이루어지는 작업을 정리하도록 하겠습니다.

항목	설명
OS	macOS Catalina v10.15.5
CPU	Intel Core i9 2.3GHz 8Core
Memory	DDR4 16GB 2667MHz

Docker Desktop을 통한 설치 방법

Docker Desktop 다운로드

도커 데스크탑https://www.docker.com/products/docker-desktop에서 설치 파일을 다운로드 합니다. 참고로 다운로드를 위해서 먼저 Sign In 버튼을 통해 가입 및 로그인을 해야 합니다. 그 후 OS에 따라 Stable 메뉴를 통해 설치 파일을 다운로드 합니다.

Docker Desktop 설치

다운로드한 Docker.dmg 파일을 더블클릭하면 아래와 같은 화면을 볼 수 있습니다. 좌측 Docker 이미지를 우측 Applications 이미지로 Drag & Drop하면 설치를 수행합니다. 설치 시 권한을 위한 사용자 계정 비밀번호를 묻는 과정이 있다는 것을 제외하고 화면에서 요구하는 데로 따라가 설치가 완료 됩니다.

설치가 완료되면 노트북 상단에 도커 아이콘이 확인됩니다. 아이콘을 클릭하면 도커 데스크탑 패널이 나타나고 패널에 Docker Desktop is running이 표시되어 있으면 정상적으로 설치가 완료된 것입니다.

kubernetes 활성화

설치가 완료된 도커 데스크탑에서 쿠버네티스를 활성화합니다. 쿠버네티스를 활성화 하는 방법은 우선 방금 확인한 도커 데스크탑 패널에서 Preferences…를 선택합니다.

표출된 설정 패널에서 순서에 따라 Enable Kubernetes,Deploy Docker Stacks to Kubernetes by default를 선택 후 Apply & Restart 메뉴를 선택합니다.

kubernetes 설치 확인

아래 영상을 참고하여 커멘트 입력을 통해 도커 데스크탑에서 kubernetes 활성화가 정상적으로 완료됐는지 확인합니다. 확인 방법은 kuberctl version을 입력했을 때 Client version과 Server version이 정상적으로 출력되지 확인하면 됩니다.

Minikube 통한 설치 방법

kubectl 설치

먼저 Minikube 설치 전에 kubernetes client를 설치해야 합니다. kubernetes client 설치는 바이너리 설치 및 brew 명령어를 통한 설치를 지원합니다. 먼저 바이너리 설치 방법은 아래 순서로 이루어집니다.

• 최신 kubectl 바이너리를 설치합니다.

curl -LO "https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/darwin/amd64/kubectl"

• kubectl 바이너리를 실행 가능하도록 설정합니다.

chmod +x ./kubectl

• 바이너리를 PATH가 설정된 디렉토리로 이동시킵니다.

sudo mv ./kubectl /usr/local/bin/kubectl

• 설치한 버전을 확인합니다.

kubectl version --client

다음으로 brew 명령어를 통한 설치 방법은 아래와 같습니다. 개인적으로 macOS에서는 brew 명령어로 설치하는 것이 간단하고 효율적이여서 추천드립니다.

• brew 설치 명령을 실행합니다.

brew install kubernetes-cli

• 설치 버전을 확인합니다.

kubectl version --client

아래 영상은 brew 명령어를 통해 kubernetes client 설치 방법에 관한 것입니다. 영상에서 나오는 환경에는 이미 kbuernetes client가 설치되어있어서 설치가 진행되지는 않습니다. 다만, 진행 과정을 참고하시면 될것 같습니다.

하이퍼바이저 설치

Minikube 설치 전에 하이퍼바이저 설치가 필요합니다. 하이퍼바이저는 아래 요소 중 한 가지를 선택하여 설치 가능합니다. 이번 설치 예제에서는 VirtualBox를 설치합니다. VirtualBox를 선택한 이유는 minikube 공식사이트에 있는 아래 문구 때문에 선정해 보았습니다.

• HyperKit
• VirtualBox
• VMware Fusion

VirtualBox is minikube’s original driver. It may not provide the fastest start-up time, but it is the most stable driver available for users of Microsoft Windows Home.

물론 마지막에 Microsoft Windows Home이라는 문구가 현재 설치 환경인 macOS와 관련 없을 수 있지만 original dirver라고 하고 개인 노트북에 학습용으로 설치하는 수준이기 때문에 VirtualBox를 선정하여 설치하였습니다.

VirtualBox 사이트 https://www.virtualbox.org/wiki/Downloads에서 macOS 용 설치파일을 다운로드 합니다.

다운로드된 설치 파일을 더블클릭 후, VirtualBox.pkg 아이콘을 더블클릭하여 설치를 시작합니다.

설치 과정에서 보안 유지에 관한 팝업이 발생하면 허용 또는 계속을 클릭합니다.

설치 유형 정보는 변경없이 설치 버튼을 클릭합니다.

성공적인 설치 메시지를 확인하는 것으로 최종 설치 완료 합니다.

Minikube 설치

Minikube 설치 전에 맥OS에서 가상화 지원 여부를 확인하기 위해 아래 명령어를 실행합니다. 명령어 실행 결과에 붉은색으로 강조된 VMX 텍스트가 확인 된다면 VT-x 기능으로 가상화 지원이 가능하다는 뜻이므로 Minikube 설치가 가능합니다.

sysctl -a | grep -E --color 'machdep.cpu.features|VMX'

machdep.cpu.features: FPU VME DE ... VMX <--- 붉은색으로 강조될 텍스

가상화 지원 여부 확인이 완료되면 brew 명령어로 minikube를 설치합니다.

brew install minikube

간단히 brew 명령어로 설치된 minikube가 잘 설치 되었는지 확인을 위해 minikube를 기동합니다.

minikube start --driver=virtualbox

Note minikube 기동 명령어에서 –driver 부분은 설치된 하이퍼바이저 이름을 소문자로 입력합니다. 관련하여 하이퍼바이저 이름에 대한 자세한 사항은 VM driver 지정하기 를 참고합니다.

minikube 기동 후, 상태 확인 스크립트는 아래와 같습니다.

summit@mac-pro ~ % minikube status
minikube
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

minikube 정지 스크립트는 다음과 같습니다.

summit@mac-pro ~ % minikube stop
✋  Stopping node "minikube"  ...
🛑  1 nodes stopped.

간단한 쿠버네티스 삭제 방법

혹시 설치한 쿠버네티스를 개인 PC에서 삭제하고자 할 때는 아래와 같이 조치 가능합니다.

Docker Desktop 삭제 방법

Docker Desktop 패널에서 Uninstall 버튼을 클릭하여 삭제합니다.

Minikube 삭제 방법

Minikube 삭제는 아래 명령어를 수행합니다.

minikube delete

Minikube를 위해 설치한 VirtualBox 삭제는 virtualBox 설치 시 사용했던 설치 파일을 더블클릭하여 VirtualBox Volume이 생성되면 아래 명령어를 수행하여 깔끔하게 삭제합니다.

/Volumes/VirtualBox/VirtualBox_Uninstall.tool

정리

지금까지 쿠버네티스를 개인용 PC(단일 노드)에서 학습을 위해 설치하는 방법을 알아보았습니다. 설치 방법은 Docker Desktop을 활용하는 방법과 Minikube를 활용하는 방법으로 나누어 알아보았습니다. 설치 환경은 macOS에 대해서만 알아본 점이 아쉽지만 Window, Linux 환경에서 설치하는 방법도 다음 글에 추가하여 참고할 수 있도록 하겠습니다.