태스크

Kubernetes v1.16 문서는 더 이상 적극적으로 관리되지 않음. 현재 보고있는 문서는 정적 스냅샷임. 최신 문서를 위해서는, 다음을 참고. 최신 버전.

Edit This Page

Minikube 설치

이 페이지는 단일 노드 쿠버네티스 클러스터를 노트북의 가상 머신에서 구동하는 도구인 Minikube의 설치 방법을 설명한다.

시작하기 전에

리눅스에서 가상화 지원 여부를 확인하려면, 아래의 명령을 실행하고 출력이 비어있지 않은지 확인한다.

grep -E --color 'vmx|svm' /proc/cpuinfo

맥OS에서 가상화 지원 여부를 확인하려면, 아래 명령어를 터미널에서 실행한다.

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

만약 출력 중에 (색상으로 강조된) VMX를 볼 수 있다면, VT-x 기능이 머신에서 활성화된 것이다.

윈도우 8 이후 버전에서 가상화 지원 여부를 확인하려면, 다음 명령어를 윈도우 터미널이나 명령 프롬프트에서 실행한다.

systeminfo

아래와 같은 내용을 볼 수 있다면, 윈도우에서 가상화를 지원한다.

Hyper-V Requirements:     VM Monitor Mode Extensions: Yes
                          Virtualization Enabled In Firmware: Yes
                          Second Level Address Translation: Yes
                          Data Execution Prevention Available: Yes

다음의 출력을 확인할 수 있다면, 이미 하이퍼바이저가 설치되어 있는 것으로 다음 단계를 건너 뛸 수 있다.

Hyper-V Requirements:     A hypervisor has been detected. Features required for Hyper-V will not be displayed.

minikube 설치하기

kubectl 설치

kubectl이 설치되었는지 확인한다. kubectl은 kubectl 설치하고 설정하기의 요령을 따라서 설치할 수 있다.

하이퍼바이저(hypervisor) 설치

하이퍼바이저를 설치하지 않다면, 운영체제에 적합한 하이퍼바이저를 지금 설치한다.

KVM, 또한 QEMU를 사용한다

VirtualBox

참고: Minikube는 쿠버네티스 컴포넌트를 VM이 아닌 호스트에서도 동작하도록 --vm-driver=none 옵션도 지원한다. 이 드라이버를 사용하려면 도커 와 Linux 환경이 필요하지만, 하이퍼바이저는 필요하지 않는다. none 드라이버를 사용하려면 도커 에서 도커를 apt로 설치하기를 사용하는 것을 권장한다. 도커의 스냅 설치는 minikube에서 작동하지 않는다.

패키지를 이용하여 Minikube 설치

Minikube를 위한 실험적인 패키지가 있다. 리눅스 (AMD64) 패키지는 GitHub의 Minikube의 릴리스에서 찾을 수 있다.

적절한 패키지를 설치하기 위해 리눅스 배포판의 패키지 도구를 사용한다.

Minikube를 직접 다운로드하여 설치

패키지를 통해 설치하지 못하였다면, 바이너리 자체를 다운로드 받고 사용할 수 있다.

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
  && chmod +x minikube

Minikube 실행 파일을 사용자 실행 경로에 추가하는 가장 쉬운 방법은 다음과 같다.

sudo mkdir -p /usr/local/bin/
sudo install minikube /usr/local/bin/

Homebrew를 이용해서 Minikube 설치하기

또 다른 대안으로 Linux Homebrew를 이용해서 Minikube를 설치할 수 있다.

brew install minikube

kubectl 설치

kubectl이 설치되었는지 확인한다. kubectl은 kubectl 설치하고 설정하기의 요령을 따라서 설치할 수 있다.

하이퍼바이저(hypervisor) 설치

하이퍼바이저를 설치하지 않았다면, 다음 중 하나를 지금 설치한다.

HyperKit

VirtualBox

VMware Fusion

Minikube 설치

가장 쉽게 맥OS에 Minikube를 설치하는 방법은 Homebrew를 이용하는 것이다.

brew install minikube

실행 바이너리를 다운로드 받아서 맥OS에 설치할 수도 있다.

curl -Lo minikube https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64 \
  && chmod +x minikube

Minikube 실행 파일을 사용자 실행 경로에 추가하는 가장 쉬운 방법은 다음과 같다.

sudo mv minikube /usr/local/bin

kubectl 설치하기

kubectl이 설치되었는지 확인한다. kubectl은 kubectl 설치하고 설정하기의 요령을 따라서 설치할 수 있다.

하이퍼바이저(hypervisor) 설치하기

하이퍼바이저가 설치 안 되어 있다면 아래중 하나를 지금 설치한다.

Hyper-V

VirtualBox

참고: Hyper-V는 다음 세 버전의 윈도우 10에서 실행할 수 있다. Windows 10 Enterprise, Windows 10 Professional, Windows 10 Education.

Chocolatey를 이용한 Minikube 설치

윈도우에서 Minikube를 설치하는 가장 쉬운 방법은 Chocolatey를 사용하는 것이다(관리자 권한으로 실행).

choco install minikube

Minikube 설치를 마친 후, 현재 CLI 세션을 닫고 재시작한다. Minikube 실행 파일의 경로는 실행 경로(path)에 자동으로 추가된다.

인스톨러 실행파일을 통한 Minikube 설치

윈도우 인스톨러를 사용하여 윈도우에 Minikube를 수동으로 설치하려면, minikube-installer.exe를 다운로드 받고, 이 인스톨러를 실행한다.

직접 다운로드하여 Minikube 설치

윈도우에서 Minikube를 수동으로 설치하려면, minikube-windows-amd64를 다운로드 받아서, 파일 이름을 minikube.exe로 변경하고, 실행 경로에 추가한다.

설치 확인

하이퍼바이저와 Minikube의 성공적인 설치를 확인하려면, 다음 명령어를 실행해서 로컬 쿠버네티스 클러스터를 시작할 수 있다.

참고: minikube start--vm-driver 를 설정하려면, 아래에 <driver_name> 로 소문자로 언급된 곳에 설치된 하이퍼바이저의 이름을 입력한다. --vm-driver 값의 전체 목록은 VM driver 문서에서 지정하기에서 확인할 수 있다.
minikube start --vm-driver=<driver_name>

minikube start 가 완료되면, 아래 명령을 실행해서 클러스터의 상태를 확인한다.

minikube status

만약 클러스터가 실행중이면, minikube status 의 출력은 다음과 유사해야한다.

host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

Minikube가 선택한 하이퍼바이저와 작동하는지 확인한 후에는, Minikube를 계속 사용하거나 클러스터를 중지할 수 있다. 클러스터를 중지하려면 다음을 실행한다.

minikube stop

새롭게 시작하기 위해 모두 정리하기

이전에 Minikube를 설치했었다면, 다음을 실행한다.

minikube start

그리고 minikube start는 에러를 보여준다.

machine does not exist

이제 구성 파일을 삭제해야 한다.

minikube delete

다음 내용

피드백