Rancher(rke2) Test

🤠 Rancher & RKE2 Cluster 구축 가이드

Base OS: Ubuntu 22.04 LTS (OpenStack VMs)

1. RKE2 Master Node 구성 (Node 01)

대상: rancher-01 (172.16.16.238) 역할: Control Plane + Etcd + Worker

# 1. RKE2 설치 스크립트 실행
curl -sfL <https://get.rke2.io> | sh -

# 2. 설정 디렉토리 생성
mkdir -p /etc/rancher/rke2

# 3. 설정 파일 작성 (Etcd 활성화 - Master)
cat <<EOF > /etc/rancher/rke2/config.yaml
token: PoCpassword
tls-san:
  - rancher-01
  - 172.16.16.238
node-ip: 172.16.16.238
node-external-ip: 172.16.16.238
EOF

# 4. 서비스 시작
systemctl enable rke2-server
systemctl start rke2-server

# 5. kubectl 환경 설정
ln -s /var/lib/rancher/rke2/bin/kubectl /usr/local/bin/kubectl
echo "export KUBECONFIG=/etc/rancher/rke2/rke2.yaml" >> ~/.bashrc
source ~/.bashrc

# 6. 노드 상태 확인
kubectl get nodes -o wide

# node가 정상적으로 올라오지 않을 경우, image가 정상적으로 다운로드 되지 않았을 수 있음.
# RKE2 런타임 이미지 Pull
# Pulling image
sudo /var/lib/rancher/rke2/bin/ctr -a /run/k3s/containerd/containerd.sock -n k8s.io images pull docker.io/rancher/rke2-runtime:v1.33.6-rke2r1
sudo /var/lib/rancher/rke2/bin/ctr -a /run/k3s/containerd/containerd.sock -n k8s.io images ls | grep runtime
sudo systemctl restart rke2-server
kubectl get nodes -o wide

# 7. (중요) Full Token 확인
# 이 토큰값(K10...)을 복사해서 02, 03번 노드 설정에 넣어야 함
sudo cat /var/lib/rancher/rke2/server/node-token
# 예시: K10ab36d6ffae95ccf7932f4267ec5a78b3ba678b921e115aeafb48544dc36ff6ef::server:PoCpassword

2. RKE2 Member Node 구성 (Node 02, 03)

대상: rancher-02, rancher-03역할: Control Plane + Worker (Etcd 제외)

2-1. Rancher-02 구성

# 1. 설치 스크립트
curl -sfL <https://get.rke2.io> | sh -
mkdir -p /etc/rancher/rke2

# 2. 설정 파일 작성 (disable-etcd: true)
# token에는 1번 노드에서 확인한 K10... 전체 문자열 입력
cat <<EOF > /etc/rancher/rke2/config.yaml
server: <https://172.16.16.238:9345>
token: K10ab36d6ffae95ccf7932f4267ec5a78b3ba678b921e115aeafb48544dc36ff6ef::server:PoCpassword
disable-etcd: true
tls-san:
  - rancher-02
  - 172.16.16.239
node-ip: 172.16.16.239
node-external-ip: 172.16.16.239
EOF

# 3. 서비스 시작
systemctl enable rke2-server
systemctl start rke2-server

2-2. Rancher-03 구성

# 1. 설치 스크립트
curl -sfL <https://get.rke2.io> | sh -
mkdir -p /etc/rancher/rke2

# 2. 설정 파일 작성 (disable-etcd: true)
cat <<EOF > /etc/rancher/rke2/config.yaml
server: <https://172.16.16.238:9345>
token: K10ab36d6ffae95ccf7932f4267ec5a78b3ba678b921e115aeafb48544dc36ff6ef::server:PoCpassword
disable-etcd: true
tls-san:
  - rancher-03
  - 172.16.16.240
node-ip: 172.16.16.240
node-external-ip: 172.16.16.240
EOF

# 3. 서비스 시작
systemctl enable rke2-server
systemctl start rke2-server

3. 이미지 수동 다운로드 (특정 이미지가 다운로드 되지 않았을 경우)

대상: 02, 03 노드 인터넷 속도가 느려 Pod가 NotReady 상태에 빠질 경우 수동으로 실행

# Image 버전 확인(Node 01)
sudo /var/lib/rancher/rke2/bin/ctr -a /run/k3s/containerd/containerd.sock -n k8s.io images ls | grep -E "calico|flannel"

# CNI(네트워크) 이미지 Pull (버전은 1번 노드에서 확인 필요)
sudo /var/lib/rancher/rke2/bin/ctr -a /run/k3s/containerd/containerd.sock -n k8s.io images pull docker.io/rancher/hardened-calico:v3.27.3-build20240422
sudo /var/lib/rancher/rke2/bin/ctr -a /run/k3s/containerd/containerd.sock -n k8s.io images pull docker.io/rancher/hardened-flannel:v0.25.1-build20240422

# 서비스 재시작
sudo systemctl restart rke2-server

4. Rancher 웹 UI 설치 (Helm)

대상: rancher-01

# 1. Helm 설치
curl <https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3> | bash

# helm version 확인(정상 설치 되었는지 확인 겸)
helm version

# 2. Cert-Manager 설치 (HTTPS 인증서 관리)
helm repo add jetstack <https://charts.jetstack.io>
helm repo update
helm install cert-manager jetstack/cert-manager \\
  --namespace cert-manager \\
  --create-namespace \\
  --set crds.enabled=true

# 3. Hosts 파일 설정 (사설 도메인 매핑)
cat << EOF >> /etc/hosts
211.239.112.38 dhp.rancher.com
EOF

# 4. Rancher 설치
helm repo add rancher-stable <https://releases.rancher.com/server-charts/stable>
helm repo update
helm install rancher rancher-stable/rancher \\
  --namespace cattle-system \\
  --create-namespace \\
  --set hostname=dhp.rancher.com \\
  --set bootstrapPassword=admin

5. 🚨 트러블슈팅 (DNS & Timeout)

대상: rancher-01사설 도메인(dhp.rancher.com)을 사용하고, 초기 부팅이 느릴 경우 발생하는 무한 재시작 오류 수정

5-1. DNS 해결 (HostAliases 추가) & 부팅 시간 연장 (StartupProbe)

kubectl edit deployment rancher -n cattle-system 명령으로 아래 내용을 수정하거나, 패치 명령어를 사용합니다.

수정 포인트:

1. hostAliases: 파드 내부에 /etc/hosts 강제 주입
2. startupProbe: 초기 구동 대기 시간을 600초(10분)로 연장

# (참고용) 수정 후 반영되어야 할 YAML 구조
spec:
  template:
    spec:
      hostAliases:
      - ip: "211.239.112.38"
        hostnames:
        - "dhp.rancher.com"
      containers:
      - name: rancher
        startupProbe:
          failureThreshold: 60     # (기존 12 -> 60)
          periodSeconds: 10
          initialDelaySeconds: 60  # (추가)