No space left on device 에러 해결법 – 원인 분석부터 완벽 해결까지

🚨 도입부

Docker를 사용하다 보면 “No space left on device”라는 에러 메시지를 접하게 되는 경우가 종종 있습니다. 이러한 에러는 개발자들에게 큰 좌절감을 줄 수 있는데요, 특히 배포 준비가 완료된 상태에서 이러한 메시지를 접하면 당황스럽기 마련입니다. 이 문제는 대개 디스크 공간 부족에서 비롯되며, 시스템의 다른 부분에서도 유사한 문제를 일으킬 수 있습니다. 예를 들어, 컨테이너를 빌드하거나 실행할 때, 로그 파일이 저장될 공간이 부족할 때, 이미지가 너무 많아 저장 공간을 초과할 때 등이 있을 수 있습니다.

이 글은 Docker 사용 시 발생할 수 있는 “No space left on device” 에러의 구체적인 해결책을 제시합니다. 예상 해결 시간은 약 30분에서 1시간 정도이며, 난이도는 중급 정도로, Docker CLI 사용에 기본적인 이해가 필요합니다. 이 글을 통해 개발자들은 이 에러의 원인을 파악하고, 다양한 해결책을 적용하여 문제를 해결할 수 있을 것입니다.

🔍 에러 메시지 상세 분석

Docker를 사용하다 보면 “No space left on device”라는 에러 메시지를 보게 될 것입니다. 이 메시지는 시스템의 저장 공간이 부족할 때 발생합니다. 그러나 이 메시지는 다양한 상황에서 발생할 수 있으며, 그 변형도 여러 가지입니다. 예를 들어, “Error: No space left on device”, “Cannot write: No space left on device” 등으로 나타날 수 있습니다.

이 에러는 주로 다음과 같은 상황에서 발생합니다:

• 컨테이너를 빌드하는 도중 이미지가 너무 커서 저장 공간을 초과하는 경우
• 로그 파일이 너무 쌓여 디스크 공간을 차지하는 경우
• 볼륨이 꽉 찬 경우
• Docker 데몬이 사용하는 디스크 파티션이 가득 찬 경우
• 적절한 청소 작업이 이루어지지 않아 불필요한 데이터가 누적된 경우

이 에러 메시지의 각 부분을 해석해보면 “No space left”는 시스템의 디스크 공간이 부족하다는 것을 의미하며, “on device”는 특정 디바이스, 즉 디스크 파티션이나 파일 시스템을 지칭합니다. 초보자라면 이 에러 메시지를 보고 당황할 수 있지만, 이는 단순히 디스크 공간을 확보해야 함을 나타내는 것입니다.

비슷한 에러로는 “Disk quota exceeded”가 있습니다. 이는 설정된 디스크 할당량을 초과했음을 의미하며, “No space left on device”와는 별개로 특정 사용자나 그룹의 디스크 사용량 제한과 관련이 있습니다.

🧐 발생 원인 분석

“No space left on device” 에러의 주요 원인은 다음과 같습니다:

1. Docker 이미지의 무분별한 축적: Docker 이미지를 꾸준히 빌드하고 다운로드하다 보면 디스크 공간이 빠르게 소모됩니다. 이는 특히 자동화된 CI/CD 파이프라인에서 빈번하게 발생합니다.
2. 로그 파일의 누적: 컨테이너가 실행되면서 생성하는 로그 파일이 수백 메가바이트 또는 기가바이트 단위로 쌓일 수 있습니다. 이로 인해 디스크 공간 부족이 발생할 수 있습니다.
3. Docker 볼륨의 과도한 사용: 데이터가 지속적으로 저장되고 수정되는 환경에서는 Docker 볼륨이 빨리 가득 찹니다.
4. 디스크 파티션의 비효율적 관리: Docker 데몬이 사용하는 디스크 파티션이 너무 작게 설정되어 있을 수 있습니다. 이는 특히 Docker 설치 시 디스크 파티션을 별도로 설정하지 않은 경우에 발생할 수 있습니다.
5. 시스템 청소 작업의 부재: 불필요한 컨테이너, 이미지, 네트워크, 볼륨 등이 제거되지 않으면 디스크 공간을 차지합니다.
6. 시스템 로그 및 임시 파일의 증가: 시스템에서 생성하는 로그 파일과 임시 파일이 디스크 공간을 차지할 수 있습니다.
7. 스토리지 드라이버의 문제: Docker의 스토리지 드라이버가 비효율적으로 설정되어 있을 경우, 디스크 공간을 비효율적으로 사용할 수 있습니다.

각 경우의 확인 방법은 다음과 같습니다:

