Raspberry Pi 4 클러스터 (K3s) 구축 및 운영 기록

Source

  • Depot/Infra/Rpi4 kluster 삽질.md

Summary

이 노트는 Raspberry Pi 4 및 Nano 기반 하드웨어를 활용한 K3s Kubernetes 클러스터 구축 과정의 실험적 기록입니다. Ansible을 통한 노드 자동화, Longhorn 스토리지 설정, ArgoCD/OpenFaaS/Nextcloud 등 애플리케이션 배포 시나리오를 포함합니다. 특히 NTFS 외장 HDD의 Linux 스토리지 활용 한계, 메모리 부족으로 인한 Longhorn 불안정성, 네트워크 설정(IPsec, LoadBalancer) 및 인증서 발급 등 실제 운영 중 발생한 문제점과 해결 시도(삽질)가 상세히 기록되어 있습니다.

Key Points

  • K3s 클러스터 구성: Raspberry Pi 4, Nano, Jetson 등 이종 하드웨어를 Ansible을 통해 K3s 서버/워커 노드로 통합 관리.
  • 스토리지 이슈: Longhorn 도입 시 메모리 과다 사용으로 인한 불안정성 발생. NTFS 포맷 외장 HDD의 Linux 네이티브 스토리지 활용 어려움 확인.
  • 애플리케이션 배포: ArgoCD, OpenFaaS, Nextcloud, MinIO, Registry 등 다양한 서비스를 Helm을 통해 배포 및 설정.
  • 네트워크 및 보안: 내부 DNS 설정(/etc/hosts), 자체 서명 인증서 발급, LoadBalancer IP 고정 등 네트워크 환경 구성.
  • 운영 환경: WSL2 연동, USB 디바이스 연결, SSD 교체 등 물리적 인프라 관련 참고 사항 포함.