데이터는 다른 곳에 있는데 컨테이너가 시스템 디스크를 가득 채우는 이유는 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

로그, 캐시, 임시 파일 또는 의도치 않은 쓰기 작업이 Docker의 로컬 저장소에 남아 있으면 컨테이너가 시스템 디스크를 가득 채울 수 있습니다.

미디어 라이브러리나 데이터베이스 볼륨을 다른 풀로 옮겨도 컨테이너 이미지, 쓰기 가능 레이어, JSON 로그, BuildKit 캐시, 메타데이터, 마운트 목록에서 빠진 경로는 옮겨지지 않습니다. 외부 마운트에 실패하면 예상한 호스트 디렉터리가 비어 있을 수도 있습니다. 이 경우 명확한 오류 없이 애플리케이션이 시스템 디스크에 새 데이터를 기록할 수 있습니다.

애플리케이션 데이터 검사 전에 Docker 루트 사용량 측정하기

Docker 데이터 루트가 있는 파일시스템을 확인하고, 호스트 디렉터리 크기를 Docker의 이미지, 컨테이너, 볼륨, 빌드 캐시 사용량과 비교하세요. 삭제하기 전에 사용량을 기록해 두세요.

Cloudron 사용자는 /var/lib/docker/overlay2가 눈에 보이는 애플리케이션 데이터 전체보다 더 많은 공간을 차지하는 것을 발견했습니다. 이는 외부 라이브러리와 별도로 Docker 저장소 루트의 사용량을 측정해야 하는 이유를 보여줍니다.

시스템 디스크는 가득 찼지만 외부 풀에는 여유 공간이 있다면 컨테이너, 오버레이 레이어, 볼륨, 이미지, 빌드 캐시 중 어디에서 용량이 늘어나는지 파악하세요. 활성 데이터와 복구 가능한 데이터를 분류하기 전에는 광범위한 정리 작업을 실행하지 마세요.

제한 없이 커지는 컨테이너 JSON 로그 확인하기

로그 드라이버와 각 컨테이너 로그 파일의 크기를 확인하세요. 서비스의 주요 데이터는 다른 곳에 저장하더라도 Docker의 로컬 컨테이너 디렉터리에서 stdout과 stderr 로그가 무한정 커질 수 있습니다.

Code Maven은 기본 로그 파일이 요약에 포함되지 않은 채 계속 커져서 docker system df로는 주된 문제가 드러나지 않았던 사례를 소개합니다. 눈에 띄지 않는 공간 점유 요인은 계속 커지는 컨테이너 로그였습니다.

로그를 로테이션하거나 잘라내기 전에 로그를 폭증시키는 애플리케이션 오류를 찾아 해결하세요. 향후 컨테이너에 적용할 로그 로테이션 한도를 설정하고, 새 로그 파일이 예상 한도에서 더 이상 커지지 않는지 확인하세요.

컨테이너 쓰기 가능 레이어에 기록된 데이터 찾기

의도한 영구 저장 경로와 애플리케이션의 실제 캐시, 트랜스코딩, 다운로드, 데이터베이스, 썸네일, 백업, 임시 디렉터리를 비교하세요. 마운트되지 않은 경로에 쓰인 데이터는 시스템 디스크의 컨테이너 쓰기 가능 레이어에 남습니다.

Docker 포럼의 설명에 따르면 쓰기 작업과 변경된 이미지 파일은 쓰기 가능 레이어에 저장되고, 로테이션되지 않은 대용량 로그는 컨테이너 메타데이터에 저장됩니다. 외부 데이터 볼륨이 있어도 이 두 가지 때문에 컨테이너 하나가 로컬 공간을 거의 전부 차지할 수 있습니다.

컨테이너별 크기 보고 기능을 사용해 컨테이너 내부에서 변경된 경로 중 가장 큰 항목을 검사합니다. 유지해야 하는 데이터에만 명시적 바인드 마운트 또는 명명된 볼륨을 추가한 다음, 중요한 데이터를 백업한 후 컨테이너를 다시 생성해 더는 필요하지 않은 쓰기 가능 레이어의 콘텐츠를 제거합니다.

컨테이너 시작 시 외부 마운트가 적용되어 있었는지 확인

Docker가 컨테이너를 시작하기 전에 SSD, NAS 공유 또는 스토리지 풀이 예상한 호스트 경로에 마운트되었는지 확인합니다. 장치 식별 정보와 마운트 출력을 컨테이너에서 확인되는 디렉터리와 비교합니다.

외부 마운트가 없어도 시스템 파일 시스템에는 비어 있는 기본 디렉터리가 남아 있을 수 있습니다. 컨테이너가 이 대체 디렉터리에 정상적으로 쓸 수 있어 외부 풀에는 변화가 없는데 시스템 디스크 사용량만 증가할 수 있습니다.

데이터가 있는 대체 저장 위치 위에 스토리지를 다시 마운트하기 전에 컨테이너를 중지합니다. 숨겨진 파일을 안전하게 이동하거나 정리하고, 마운트 종속성 또는 시작 시 검사를 추가해 예상한 장치가 없으면 애플리케이션 시작을 거부합니다.

이미지 레이어, 빌드 캐시, 방치된 객체 검사

사용하지 않는 이미지, 중지된 컨테이너, 익명 볼륨, BuildKit 캐시를 검토합니다. 애플리케이션의 영구 데이터가 다른 위치에 올바르게 마운트되어 있어도 업데이트나 로컬 빌드를 자주 수행하면 여러 레이어가 누적될 수 있습니다.

Moby 프로젝트 포럼의 설명에 따르면 오버레이 마운트로 인해 디스크 용량 수치가 혼란스러울 수 있으며, 실제 파일 시스템 사용량을 신중하게 해석해야 합니다. 별도의 Home Assistant 사례에서도 시간이 지나면서 로그와 레이어로 인해 overlay2 사용량이 증가하는 현상이 나타났습니다.

현재 Compose 프로젝트와 백업에서 사용하지 않는 것으로 확인된 객체만 제거합니다. Docker 메타데이터 참조가 불일치할 수 있으므로 개별 overlay2 디렉터리를 직접 삭제하지 마세요.

증가 기준선을 사용해 수정 사항 검증

문제의 원인이 된 경로를 수정한 후, 이전에 사용량 증가를 유발했던 워크로드를 진행하면서 정기적으로 Docker 루트 사용량, 로그 크기, 컨테이너 쓰기 가능 영역 크기, 외부 풀 사용량을 기록합니다.

대규모 NAS 전송을 준비하는 ZimaSpace 워크플로는 의도한 풀에 데이터가 저장되는지 확인할 수 있는 반복 가능한 부하를 제공합니다.

시스템 디스크 사용량이 예상된 이미지 및 로그 동작에 맞게 증가하고, 영구 애플리케이션 데이터는 외부 풀에 저장되며, 외부 마운트가 없을 때 루트 파일 시스템에 조용히 쓰는 대신 안전하게 시작이 실패해야 문제가 해결된 것입니다.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.