minikube 설치 - linux

본 문서에서는 debian OS를 기준으로 설치를 설명합니다.

설치환경

- OS : ebian GNU/Linux 11 (bullseye)

- 자원

• 2 CPUs or more
• 2GB of free memory
• 20GB of free disk space

minikube 란

Minikube는 쿠버네티스를 로컬에서 쉽게 실행하는 도구입니다. Minikube는 쿠버네티스를 사용하거나 개발하려는 사용자들을 위해 가상 머신(VM) 이나 노트북에서 단일 노드 쿠버네티스 클러스터를 실행합니다

쿠버네티스 클러스터를 구축하는 방법에는 kubernetes, minikube, kind, k3s 등 여러가지가 있습니다.

 

설치 전 준비사항

• Docker 설치 - minikube를 사용하기 위한 환경으로 minikube 설치 전에 Docker를 설치합니다.
• kubectl 설치 - kubectl은 kubernetes의 cluster와 통신하여 다양한 object들의 상태확인 또는  생성.삭제 작업 등을 위해 사용되는 CLI 도구입니다. minikube 설치 후 설치해줍니다.

 

1. docker 설치 

 

도커 GPG 키 추가

$ sudo mkdir -p /etc/apt/keyrings
$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

 

repository 설정

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Docker Engine 설치

아래 명령어로 도커 엔진을 설치합니다.

 $ sudo apt-get update
 $ sudo apt-get install docker-ce docker-ce-cli containerd.io

 

도커 설치가 완료되면 일반 유저도 사용할 수 있도록 docker 실행 권한을 줍니다.

sudo usermod -aG docker $USER && newgrp docker

2. minikube 설치

우분투 환경(debian, ubuntu 계열)에서 minikube를 설치하는 명령어입니다. 다른 환경에서 설치하는 명령은 https://minikube.sigs.k8s.io/docs/start 를 참고하면 됩니다. 아래는 debina pakcage로 설치하는 방법과 binary file로 설치하는 방법입니다. 2개의 방법 중 원하는 방식으로 설치하면 됩니다.

1) Debian package로 설치

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube_latest_amd64.deb
sudo dpkg -i minikube_latest_amd64.deb

2) binary file로 설치

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64
sudo install minikube-linux-amd64 /usr/local/bin/minikube

 

 minikube 클러스터 실행

minikube start 명령으로 minikube 클러스터를 실행합니다.

minikube start

minikube 상태 확인

$ minikube status
minikube
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

minikube 클러스터 접속

minikube ssh

기타 명령어

minikube ip : 클러스터 IP

minikube stop :클러스터 중지

minikube delete : 클러스터 삭제

 3. kubectl 설치

 apt 패키지 색인을 업데이트하고 쿠버네티스 apt 리포지터리를 사용하는 데 필요한 패키지들을 설치한다.

sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl

구글 클라우드 공개 사이닝 키를 다운로드한다.

sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg

쿠버네티스 apt 리포지터리를 추가한다.

echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list

새 리포지터리의 apt 패키지 색인을 업데이트하고 kubectl을 설치한다.

sudo apt-get update
sudo apt-get install -y kubectl

클러스터 상태를 가져와서 kubectl이 올바르게 구성되어 있는지 확인합니다.

kubectl cluster-info

 

3minikube cluster 확인

kubectl이 이미 설치되어 있다면 이제 이를 사용하여 클러스터에 액세스할 수 있습니다.

kubectl get po -A

 

또는 minikube에서 적절한 버전의 kubectl을 다운로드할 수 있으며 다음과 같이 사용할 수 있습니다.

minikube kubectl -- get po -A

 

You can also make your life easier by adding the following to your shell config:

alias kubectl="minikube kubectl --"

 

Initially, some services such as the storage-provisioner, may not yet be in a Running state. This is a normal condition during cluster bring-up, and will resolve itself momentarily. For additional insight into your cluster state, minikube bundles the Kubernetes Dashboard, allowing you to get easily acclimated to your new environment:

클러스터 상태에 대한 정보를 확인하기 위해 minikube는 Kubernetes 대시보드를 번들로 제공합니다.

minikube dashboard