[minikube] Kubernetes 실습을 위한 Minikube 설치 가이드 (Mac / Windows / Linux)

이글은 Minikube를 다양한 운영체제(Mac / Windows / Linux)에서 가장 간편하게 설치하는 방법을 설명합니다.

필자는 Mac OS기반에서 설치했습니다.

 

1. 쿠버네티스 개요

컨테이너란?

컨테이너는 애플리케이션(프로그램)과 그 프로그램을 실행하는 데 필요한 모든 라이브러리, 설정 파일, 의존성 등을 하나로 묶은 실행 단위입니다.

쉽게 말해, "앱이 어디서든 잘 실행되게 하기 위한 일회용 독립 상자"입니다.

• 컨테이너 = 앱 + 실행환경 + 설정
• 격리된 공간에서 돌아가기 때문에, 다른 앱과 충돌 없이 실행됨
• 실행 속도가 빠르고, 가볍고, 효율적임
• 클라우드에 배포하기 좋고, 실수로 깨지는 일이 적음

가장 대표적인 컨테이너 실행 환경은 Docker입니다.

---

쿠버네티스(Kubernetes)란?

Kubernetes(줄여서 K8s)는 수많은 컨테이너를 자동으로 관리하는 시스템입니다.

• 수많은 앱을 동시에, 안정적으로 실행할 수 있게 도와줍니다.
• 컨테이너를 배포하고, 필요에 따라 자동으로 늘리거나 줄이거나 재시작시킵니다.
• 여러 서버에서 동작하는 앱을 하나의 클러스터처럼 관리합니다.
• Google에서 시작해, 지금은 CNCF(Cloud Native Computing Foundation)가 관리합니다.

---

Minikube란?

Minikube는 로컬 컴퓨터(Mac, Windows, Linux 등)에서 Kubernetes를 간편하게 설치해서 실습할 수 있게 해주는 툴입니다.

• 실습/학습용 Kubernetes 클러스터
• 로컬 환경에서 Kubernetes 연습을 할 수 있음
• Docker, VirtualBox, HyperKit 등 다양한 드라이버 지원
• 클라우드에 올리기 전에 미리 테스트할 수 있음

---

2. Kubernetes 구성요소

• Pod: 쿠버네티스에서 가장 작은 배포 단위로, 하나 이상의 컨테이너로 구성됩니다.
• Node: 컨테이너가 실제 실행되는 머신 (VM 또는 물리 서버).
• Cluster: 여러 노드와 쿠버네티스 제어 구성요소들의 집합.
• Service: 외부에서 Pod에 접근할 수 있도록 해주는 네트워크 추상화 계층.
• Deployment: Pod의 상태를 선언하고 이를 유지시키는 역할.

---

3. kubectl 소개

kubectl은 쿠버네티스 클러스터를 제어할 수 있는 커맨드라인 도구입니다.

클러스터의 상태 확인, 리소스 생성/삭제, 로그 확인, 배포 관리 등을 할 수 있습니다.

아래 사이트에 들어가면 kubectl 설치 가이드를 볼 수 있습니다

https://kubernetes.io/docs/tasks/tools/

Install Tools

 

---

4. Minikube 설치 및 실행 (Mac / Windows / Linux)

아래 사이트에 들어가면 설치 가이드를 참고 할 수 있습니다.

https://minikube.sigs.k8s.io/docs/start/?arch=%2Fmacos%2Farm64%2Fstable%2Fhomebrew

minikube start

---

🍎 MacOS

1) Docker Desktop 설치 (권장)

https://www.docker.com/products/docker-desktop/

Docker Desktop: The #1 Containerization Tool for Developers | Docker

 

Docker Desktop을 설치하면, Minikube가 docker 드라이버를 자동으로 감지하고 사용할 수 있습니다.

2) Homebrew로 kubectl 설치

brew install kubectl

 

kubectl 설치 확인

3) Homebrew로 minikube 설치

brew install minikube

 

4) Minikube 실행

minikube start

 

docker desktop 설치로 자동으로 드라이버가 선택된 모습

 

 

kubectl 현재 상태 조회

 

---

🪟 Windows (WSL → Linux 추천)

윈도우 powershell은 명령어 호환 되지 않는 경우가 많고, 외부 터미널 툴도 완벽하게 호환되지 않는 경우가 많습니다.

WSL 설치 후, 리눅스 환경에서 실행하는것을 추천드립니다.

 

1) Chocolatey 설치 후 명령 프롬프트에서 다음 실행

choco install kubernetes-cli
choco install minikube

2) Minikube 시작

minikube start

---

🐧 Linux (Ubuntu 기준)

curl -LO <https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64>
sudo install minikube-linux-amd64 /usr/local/bin/minikube
sudo apt-get update
sudo apt-get install -y apt-transport-https
sudo apt-get install -y kubectl

minikube start

---

⚠️ 도커 드라이버 및 서비스 접근 시 유의사항

도커 드라이버 사용하는 경우

• 기본 IP 접근 (minikube ip)은 작동하지 않음
• 대신 다음 명령을 사용하여 서비스에 접근 가능:

kubectl port-forward webapp 30080:80

이 명령을 실행하는 동안 포트 포워딩 터미널은 열려 있어야 하며, 다른 터미널에서 작업을 계속해야 합니다.

또는

minikube service webapp

이 명령은 자동으로 브라우저를 열어줍니다. 만약 열리지 않는 경우, 출력된 주소(http://127.0.0.1:56064 등)를 수동으로 브라우저에 입력하면 됩니다. 포트 번호는 실행 시마다 달라질 수 있으니 주의하세요.

---