쿠버네티스의 기본 개념은 이전 튜토리얼에서 이미 다룬 바 있습니다. 이번 글에서는 실제로 쿠버네티스를 학습하고 실험할 수 있는 환경을 구축하는 방법을 소개합니다. 미니큐브(Minikube)는 단일 노드 쿠버네티스 클러스터를 손쉽게 구성할 수 있는 도구로, 가상 머신 안에 그대로 담을 수 있기 때문에 노트북에서 쿠버네티스를 실행하는 가장 좋은 방법으로 꼽힙니다.
쿠버네티스 공식 웹사이트에서는 미니큐브 시작 방법에 대한 전체 가이드를 제공합니다. 이 글에서는 해당 절차를 실제 스크린샷과 함께 단계별로 정리했습니다.
1단계: 하이퍼바이저(Hypervisor) 설치
가장 먼저 KVM, VMware Fusion, Hyper-V, VirtualBox와 같은 하이퍼바이저를 설치해야 합니다. 사용 중인 운영체제가 Windows인지, Mac인지, Linux인지에 따라 권장되는 하이퍼바이저가 다르니 아래 목록에서 자신에게 맞는 것을 선택하세요. 이 글에서는 세 운영체제 모두에서 호환되는 VirtualBox를 기준으로 진행합니다.
VirtualBox는 공식 웹사이트에서 다운로드할 수 있습니다. 아래 화면은 Windows용 선택 예시이지만, Linux 패키지나 Mac용 파일도 동일한 방식으로 고를 수 있습니다.
다운로드가 완료되면 컴퓨터에 VirtualBox를 설치합니다.
다음으로 VirtualBox 애플리케이션이 실행될 폴더 경로를 지정해야 합니다. 기본 설정값대로 두면 Oracle 폴더 안에 자동으로 설치되므로, 특별한 이유가 없다면 기본값을 그대로 사용해도 무방합니다.
하이퍼바이저 설치가 끝나면 바로 가상 머신을 만들어 쿠버네티스 프로젝트를 진행할 수 있습니다. 가상 머신 이름은 "Kubernetes project"처럼 알아보기 쉽게 지정하고, 올바른 운영체제와 버전을 선택하세요.
이어서 가상 하드 디스크를 생성해야 하는데, 권장 크기는 50GB입니다. 다소 부담스러운 용량처럼 느껴질 수 있지만, 하나의 물리적인 머신 안에서 여러 개의 VirtualBox 가상 머신을 만들어 활용할 수 있다는 장점이 있습니다.
마지막으로 메모리(RAM)를 할당합니다. 최소 2048MB(2GB) 이상을 권장합니다. 여기까지 완료하면 쿠버네티스용 가상 머신 준비가 끝납니다.
2단계: kubectl 설치
하이퍼바이저 설치 후에는 쿠버네티스 공식 사이트에서 제공하는 kubectl을 설치해야 합니다. kubectl은 매우 중요한 명령줄 도구로, 마스터(Master) 노드가 워커(Worker) 노드에 내리는 모든 명령을 단독으로 처리합니다. 역시 Linux, Mac, Windows 중 자신의 환경에 맞는 버전을 선택하면 됩니다.
Windows 사용자라면 C 드라이브에 "Kubernetes"라는 이름의 폴더를 만들고, 그 안에 .exe 파일을 다운로드하는 것이 좋습니다. 다운로드는 자동으로 시작되며 오래 걸리지 않습니다.
다음으로 터미널 에뮬레이터가 kubectl을 찾을 수 있도록 환경 변수(Path)를 등록해야 합니다. Windows 10 기준으로 "내 PC(This PC)"를 마우스 오른쪽 버튼으로 클릭한 뒤 "속성(Properties)"으로 이동하고, "고급 시스템 설정(Advanced system settings)" → "환경 변수(Environment variables)" 순서로 들어갑니다.
여기서 kubectl 파일이 위치한 폴더의 새 경로를 추가합니다. "새로 만들기(New)"를 클릭하고 폴더 이름과 동일하게 환경 변수 값을 입력하면 됩니다. 이 예제에서는 C:\Kubernetes입니다. 확인을 누르고 열려 있는 모든 창을 닫습니다.
kubectl이 제대로 설치되었는지 확인하려면 명령 프롬프트를 엽니다. 참고로 이 과정은 데모용이며, Windows에서 실제 쿠버네티스 프로젝트를 진행할 때는 Cygwin 같은 대체 터미널을 사용하는 편이 더 좋습니다. Mac과 Linux 사용자는 기본 터미널을 그대로 사용해도 문제없습니다.
명령 프롬프트에 kubectl을 한 번 입력하고 Enter 키를 누릅니다. kubectl에서 사용할 수 있는 전체 명령 목록이 출력되면 정상적으로 설치된 것입니다.
3단계: Minikube 설치
마지막으로 Minikube를 설치합니다. Windows 사용자에게 가장 간편한 방법은 "Minikube-Windows-AMD64"라는 애플리케이션을 다운로드하는 것입니다.
참고: AMD64는 64비트 프로세서를 의미합니다. Intel 시스템에서도 동일하게 작동하니 걱정하지 않아도 됩니다.
위 버전을 선택하려면 아래 화면과 같이 Minikube의 GitHub 페이지에서 해당 파일을 찾아야 합니다.
다운로드한 파일은 앞서 만든 Kubernetes 폴더에 넣고, 실행하기 전에 반드시 파일 이름을 "minikube.exe"로 변경해야 합니다.
마지막으로 Minikube가 제대로 설치되었는지 확인합니다. 위의 모든 단계를 따랐다면 이제 즐겨 쓰는 명령 터미널에서 Minikube를 실행할 수 있습니다. minikube라고 입력하고 Enter 키를 누르기만 하면 됩니다. 또한 Oracle에서 제공하는 상세 튜토리얼을 참고하면 명령줄에서 VirtualBox를 다루는 방법도 익힐 수 있습니다.
화면에 Minikube의 기본 명령들이 출력되면 성공입니다. 이후에는 쿠버네티스 공식 웹사이트의 다양한 튜토리얼을 따라 하면서 실습해 보세요. 물론 익숙해지기까지는 시간과 인내심이 필요합니다!
마무리
쿠버네티스를 익히고 나면 컨테이너를 손쉽게 오케스트레이션하고, 자신만의 서버와 데이터 센터를 직접 운영할 수 있게 됩니다. 나아가 라즈베리 파이(Raspberry Pi)나 아두이노(Arduino)를 활용한 사물인터넷(IoT) 프로젝트에도 도전해 볼 수 있습니다.
Minikube 설치 과정에서 어려움을 겪으셨나요? 댓글로 알려주세요.