[DevOps]📌 Ubuntu 22.04에서 Kubernetes 클러스터 환경 세팅 (마스터 1대 + 워커 2대)

🎯 목표:

가상머신 3대(Master 1개 + Worker 2개)를 이용해서 Kubernetes 클러스터를 설치하기 위한 사전 준비를 진행할 거야!

CPU 2개, 메모리 4GB를 가진 가상머신이 필요해.

---

✅ 1️⃣ 호스트 이름(컴퓨터 이름) 설정

각 가상머신(서버)의 이름을 지정해줘야 해.

서버의 역할에 따라 이름을 다르게 설정해야 나중에 관리하기 편해!

🔹 할 일

• 마스터 서버: master
• 워커 서버 1: worker01
• 워커 서버 2: worker02

📌 실행할 명령어 (각 노드에서 실행)

vi /etc/hostname

➡ 파일을 열고 아래처럼 변경해줘!

master   # (마스터 노드에서는 이렇게 설정)
worker01 # (첫 번째 워커 노드에서는 이렇게 설정)
worker02 # (두 번째 워커 노드에서는 이렇게 설정)

📌 적용하기 (모든 노드에서 실행)

init 6  # 시스템을 재부팅해서 변경된 호스트 이름을 적용함

---

✅ 2️⃣ containerd 설치 (컨테이너 런타임)

Kubernetes는 컨테이너를 실행하는데, containerd라는 런타임을 사용해.

Docker도 있지만, K8s에서는 containerd를 많이 사용해.

📌 실행할 명령어 (각 노드에서 실행)

apt -y install containerd

➡ -y 옵션은 설치할 때 "Yes"를 자동으로 선택해주는 거야.

---

✅ 3️⃣ 가상 네트워크 설정 (브릿지 네트워크 활성화)

Kubernetes에서는 노드 간에 네트워크가 연결되어야 해.

이 설정을 해줘야 K8s 네트워크가 제대로 동작해!

📌 실행할 명령어 (각 노드에서 실행)

cat > /etc/sysctl.d/99-k8s-cri.conf <<EOF
net.bridge.bridge-nf-call-iptables=1
net.bridge.bridge-nf-call-ip6tables=1
net.ipv4.ip_forward=1
EOF

➡ 이 설정이 필요한 이유:

• iptables=1 → 네트워크 트래픽을 컨트롤할 수 있도록 설정
• ip6tables=1 → IPv6 네트워크도 관리할 수 있도록 설정
• ip_forward=1 → 서버가 라우터처럼 다른 노드로 패킷을 전달할 수 있도록 설정

📌 위 설정을 즉시 적용하기

sysctl --system

---

✅ 4️⃣ 추가 네트워크 모듈 로드

컨테이너 네트워크가 제대로 동작하려면 추가적인 네트워크 모듈을 활성화해야 해.

📌 실행할 명령어 (각 노드에서 실행)

modprobe overlay; modprobe br_netfilter

➡ 이 설정이 필요한 이유:

• overlay → 컨테이너의 파일 시스템을 효율적으로 관리
• br_netfilter → 브릿지 네트워크를 통해 트래픽을 관리

📌 시스템이 재부팅해도 설정이 유지되도록 하기

echo -e overlay\\\\nbr_netfilter > /etc/modules-load.d/k8s.conf

---

✅ 5️⃣ iptables 버전 맞추기

Kubernetes는 특정 iptables 버전을 요구하기 때문에 맞춰줘야 해.

📌 실행할 명령어 (각 노드에서 실행)

update-alternatives --config iptables

➡ 여러 개의 버전이 나오면 iptables-legacy를 선택해야 해!

---

✅ 6️⃣ Swap 끄기 (메모리 가상화 비활성화)

Kubernetes는 성능을 위해 swap(가상 메모리)을 사용하면 안 돼.

그래서 Swap을 꺼야 해.

📌 실행할 명령어 (각 노드에서 실행)

swapoff -a

➡ 현재 활성화된 swap을 꺼주는 명령어야.

📌 재부팅해도 swap이 다시 켜지지 않도록 설정하기

vi /etc/fstab

➡ 파일을 열어서 아래 줄을 찾아서 주석 처리해줘!

#/swap.img      none    swap    sw      0       0

➡ #을 추가하면, 재부팅해도 swap이 다시 켜지지 않아.

---

✅ 7️⃣ GRUB 설정 (부팅 시 cgroup 설정)

Kubernetes는 cgroup(리소스 관리 시스템)이 필요해.

Ubuntu 22.04에서는 기본적으로 cgroup v2가 활성화되어 있는데,

Kubernetes는 cgroup v1을 필요로 해!

그래서 부팅할 때 cgroup v1을 사용할 수 있도록 설정을 변경해야 해.

📌 실행할 명령어 (각 노드에서 실행)

vi /etc/default/grub

➡ 파일을 열어서 GRUB_CMDLINE_LINUX 설정을 아래처럼 수정해줘.

GRUB_CMDLINE_LINUX="systemd.unified_cgroup_hierarchy=0"

📌 설정을 적용하기 위해 GRUB 업데이트

bash
복사편집
update-grub

➡ 이 명령어를 실행하면, 부팅 설정이 업데이트 돼.

---

🎯 정리 (한 줄 요약)

1️⃣ 호스트 이름 변경 → master, worker01, worker02

2️⃣ containerd 설치 → 컨테이너 런타임 설치

3️⃣ 네트워크 설정 → 브릿지 네트워크 & iptables 설정

4️⃣ Swap 끄기 → Kubernetes는 swap을 사용하지 않음

5️⃣ GRUB 설정 변경 → cgroup v1 활성화

📌 이 과정은 모든 노드에서 실행해야 해! (마스터 & 워커 둘 다) 🚀