Kubernetes는 구글에서 공개한 리눅스 컨테이너 관리 시스템 (Docker Orchestrator)
kubernetes cluster를 설치하기 위해서는 우선 두 개 이상의 환경이 필요하다.
각각의 환경에는 ubuntu가 깔려있는 경우에 설명을 진행하도록 하겠다. (18.04_x64이상의 버전이어야 가능한 것으로 알고 있다)
- Master
- Worker ( 1개 이상)
3가지의 part로 나누어 설명하도록 하겠다
-
Master, Worker 모두에 해당되는 부분
-
Master에만 해당되는 부분
-
Worker에만 해당되는 부분
Master, Worker 모두에 해당되는 부분
패키지를 최신화, ssh를 설치, reboot
- sudo apt-get update
- sudo apt-get upgrade -y
- sudo apt-get install ssh -y
- Reboot
( root 계정에서 명령어를 수행하는 경우에는 sudo를 생략가능)
( apt-get(Advanced Packaging Tool)은 우분투(Ubuntu)를 포함한 데비안(Debian) 계열의 리눅스에서 쓰이는 패키지 관리 명령어 도구 )
( update는 설치된 패키지의 최신 버전이 있는지 확인, upgrade는 최신 버전으로 업그레이드 수행)
Docker 설치 (Docker-CE :Community Edition)
(개인 개발자나 작은 팀이 도커를 시작할 때나 컨테이너 기반의 앱들을 실험할 때 적합)
- sudo apt-get install apt-transport-https ca-certificates curl software-properties-common -y
- curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
- sudo apt-key fingerprint 0EBFCD88
- sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
- sudo apt-get update
- sudo apt-get install docker-ce -y
- systemctl enable docker.service
모든 명령어를 수행한 이후에 systemctl status docker 명령으로 active(runnning) 상태인지 확인
Kubernetes 설치
- sudo swapoff -a
- curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
- echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
- sudo apt-get update
- sudo apt-get install -y kubelet=1.15.3-00 kubeadm=1.15.3-00 kubectl=1.15.3-00
- apt-mark hold kubelet kubeadm kubectl
( swapoff 가상 메모리 사용을 비활성화하는 옵션) (kubernetes에서는 가상 메모리 사용 비활성화가 필수라 한다)
모든 명령어를 수행한 이후에 kubectl version 명령어를 통해 설치 버전이 확인 가능하다.
Master에만 해당되는 부분
Docker Registry 구축
Docker Image 저장소를 Master노드에 구축
위에서는 docker를 설치했고, 이를 바탕으로 docker image들이 저장되는 registry를 구축해야 한다.
- sudo docker pull registry:latest
- sudo docker run --name registry -d -p 5000:5000 --restart=always registry
- /etc/docker 경로에 daemon.json 파일 생성하여 아래 내용 추가
- { "insecure-registries":["<master-node-IP>:5000"] }
- systemctl restart docker
모든 명령어를 수행한 이후에 curl -X GET http://<master-node-IP>:5000/v2/_catalog 명령어를 통해 registry가 정상 설치되었는지 확인
Kubernetes Cluster 생성
- kubeadm init --apiserver-advertise-address <master-node-IP>
설치하는데 몇 분 정도 걸린다.
설치가 완료되면 위와 같은 로그가 발생한다.
- 초록색 상자에 해당하는 명령어를 수행해주어야 한다
- mkdir –p $HOME/.kube
- sudo cp –I /etc/kubernetes/admin.conf $HOME/.kube/config
- sudo chown $(id –u):$(id –g) $HOME/.kube/config
- export KUBECONFIG=$HOME/.kube/config (환경변수 설정)
- 파란색 상자에 해당하는 부분은 따로 저장해 놓는다 (나중에 Worker에서 join 할 때 필요한 명령어이다)
kubectl get node와 kubectl get pod --all-namespaces -o wide 명령으로 node 및 pod의 정상 동작을 확인합니다.
node : NotReady
pod : 네트워크 설치 전이므로 coredns pod Pending
총 5개의 pod가 정상적으로 Runing 된 부분을 확인 후 다음 스탭 진행 (기다리는데 시간이 꽤 걸렸던 걸로 기억)
Kubernetes CNI 설치
CNI는 Master와 Work node의 네트워크 내부 통신을 위한 네트워크 인터페이스
- kubectl apply -f https://docs.projectcalico.org/v3.9/manifests/calico.yaml
kubectl get node와 kubectl get pod --all-namespaces -o wide 명령으로 node 및 pod의 정상 동작을 확인합니다.
위에서 pending상태였던 coredns pod가 Running으로 상태가 바뀌고 Node의 상태도 ready이어야 한다.
(기다리는데 시간이 꽤 걸렸던 걸로 기억)
Worker에만 해당되는 부분
Kubernetes Cluster Join
Worker 노드들을 Kubernetes Cluster에 join 합니다.
Master노드에서 저장한 join 명령을 Worker에서 수행합니다.
- kubeadm join <master-node-IP>:6443 --token (...생략...) ...26e623138a
명령어를 수행한 이후에 Master 노드에서 kubectl get nodes 명령을 수행하여 Worker 노드가 join 됨을 확인합니다.
설치 완료!