You are viewing documentation for Kubernetes version: v1.18

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

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이 아닌 호스트에서도 동작하도록 --driver=none 옵션도 지원한다. 이 드라이버를 사용하려면 도커와 리눅스 환경이 필요하지만, 하이퍼바이저는 필요하지 않다.

데비안(Debian) 또는 파생된 배포판에서 none 드라이버를 사용하는 경우, Minikube에서는 동작하지 않는 스냅 패키지 대신 도커용 .deb 패키지를 사용한다. 도커에서 .deb 패키지를 다운로드 할 수 있다.

주의: none VM 드라이버는 보안과 데이터 손실 이슈를 일으킬 수 있다. --driver=none 을 사용하기 전에 이 문서를 참조해서 더 자세한 내용을 본다.

Minikube는 도커 드라이브와 비슷한 vm-driver=podman 도 지원한다. 슈퍼사용자 권한(root 사용자)으로 실행되는 Podman은 컨테이너가 시스템에서 사용 가능한 모든 기능에 완전히 접근할 수 있는 가장 좋은 방법이다.

주의: 일반 사용자 계정은 컨테이너를 실행하는 데 필요한 모든 운영 체제 기능에 완전히 접근할 수 없기에 podman 드라이버는 컨테이너를 root로 실행해야 한다.

패키지를 이용하여 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 설치하기

또 다른 대안으로 리눅스 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--driver 를 설정하려면, 아래에 <driver_name> 로 소문자로 언급된 곳에 설치된 하이퍼바이저의 이름을 입력한다. --driver 값의 전체 목록은 VM driver 지정하기 문서에서 확인할 수 있다.
주의: KVM을 사용할 때 Debian과 다른 시스템에서 libvirt의 기본 QEMU URI는 qemu:///session이고, Minikube의 기본 QEMU URI는 qemu:///system이다. 시스템이 이런 환경이라면, --kvm-qemu-uri qemu:///sessionminikube start에 전달해야 한다.
minikube start --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

다음 내용