[cloud ‐ TroubleShooting] Kubernetes API 서버 연결 실패 - 100-hours-a-week/5-yeosa-wiki GitHub Wiki

The connection to the server 192.168.100.3:6443 was refused

문제 요약 (Issue Summary)

• 문제 발생 일시: 2025-04-24 12:55
• 문제 발생 위치: Kubernetes Master Node
• 문제 증상: kubectl 명령어 실행 시 API 서버에 연결할 수 없음

---

현상 (Observed Symptoms)

• kubectl get nodes, kubectl get pods -A 실행 시 다음과 같은 에러 발생:

  The connection to the server 192.168.100.3:6443 was refused - did you specify the right host or port?
  
  

• crictl ps -a 명령어로 확인 시 kube-apiserver 컨테이너가 Exited 상태

• journalctl -u kubelet 로그에 cgroup 관련 오류 다수 확인

---

기대 결과 (Expected Behavior)

• kubectl 명령어가 정상 실행되어 노드 및 리소스 정보를 조회할 수 있어야 함
• API 서버가 정상적으로 실행 중이어야 함

---

시도한 해결 방법 (What I Tried)

1. kubeadm init 다시 시도 → 동일 현상
2. containerd, kubelet 상태 확인 및 재시작 → 문제 지속
3. SystemdCgroup 설정 확인 후 수정 및 재시작

---

최종 해결 방법

• containerd 기본 설정 생성 및 적용:

  sudo containerd config default | sudo tee /etc/containerd/config.toml > /dev/null
  sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
  sudo systemctl restart containerd
  sudo systemctl restart kubelet
  
  

---

관련 로그 / 명령어 결과 (Logs / Outputs)

# crictl ps -a
Exited              kube-apiserver

# journalctl -u kubelet
failed to update cgroup configuration

---