이 페이지는 단일 노드 쿠버네티스 클러스터를 노트북의 가상 머신에서 구동하는 도구인 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.
kubectl이 설치되었는지 확인한다. kubectl은 kubectl 설치하고 설정하기의 요령을 따라서 설치할 수 있다.
하이퍼바이저를 설치하지 않다면, 운영체제에 적합한 하이퍼바이저를 지금 설치한다.
• KVM, 또한 QEMU를 사용한다
Minikube는 쿠버네티스 컴포넌트를 VM이 아닌 호스트에서도 동작하도록 --vm-driver=none
옵션도 지원한다.
이 드라이버를 사용하려면 도커 와 Linux 환경이 필요하지만, 하이퍼바이저는 필요하지 않다.
데비안(Debian) 또는 파생된 배포판에서 none
드라이버를 사용하는 경우,
Minikube에서는 동작하지 않는 스냅 패키지 대신 도커용 .deb
패키지를 사용한다.
도커에서 .deb
패키지를 다운로드 할 수 있다.
Minikube는 도커 드라이브와 비슷한 vm-driver=podman
도 지원한다. 슈퍼사용자 권한(root 사용자)으로 실행되는 Podman은 컨테이너가 시스템에서 사용 가능한 모든 기능에 완전히 접근할 수 있는 가장 좋은 방법이다.
주의: 일반 사용자 계정은 컨테이너를 실행하는 데 필요한 모든 운영 체제 기능에 완전히 접근할 수 없기에podman
드라이버는 컨테이너를 root로 실행해야 한다.
Minikube를 위한 실험적인 패키지가 있다. 리눅스 (AMD64) 패키지는 GitHub의 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/
또 다른 대안으로 Linux Homebrew를 이용해서 Minikube를 설치할 수 있다.
brew install minikube
kubectl이 설치되었는지 확인한다. kubectl은 kubectl 설치하고 설정하기의 요령을 따라서 설치할 수 있다.
하이퍼바이저를 설치하지 않았다면, 다음 중 하나를 지금 설치한다.
• HyperKit
가장 쉽게 맥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 설치하고 설정하기의 요령을 따라서 설치할 수 있다.
하이퍼바이저가 설치 안 되어 있다면 아래중 하나를 지금 설치한다.
• Hyper-V
참고: Hyper-V는 다음 세 버전의 윈도우 10에서 실행할 수 있다. Windows 10 Enterprise, Windows 10 Professional, Windows 10 Education.
윈도우에서 Minikube를 설치하는 가장 쉬운 방법은 Chocolatey를 사용하는 것이다(관리자 권한으로 실행).
choco install minikube
Minikube 설치를 마친 후, 현재 CLI 세션을 닫고 재시작한다. Minikube 실행 파일의 경로는 실행 경로(path)에 자동으로 추가된다.
윈도우 인스톨러를 사용하여 윈도우에 Minikube를 수동으로 설치하려면, minikube-installer.exe
를 다운로드 받고, 이 인스톨러를 실행한다.
윈도우에서 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
이 페이지가 도움이 되었나요?
피드백 감사합니다. 쿠버네티스 사용 방법에 대해서 구체적이고 답변 가능한 질문이 있다면, 다음 링크에서 질문하십시오. Stack Overflow. 원한다면 GitHub 리포지터리에 이슈를 열어서 문제 리포트 또는 개선 제안이 가능합니다..