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

🚨 도입부

Docker를 사용하다 보면 예상치 못한 다양한 에러를 만나는 경우가 많습니다. 그중에서도 ‘No space left on device’라는 에러는 특히 당혹스럽고 좌절감을 안겨주는 대표적인 문제 중 하나입니다. 이 에러는 파일 시스템이 더 이상 데이터를 저장할 수 없을 때 발생하는데, 이는 개발자들이 가장 기피하는 상황 중 하나입니다. 왜냐하면 저장 공간 부족 문제는 프로젝트의 진행을 멈추게 할 수 있기 때문입니다. 개발 환경에서 뿐만 아니라, 프로덕션 환경에서도 이 에러를 만나게 되면 서비스 중단을 초래할 수도 있습니다.

이 에러는 다음과 같은 다양한 시나리오에서 발생할 수 있습니다. 예를 들어, Docker 컨테이너를 빌드하거나 실행할 때, 이미지나 컨테이너를 삭제하지 않고 방치했을 때, 로그 파일이 너무 커졌을 때 등입니다. 이러한 상황들은 모두 저장 공간을 소모하여 ‘No space left on device’ 에러를 발생시킬 수 있습니다.

이 글에서는 이 에러를 해결하기 위한 구체적인 방법들을 제시합니다. 빠르게 해결할 수 있는 즉시 적용 방법부터, 장기적으로 안전한 표준 해결법, 그리고 복잡한 상황에서도 사용할 수 있는 고급 해결법까지 단계별로 안내합니다. 예상 해결 시간은 상황에 따라 다르지만, 일부 방법은 1분 내에 적용할 수 있을 정도로 간단합니다. 난이도 또한 초보자부터 고급 사용자까지 모두 대응할 수 있도록 구성했습니다.

🔍 에러 메시지 상세 분석

에러 메시지 ‘No space left on device’는 Linux 및 Unix 기반 시스템에서 흔히 발생하는 오류 메시지입니다. 이 메시지는 디스크 공간이 부족하여 더 이상 데이터를 기록할 수 없음을 의미합니다. Docker를 사용하는 환경에서는 여러 이유로 이 메시지가 나타날 수 있습니다. 예를 들어, Docker 이미지나 컨테이너가 너무 많아 시스템의 저장 공간을 초과했을 때, 로그 파일이 무한히 쌓여 공간을 잡아먹고 있을 때, 혹은 임시 파일들이 삭제되지 않아 누적되었을 때 등이 있습니다.

초보자들은 이 에러 메시지를 읽을 때, 메시지가 무엇을 의미하는지 혼란스러울 수 있습니다. ‘No space left on device’라는 메시지의 각 부분을 해석해보면, ‘No space’는 저장 공간이 부족하다는 의미이고, ‘left on device’는 특정 장치(일반적으로 디스크)에 남은 공간이 없다는 것을 나타냅니다. 이 메시지는 보통 시스템의 디스크 사용량을 점검하고 불필요한 파일을 삭제해야 한다는 신호입니다.

이와 유사한 에러 메시지로는 ‘Disk quota exceeded’, ‘Out of disk space’ 등이 있습니다. 이러한 메시지들 또한 저장 공간 부족과 관련이 있으며, 같은 방식으로 해결할 수 있습니다.

🧐 발생 원인 분석

이 에러가 발생하는 주요 원인은 다음과 같습니다:

• Docker 이미지 및 컨테이너가 너무 많음 – 이미지나 컨테이너를 삭제하지 않고 방치하면 시스템의 저장 공간을 소비하게 됩니다. 이는 특히 CI/CD 파이프라인에서 자주 발생할 수 있습니다.
• 로그 파일의 누적 – 로그 파일이 무한히 쌓이면서 디스크 공간을 소모할 수 있습니다. 이는 로그 관리가 제대로 이루어지지 않을 때 발생합니다.
• 임시 파일의 누적 – 빌드 과정에서 생성된 임시 파일들이 삭제되지 않고 남아 있는 경우입니다.
• 디스크 파티션 설정 문제 – 디스크 파티션이 잘못 설정되어 특정 파티션에 공간이 부족할 수 있습니다.
• 파일 시스템의 제한 설정 – 사용자나 그룹에 할당된 디스크 용량 제한(quota)이 초과되었을 때 발생할 수 있습니다.

이러한 원인들은 주로 시스템 관리 및 자원 관리의 부재에서 비롯됩니다. 특히 Docker를 사용하면서 자동화된 프로세스를 통해 이미지와 컨테이너가 지속적으로 생성되는 환경에서는 이러한 문제를 쉽게 간과할 수 있습니다. 각 원인에 대한 간단한 확인 방법으로는 Docker CLI 명령을 사용하여 현재 사용 중인 이미지와 컨테이너의 목록을 확인하고, 시스템의 디스크 사용량을 모니터링하는 방법이 있습니다.

✅ 해결 방법

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

