- Published on
인터넷 경로가 전혀 없는 폐쇄망에 k3s 클러스터를 세우는 전 과정을 명령어 단위로 정리합니다. 연결망 장비에서 airgap 이미지 tarball과 k3s 바이너리를 내려받아 체크섬 매니페스트를 만들고, 반입 매체에 무엇을 담을지 정하고, 이미지를 컨테이너 런타임 디렉터리에 배치한 뒤 INSTALL_K3S_SKIP_DOWNLOAD로 설치 스크립트를 실행하는 흐름을 다룹니다. 이어서 registries.yaml로 사내 레지스트리를 미러로 붙이고 자체 서명 CA를 신뢰시키는 방법, 에이전트 조인과 임베디드 etcd HA 구성을 설명합니다. 마지막으로 폐쇄망에서 실제로 발목을 잡는 실패 모드 일곱 가지 — 번들에 없는 자체 워크로드 이미지, 도달 불가 업스트림 DNS, 기본 레지스트리 엔드포인트 폴백, tarball과 바이너리의 버전 드리프트 — 를 원인과 확인 명령까지 함께 적었습니다. 모든 명령은 k3s v1.36.2+k3s1 기준으로 확인했습니다.