Debian 12 서버에 Rancher 설치하는 방법

Rancher는 Kubernetes 클러스터의 배포, 관리 및 거버넌스를 용이하게 하기 위해 설계된 오픈 소스 컨테이너 관리 플랫폼입니다. Kubernetes 자체를 대체하는 Kubernetes 배포판과 달리, Rancher는 하나 이상의 Kubernetes 클러스터 위에 위치하는 관리 솔루션으로, 관리자가 전체 컨테이너 인프라를 감독할 수 있는 중앙 집중식 플랫폼을 제공합니다.

이 튜토리얼에서는 Debian 12 서버에 Rancher를 설치하는 방법을 배웁니다. Rancher를 Docker를 통해 단일 노드로 설치하며, 이 또한 그 위에 Kubernetes 단일 노드를 배포합니다.

전제 조건

이 가이드를 시작하기 전에 다음 사항을 확인하세요:

• 최소 4GB의 RAM 또는 메모리를 가진 Debian 12 서버
• 관리자 권한이 있는 비루트 사용자

Docker 설치하기

Rancher를 설치하기 전에 시스템에 Docker가 설치되어 있는지 확인해야 합니다. 이 섹션에서는 Debian 시스템에 공식 Docker 저장소를 통해 Docker Engine을 설치합니다.

먼저, 아래 명령어를 실행하여 패키지 인덱스를 업데이트하고 ‘ca-certificates’ 및 ‘curl’과 같은 패키지를 설치합니다.

sudo apt update && sudo apt install ca-certificates curl -y

이제 다음 명령어를 실행하여 Docker 저장소의 GPG 키를 추가합니다.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

다음으로, 아래 명령어를 실행하여 Docker 저장소를 Debian 시스템에 추가합니다. 이 명령어는 Debian 버전을 자동으로 감지합니다.

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

이제 Docker 저장소와 GPG 키를 추가했으므로, 아래 명령어를 실행하여 패키지 인덱스를 새로 고치고 Docker Engine을 시스템에 설치합니다. 이 예제에서는 Docker Compose 및 Docker Buildx 플러그인과 같은 추가 패키지와 함께 Docker Engine을 설치합니다.

sudo apt update && sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

설치를 진행하려면 ‘Y’를 입력하세요.

설치가 완료되면 아래 ‘systemctl’ 명령어를 사용하여 Docker 서비스 상태를 확인합니다. Debian 머신에서 Docker가 실행 중이며 활성화되어 있는 것을 볼 수 있습니다.

sudo systemctl is-enabled docker  
sudo systemctl status docker

마지막으로, 아래 ‘docker’ 명령어를 실행하여 ‘hello-word’ 컨테이너를 실행할 수 있습니다.

sudo docker run hello-world

성공하면 Docker에서 다음과 같은 ‘Hello World‘ 메시지를 받게 됩니다.

Rancher 설치하기

이제 Docker가 설치되었으므로 Rancher를 설치할 준비가 되었습니다. 이 섹션에서는 Rancher 이미지를 다운로드한 후 Docker를 통해 Rancher 컨테이너를 실행합니다. 이 예제에서는 Rancher 컨테이너에 의해 자동으로 생성된 자체 서명된 인증서를 사용할 것입니다. 또한 최신 버전의 Rancher 이미지를 사용할 것입니다.

아래 ‘docker pull’ 명령어를 사용하여 Rancher 이미지를 다운로드합니다. 이 예제에서는 Rancher 최신 버전을 사용할 것입니다.

sudo docker pull rancher/rancher:latest

Rancher 이미지가 다운로드되면 ‘docker run’ 명령어를 실행하여 Rancher를 실행합니다. 이렇게 하면 Rancher 컨테이너가 백그라운드에서 실행되며 호스트 Debian 서버에서 포트 80 및 443을 내보냅니다.

sudo docker run -d --restart=unless-stopped \  
-p 80:80 -p 443:443 \  
--privileged \  
rancher/rancher:latest

아래 명령어를 사용하여 컨테이너 상태를 확인합니다.

sudo docker ps

아래 출력에서 Rancher가 포트 443에서 실행되고 있는 것을 볼 수 있습니다. 또한 컨테이너 ID와 컨테이너 이름을 확인할 수 있습니다.

추가로, 오류가 발생한 경우 아래 ‘docker’ 명령어로 Rancher 로그를 확인할 수 있습니다.

docker ps -a  
docker log container-name or container id

‘ps -a’ 옵션은 실행 중인 컨테이너와 종료된 컨테이너를 보여주며, ‘docker log’ 명령어는 컨테이너의 로그를 확인하는 데 사용됩니다.

Rancher 구성하기

이 시점에서 Rancher는 Debian 시스템에서 컨테이너로 실행되고 있습니다. 다음 단계에서는 Rancher 대시보드에 로그인하여 Rancher 설치 위에서 실행 중인 Kubernetes 단일 노드를 확인합니다.

웹 브라우저를 열고 Debian 서버 IP 주소 뒤에 포트 8080을 추가하여 방문합니다. 예를 들어 https://192.168.10.41:8080/와 같습니다. 설치가 성공적이라면 다음 Rancher 로그인 페이지가 표시됩니다.

터미널로 돌아가서 아래 명령어를 실행하여 Rancher 비밀번호를 가져옵니다. 설치에 따라 컨테이너 ID를 변경하고 비밀번호를 복사하세요.

sudo docker logs CONTAINER ID 2>&1 | grep "Bootstrap Password:"

이제 비밀번호를 입력하고 로컬 사용자로 로그인을 클릭합니다.

다음으로, Rancher에 대한 생성된 비밀번호를 복사하고 약관 및 라이센스를 수락합니다.

이제 다음 Rancher 대시보드를 볼 수 있습니다. 아래 예제에서는 K3s로 생성된 단일 노드 Kubernetes 클러스터를 볼 수 있습니다.

로컬 Kubernetes 클러스터를 클릭하면 Kubernetes 클러스터에 대한 더 많은 정보를 얻을 수 있습니다.

kubectl로 Kubernetes 클러스터에 접근하기

먼저, KubeConfig를 로컬 컴퓨터에 다운로드합니다. Rancher 대시보드에서 아래 파일 메뉴를 클릭합니다.

아래 명령어를 사용하여 시스템에 ‘kubectl’을 설치합니다. Debian 12에서는 APT를 통해 ‘kubernetes-client‘ 패키지를 설치할 수 있습니다.

sudo apt install kubernetes-client -y

기본 KUBECONFIG를 파일로 설정합니다. 이 예제에서는 KubeConfig 파일이 ‘kubeconfig.yaml’입니다.

export KUBECONFIG=~/kubeconfig.yaml

마지막으로, 아래 ‘kubectl’ 명령어를 실행하여 모든 Kubernetes 네임스페이스에서 포드 목록을 가져옵니다.

kubectl get pods --all-namespaces

Rancher 아래의 Kubernetes 클러스터에 있는 각 포드가 실행 중인 것을 볼 수 있습니다.

결론

축하합니다! Debian 12 서버에 Docker로 Rancher 설치를 완료했습니다. Rancher를 설정하고 그 위에 Kubernetes 클러스터를 생성하는 방법을 배웠습니다. 마지막으로, Kubernetes 클라이언트 ‘kubectl’을 통해 Kubernetes 클러스터와 상호작용하는 방법도 배웠습니다. 또한 ‘kubectl’을 통해 Kubernetes 클러스터에 컨테이너화된 애플리케이션을 배포할 수 있습니다.