• 불필요한 이미지 삭제 – 다음 명령어로 사용하지 않는 이미지를 삭제할 수 있습니다.

  docker image prune -a

  이 명령은 사용되지 않는 모든 이미지를 삭제합니다.

• 정지된 컨테이너 삭제 – 정지된 컨테이너를 삭제하여 공간을 확보할 수 있습니다.

  docker container prune

  이 명령어는 모든 정지된 컨테이너를 삭제합니다.

• 불필요한 볼륨 삭제 – 사용되지 않는 볼륨을 삭제하여 공간을 정리합니다.

  docker volume prune

  볼륨은 컨테이너의 데이터 저장에 사용되므로, 사용되지 않는 볼륨을 삭제하면 공간을 절약할 수 있습니다.

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

• 로그 파일 관리 – 로그 파일을 주기적으로 압축하거나 삭제하여 공간을 확보합니다. 예를 들어, 다음과 같은 방법으로 로그 파일 크기를 관리할 수 있습니다.

  docker logs --tail <number_of_lines> <container_name>

  이 명령은 지정된 컨테이너의 로그 파일의 마지막 몇 줄만을 출력하여, 불필요한 로그 정보를 제거할 수 있습니다.

• 임시 파일 정리 – 빌드 과정에서 생성된 임시 파일을 주기적으로 정리합니다. 이를 위해 Dockerfile에서 명시적으로 임시 파일을 삭제하도록 설정할 수 있습니다.

  RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

  이 명령은 패키지 설치 이후 불필요한 파일을 정리하여 최종 이미지의 크기를 줄입니다.

• 디스크 사용량 모니터링 – 정기적으로 디스크 사용량을 모니터링하여, 문제가 발생하기 전에 공간 부족을 예방합니다. 다음 명령어를 사용하여 디스크 사용량을 확인할 수 있습니다.

  df -h

  이 명령은 현재 시스템의 모든 파일 시스템에 대한 디스크 사용량을 보여줍니다.

• 디스크 파티션 조정 – 디스크 파티션을 조정하여 Docker가 사용하는 파티션에 충분한 공간을 할당합니다. 이는 시스템 관리자와 협력하여 설정할 수 있습니다.
• Docker 데몬 설정 조정 – Docker 데몬 설정 파일을 수정하여 로그 파일의 최대 크기와 보관 주기를 조정할 수 있습니다. 예를 들어, Docker의 로그 로테이션 설정을 통해 로그 파일의 크기를 제한할 수 있습니다.

  {
    "log-driver": "json-file",
    "log-opts": {
      "max-size": "10m",
      "max-file": "3"
    }
  }

  이 설정은 각 컨테이너의 로그 파일을 최대 10MB로 제한하고, 최대 3개의 로그 파일을 보관합니다.

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

• 파일 시스템 확장 – 디스크 공간이 정말로 부족한 경우, 디스크 공간을 확장하는 것이 필요할 수 있습니다. 이는 주로 클라우드 환경에서 VM의 디스크 사이즈를 조정하여 해결할 수 있습니다.
• 분산 파일 시스템 사용 – 대규모의 데이터 저장이 필요한 환경에서는 분산 파일 시스템을 사용하여 확장성을 확보할 수 있습니다.
• Docker 스웜 및 쿠버네티스 활용 – 컨테이너 오케스트레이션 도구를 활용하여 자원을 효율적으로 분배하고 관리할 수 있습니다. 이는 특히 대규모 배포에서 유용합니다.

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

이 에러가 재발하지 않도록 하기 위한 구체적인 방법은 다음과 같습니다:

• 정기적인 시스템 점검 – 디스크 사용량과 Docker 자원의 상태를 정기적으로 점검합니다.
• 자동화된 로그 관리 – 로그 파일 크기와 보관 주기를 자동으로 관리하는 스크립트를 작성하여 사용합니다.
• 불필요한 리소스 정리 – 주기적으로 사용하지 않는 이미지, 컨테이너, 볼륨을 정리합니다.
• 디스크 용량 알림 설정 – 시스템에 디스크 용량이 임계값에 도달했을 때 알림을 받을 수 있도록 설정합니다.
• 문서화 – 팀 내에서 자원 관리에 대한 가이드라인을 문서화하고 공유합니다.

🎯 마무리 및 추가 팁

이번 글에서는 Docker에서 ‘No space left on device’ 에러를 해결하는 방법을 상세히 다뤄보았습니다. 핵심 내용을 요약하자면, 첫째, 에러의 원인을 정확히 파악하고, 둘째, 각 원인에 맞는 해결 방법을 적용하며, 셋째, 에러가 재발하지 않도록 예방 조치를 취하는 것이 중요합니다. 이 외에도 Docker 관련 문제를 해결하는 데 도움이 될 수 있는 추가 리소스로는 Docker 공식 문서와 커뮤니티 포럼을 추천합니다.

개발자 여러분, 에러는 늘 발생하지만, 이를 해결해 나가는 과정에서 우리는 더 나은 개발자가 됩니다. 함께 이 문제를 극복해 나갑시다!