목록으로

Programming Notes

00. 쿠버네티스(Kubernetes) 설치 가이드: 간편하게 k3s로 시작하기

요즘 클라우드 네이티브 환경 구축에 대한 관심이 높아지면서 쿠버네티스(Kubernetes)를 직접 설치하고 경험해보고 싶은 분들이 많으실 겁니다. 하지만 쿠버네티스는 설정이 복잡하다는 인식이 있어 망설이는 분들도 계실텐데요. 걱정 마세요! 이 글에서는 간편한 설치 방법을...

요즘 클라우드 네이티브 환경 구축에 대한 관심이 높아지면서 쿠버네티스(Kubernetes)를 직접 설치하고 경험해보고 싶은 분들이 많으실 겁니다. 하지만 쿠버네티스는 설정이 복잡하다는 인식이 있어 망설이는 분들도 계실텐데요. 걱정 마세요! 이 글에서는 간편한 설치 방법을 제공하는 k3s를 활용하여 우분투 18.04 환경에 쿠버네티스를 손쉽게 설치하는 방법을 알려드리겠습니다. 복잡한 설정 없이 빠르게 쿠버네티스 클러스터를 구축하고, 컨테이너 오케스트레이션의 세계를 경험해 보세요!

우선, 우분투 18.04 시스템이 설치되어 있어야 합니다. 설치가 완료되었다면, 아래 단계를 따라 진행해 주세요. 각 명령어는 순서대로 실행해야 하며, 각 단계에서 발생할 수 있는 문제 해결 방법도 함께 제시하겠습니다.

첫 번째 단계는 필요한 패키지들을 설치하는 것입니다. 다음 명령어를 터미널에 입력하여 실행해 주세요.

apt-get update
apt-get install -y docker.io nfs-common python3-dev python3-pip

이 명령어는 시스템 패키지를 업데이트하고, Docker, NFS 공유, Python 개발 도구, pip 패키지 관리자를 설치합니다. k3s는 Docker를 기반으로 동작하며, 다른 패키지들은 k3s의 부가 기능 및 원활한 동작을 위해 필요합니다.

두 번째 단계는 k3s를 설치하는 것입니다. 다음 명령어를 실행합니다.

curl -sfL https://get.k3s.io | INSTALL_K3S_EXEC="\ --disable traefik \ --disable metrics-server \ --node-name master --docker" \ INSTALL_K3S_VERSION="v1.17.4+k3s1" sh -s -

이 명령어는 k3s 설치 스크립트를 다운로드하여 실행합니다. --disable traefik--disable metrics-server 옵션은 Traefik (ingress controller)와 metrics-server를 비활성화하여 설치 과정을 간소화합니다. --node-name master는 이 노드를 마스터 노드로 설정하며, --docker 옵션은 Docker를 런타임으로 사용하도록 지정합니다. INSTALL_K3S_VERSION은 설치할 k3s 버전을 지정합니다. 필요에 따라 버전을 변경하여 사용할 수 있습니다.

만약 curl 명령어가 없다는 에러 메시지가 발생하면, sudo apt install curl 명령어를 먼저 실행하여 curl을 설치한 후 다시 k3s 설치 명령어를 실행해주세요.

마지막으로 kubeconfig 파일을 설정하여 쿠버네티스 클러스터에 접속할 수 있도록 준비합니다.

mkdir ~/.kube
sudo cp /etc/rancher/k3s/k3s.yaml ~/.kube/config
sudo chown $(id -u):$(id -g) ~/.kube/config

이 명령어는 kubeconfig 파일을 생성하고, 사용자의 권한으로 설정합니다. 이제 kubectl 명령어를 사용하여 쿠버네티스 클러스터를 관리할 수 있습니다. kubectl get nodes 명령어를 실행하여 노드가 정상적으로 작동하는지 확인해 보세요.

k3s를 이용한 간편한 쿠버네티스 설치를 통해 클라우드 네이티브 환경을 빠르게 구축하고 컨테이너 오케스트레이션을 경험해 보세요. 더욱 심화된 내용은 공식 문서를 참고하여 자신의 환경에 맞게 설정을 추가하고 확장할 수 있습니다. 즐거운 쿠버네티스 여정이 되시길 바랍니다!