우분투 24.04|20.04|18.04에 랜처(Rancher) 설치 방법

안녕하세요, 좋은 여러분. 이 가이드는 Ubuntu LTS에서 Rancher 컨테이너 관리 플랫폼의 설치 및 사용법을 다룰 것입니다. Rancher는 Rancher Labs에서 개발한 오픈 소스이며, 프로덕션 환경에서도 사용 가능한 완전한 컨테이너 관리 플랫폼입니다.

Rancher는 Kubernetes를 기본적으로 지원하며 사용자가 간단하고 직관적인 UI를 통해 기능을 제어할 수 있도록 합니다. Kubernetes는 Rancher를 통해 클릭 한 번으로 몇 분 만에 실행할 수 있습니다. 또한 인증을 위해 LDAP, AD, GitHub과 통합됩니다.

Rancher는 또한 90개 이상의 인기 있는 Docker 애플리케이션이 포함된 애플리케이션 카탈로그를 제공하여 버튼 클릭 한 번으로 복잡한 애플리케이션을 배포하고 관리할 수 있습니다. Helm 사용자인 경우에도 염려할 필요가 없는데, Rancher에 Helm이 기본으로 제공되기 때문입니다. 추가로, Rancher UI를 사용하면 Kubernetes를 최신 안정 버전으로 쉽게 업데이트할 수 있습니다.

궁극의 우분투 데스크톱 핸드북

전문가처럼 Ubuntu를 마스터하세요 - 아름다운 데스크탑 커스터마이징부터 강력한 터미널 자동화까지. 작업 공간을 완벽하게 제어하고 싶은 개발자, 시스템 관리자, 파워 유저에게 완벽합니다.

우분투에 Rancher 설치

다음은 Ubuntu에서 Rancher를 설치하는 과정입니다. 설치 후에는 Kubernetes 클러스터를 배포하고 테스트용 애플리케이션 컨테이너를 생성할 것입니다.

이 설정에는 우리가 사용하고 있는 두 개의 가상 머신이 있습니다.

Rancher Node: 192.168.18.60
Worker Node:  192.168.18.61

1단계: 도커 엔진 설치

Rancher와 모든 작업이 Docker 컨테이너에서 실행되므로, 서버에 Docker 엔진이 설치되어 있어야 합니다.

시스템 apt 인덱스 업데이트:

sudo apt update
sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

그런 다음 저장소에서 최신 도커 버전을 설치하세요

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/docker-archive-keyring.gpg
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Docker 엔진 컨테이너 런타임을 설치합니다.

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

패키지 다운로드와 설치가 완료될 때까지 기다린 후 설치된 도커 버전을 확인하세요.

$ docker version
Client: Docker Engine - Community
 Version:           27.0.3
 API version:       1.46
 Go version:        go1.21.11
 Git commit:        7d4bcd8
 Built:             Sat Jun 29 00:02:23 2024
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 Engine:
  Version:          27.0.3
  API version:      1.46 (minimum version 1.24)
  Go version:       go1.21.11
  Git commit:       662f78c
  Built:            Sat Jun 29 00:02:23 2024
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.7.18
  GitCommit:        ae71819c4f5e67bb4d5ae76a6b735f29cc25774e
 runc:
  Version:          1.7.18
  GitCommit:        v1.1.13-0-g58aa920
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

Docker에서 제공하는 스크립트를 사용하여 실험용 버전의 Docker를 설치할 수도 있습니다.

curl -fsSL get.docker.com -o get-docker.sh
chmod +x get-docker.sh
sudo ./get-docker.sh
sudo usermod -aG docker $USER

2단계: Rancher 컨테이너 시작

다음으로, 다음 명령어를 실행하여 새 Rancher 서버 컨테이너를 만듭니다:

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

호스트 시스템에서 다른 애플리케이션이 포트 80 & 443을 사용하고 있다면, 아래와 같이 다른 포트에 매핑할 수 있습니다

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

docker ps 명령어를 사용하여 컨테이너 상태를 확인하세요:

$ docker ps
CONTAINER ID   IMAGE             COMMAND           CREATED         STATUS         PORTS                                                                      NAMES
efefef5aad09   rancher/rancher   "entrypoint.sh"   3 seconds ago   Up 2 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   rancher

3단계: Rancher 웹 UI에 접속

Rancher 노드의 IP 주소 또는 호스트 이름을 확인하세요:

ip ad
# OR
hostname -f

부트스트랩 비밀번호 얻기:

docker logs  rancher  2>&1 | grep "Bootstrap Password:"

명령어 실행 결과 예시:

2024/07/14 13:51:07 [INFO] Bootstrap Password: rkfl7hjffwdvrwwfv7w7wplrcl4qxwmvt4x56cwj9jm9wkmcmsthkp

Rancher 사용자 인터페이스는 https://<server_ip>에서 접속할 수 있습니다.

docker logs 명령어를 실행하여 수집한 비밀번호를 입력하세요.

다음으로 안내에 따라 비밀번호를 변경하세요.

그런 다음 Rancher 대시보드에 액세스하게 됩니다.

3단계: 쿠버네티스 클러스터 생성

여기서는 단일 노드 Kubernetes 클러스터를 생성할 것입니다. 프로덕션 환경에서는 최소한 3개의 노드, 즉 하나의 마스터 노드와 두 개의 워커 노드가 필요하다는 점에 유의하세요.

새 클러스터를 생성하려면 클러스터 관리로 이동하세요

클릭 “클러스터” > “생성”.

여기에는 클러스터를 생성하는 세 가지 옵션이 있습니다:

호스팅된 쿠버네티스 제공업체에서 클러스터를 생성하기
새 노드를 프로비저닝하고 RKE2/K3s를 사용하여 클러스터를 생성하기
기존 노드를 사용하여 RKE2/K3s로 클러스터 생성

새 클러스터를 배포하거나 기존 클러스터를 가져와 Rancher 대시보드에서 관리할 적절한 옵션을 선택하세요.

추가 읽기:

클러스터 배포 및 관리를 위한 방법 단계는 Rancher 문서 페이지를 참조하세요.

Docker와 Kubernetes 관련 더 많은 기사들을 기대해 주세요.