• Docker 이미지를 확인하려면 docker images 명령을 사용하여 현재 시스템에 저장된 이미지를 확인합니다.
• 로그 파일은 컨테이너의 로그를 확인하거나, du -sh /var/lib/docker/containers/* 명령으로 각 컨테이너의 로그 크기를 확인할 수 있습니다.
• 볼륨 사용량은 docker volume ls와 docker volume inspect [볼륨 이름] 명령을 통해 확인할 수 있습니다.
• 시스템의 디스크 파티션은 df -h 명령으로 확인 가능합니다.
• 불필요한 파일은 docker system df 명령을 통해 대략적인 사용량을 점검할 수 있습니다.

✅ 해결 방법

즉시 해결: 1분 내 적용 가능한 빠른 방법

1. 불필요한 컨테이너, 이미지, 네트워크, 볼륨 삭제:

   
   # 사용하지 않는 모든 컨테이너, 이미지, 네트워크, 볼륨 삭제
   $ docker system prune -a
   

   이 명령은 모든 중지된 컨테이너, 사용하지 않는 네트워크, 비사용 이미지를 삭제합니다. 주의: 중요 데이터는 백업 후 진행.

2. 로그 파일 크기 제한:

   
   # docker-compose.yml 예제
   version: '3'
   services:
     my_service:
       image: my_image
       logging:
         driver: "json-file"
         options:
           max-size: "10m"
           max-file: "3"
   

   로그 파일의 크기와 수를 제한하여 불필요한 디스크 사용을 줄입니다.

3. 가상 메모리 스왑 비활성화:

   
   # 스왑 공간 비활성화
   $ sudo swapoff -a
   

   스왑 공간을 비활성화하여 실제 디스크 사용량을 줄입니다.

표준 해결: 일반적이고 안전한 해결법

1. Docker 이미지 확인 및 삭제:

   
   # 이미지 목록 확인 및 필요 없는 이미지 삭제
   $ docker images
   $ docker rmi [이미지 ID]
   

   사용하지 않는 이미지들을 제거하여 디스크 공간을 확보합니다.

2. 불필요한 볼륨 삭제:

   
   # 사용하지 않는 볼륨 삭제
   $ docker volume prune
   

   사용하지 않는 볼륨도 정리하여 공간을 확보합니다.

3. 시스템 저장소 드라이버 설정 최적화:

   
   # /etc/docker/daemon.json 설정 예제
   {
     "storage-driver": "overlay2"
   }
   

   효율적인 스토리지 드라이버 사용으로 공간 활용을 최적화합니다.

4. Docker 시스템 사용량 확인 및 정리:

   
   # 시스템 사용량 점검 및 정리
   $ docker system df
   $ docker system prune
   

   시스템 사용량을 주기적으로 점검하고 정리하는 습관을 들입니다.

5. 파일 시스템 정리:

   
   # 불필요한 파일 시스템 정리
   $ sudo apt-get clean
   $ sudo apt-get autoremove
   

   운영체제의 불필요한 패키지를 제거하여 공간을 확보합니다.

고급 해결: 복잡한 상황을 위한 해결법

1. Docker 데몬의 데이터 디렉토리 변경:

   
   # /etc/docker/daemon.json 설정 예제
   {
     "data-root": "/new/path/to/docker"
   }
   

   데이터 디렉토리를 변경하여 더 넓은 공간에 Docker 데이터를 저장합니다.

2. 로컬 저장소 확장:

   
   # 디스크 파티션 확장
   $ sudo lvextend -L +10G /dev/ubuntu-vg/ubuntu-lv
   $ sudo resize2fs /dev/ubuntu-vg/ubuntu-lv
   

   필요 시 디스크 파티션을 확장하여 더 많은 저장소를 확보합니다.

3. 전체 시스템 백업 및 복원:

   
   # 시스템 백업
   $ sudo rsync -aAXv --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost+found"} / /backup
   
   # 시스템 복원
   $ sudo rsync -aAXv /backup /
   

   중요 시스템 데이터를 백업하고 복원하여 데이터 손실을 방지합니다.

각 해결 방법의 장단점은 다음과 같습니다. 빠른 방법은 즉시 효과적이지만, 장기적으로는 주기적인 관리가 필요합니다. 표준 방법은 안정적이며 Docker 사용 환경에 적합합니다. 고급 방법은 많은 저장소가 필요한 상황에서 유용하지만, 설정이 복잡할 수 있습니다.

해결 후에는 df -h를 사용하여 디스크 공간을 확인하여 문제가 해결되었는지 검증합니다.

🛡️ 예방법 및 베스트 프랙티스

“No space left on device” 에러를 예방하려면 다음과 같은 방법을 고려해야 합니다:

• 주기적인 Docker 시스템 청소: docker system prune을 주기적으로 실행하여 불필요한 데이터를 정리합니다.
• 로그 파일 관리: 로그 파일의 크기와 수를 제한하는 설정을 통해 디스크 공간을 절약합니다.
• 이미지 및 컨테이너 관리 전략 수립: 이미지 버전을 정리하고, 사용하지 않는 컨테이너는 삭제합니다.
• 디스크 모니터링 도구 사용: Grafana, Prometheus와 같은 도구를 사용하여 디스크 사용량을 모니터링합니다.
• 효율적인 스토리지 드라이버 사용: overlay2 등의 드라이버를 사용하여 디스크 사용 효율을 높입니다.

팀 개발 시에는 이러한 가이드라인을 공유하고, 문서화하여 일관된 관리가 가능하도록 합니다.

🎯 마무리 및 추가 팁

이 글에서는 Docker의 “No space left on device” 에러의 원인과 해결 방법을 다루었습니다. 핵심은 주기적인 디스크 공간 관리, 로그 파일의 효율적 관리, 그리고 Docker 시스템 자원의 주기적인 점검입니다. 비슷한 에러로는 “Disk quota exceeded”가 있으며, 이 에러에 대한 자세한 해결법은 추가 자료를 참조하시기 바랍니다.

추가 학습 리소스로는 Docker 공식 문서, Docker 커뮤니티 포럼 등이 있으며, 이를 통해 더욱 심도 깊은 이해를 얻을 수 있습니다. 이 글이 여러분의 문제 해결에 도움이 되기를 바라며, 계속해서 Docker 환경에서 성공적인 개발을 이어가시길 바랍니다!