[Tip] Rancher Desktop에서 Hot Reload를 활성화 시키는 방법(feat. virtiofs)

Container 기반의 서비스를 구현하다가 보면, 코드에 변경 사항에 따라 Container 안에 있는 서비스를 즉각 재기동할 때가 있다.
만약 Rancher Desktop 파일 공유 시스템이 기본값으로 되어 있다면, 파일 변경을 10초마다 확인하기 때문에 지연이 발생하므로, virtiofs 로 바꾸어줘야 한다.

 

Rancher Desktop에서 실시간으로 컨테이너의 변경 사항을 반영(Hot-Reload)하려면, 파일 공유 시스템을 virtiofs로 변경하는 것이 좋습니다.

 

기본 설정인 reverse-sshfs는 파일 변경을 주기적으로(약 10초) 확인하는 방식이라 실시간 반영이 어렵지만, virtiofs는 훨씬 빠르고 효율적인 파일 공유를 지원하여 이 문제를 해결할 수 있습니다. 특히 macOS 환경에서 성능 향상이 큽니다.

가상 파일 시스템 설정 변경 방법 (macOS & Linux)

macOS 또는 Linux 환경에서는 다음과 같은 단계로 파일 시스템 설정을 변경할 수 있습니다. Windows의 경우 WSL2를 통해 파일이 자동으로 공유되므로 이 설정이 필요하지 않습니다.

1. Rancher Desktop 설정 열기: 메뉴 바에서 Rancher Desktop 아이콘을 클릭한 후, Preferences(또는 Settings)를 선택하세요.
2. Virtual Machine 설정으로 이동: 왼쪽 메뉴에서 Virtual Machine 탭을 선택합니다.
3. Volumes(또는 File Sharing) 설정 변경:
   • Mount Type (또는 File Sharing) 옵션을 찾으세요.
   • 기본값인 reverse-sshfs를 **virtiofs**로 변경합니다.
4. (macOS 해당) Emulation 설정 확인: Apple Silicon(M1/M2/M3)을 사용하는 macOS에서는 추가로 설정을 확인하면 성능을 최적화할 수 있습니다.
   • Virtual Machine 탭 아래의 Emulation 섹션으로 이동합니다.
   • 가상화 엔진(Virtualization Engine)을 VZ로 선택합니다.
5. Rancher Desktop 재시작: 설정 변경을 완료한 후 Rancher Desktop을 재시작하라는 메시지가 나타나면, 재시작하여 변경 사항을 적용합니다.

---

왜 virtiofs를 사용해야 하나요?

• 성능: virtiofs는 reverse-sshfs나 9p 같은 다른 마운트 방식에 비해 훨씬 뛰어난 파일 입출력(I/O) 성능을 제공합니다. 이는 대규모 프로젝트에서 특히 두드러지며, Vite와 같은 개발 서버의 Hot-Reload 속도를 크게 개선합니다.
• 파일 소유권 및 권한: virtiofs는 컨테이너 내부의 파일 소유권 문제를 해결하는 데 더 효과적입니다. reverse-sshfs를 사용할 때 발생할 수 있는 권한 불일치 문제를 방지할 수 있습니다.
• 실시간 동기화: virtiofs는 파일 시스템 이벤트를 거의 실시간으로 가상 머신에 전달하므로, 코드 변경 시 컨테이너가 즉각적으로 이를 감지하고 리로드할 수 있습니다.