Docker를 설치하거나 운영하다 보면 현재 Docker Engine이 어떤 환경에서 실행되고 있는지 확인해야 하는 경우가 많습니다. 사용 가능한 이미지와 컨테이너 개수, 스토리지 드라이버, CPU 및 메모리 정보, Docker Root Directory 등 다양한 시스템 정보를 확인해야 장애를 분석하거나 서버 상태를 점검할 수 있습니다.
이럴 때 사용하는 명령어가 바로 docker info입니다.
Docker Info는 Docker Engine의 전체 시스템 정보를 확인하는 명령어입니다. Docker 버전뿐만 아니라 컨테이너 수, 이미지 수, 스토리지 드라이버, 운영체제, CPU, 메모리, Docker Root Directory 등 운영에 필요한 거의 모든 정보를 확인할 수 있습니다.
이번 글에서는 Docker Info의 개념부터 기본 사용법, 출력 항목 설명, 주요 옵션, 실무 활용 사례까지 자세히 알아보겠습니다.
Docker Info란 무엇인가?
Docker Info는 현재 실행 중인 Docker Engine의 시스템 정보를 출력하는 명령어입니다.
Docker Engine의 상태뿐 아니라 컨테이너, 이미지, 볼륨, 네트워크, CPU, 메모리, 스토리지 드라이버 등 운영에 필요한 정보를 한 번에 확인할 수 있습니다.
Docker 환경을 점검할 때 가장 많이 사용하는 관리 명령어 중 하나입니다.
Docker Info는 언제 사용하는가?
다음과 같은 상황에서 자주 사용됩니다.
- Docker 환경 점검
- 시스템 정보 확인
- 스토리지 드라이버 확인
- Docker Root Directory 확인
- 컨테이너 및 이미지 개수 확인
- 장애 원인 분석
운영 서버의 초기 점검이나 문제 해결 시 가장 먼저 실행하는 명령어 중 하나입니다.
Docker Info 기본 사용법
가장 기본적인 명령어는 다음과 같습니다.
docker info출력 예시는 다음과 같습니다.
Containers: 8
Running: 5
Paused: 0
Stopped: 3
Images: 22
Storage Driver: overlay2
Docker Root Dir: /var/lib/docker
CPUs: 8
Total Memory: 15.4GiB현재 Docker 환경의 주요 정보를 한눈에 확인할 수 있습니다.
컨테이너 정보 확인
Docker Info에서는 현재 컨테이너 개수를 확인할 수 있습니다.
Containers: 8
Running: 5
Paused: 0
Stopped: 3현재 실행 중인 컨테이너와 중지된 컨테이너를 모두 확인할 수 있습니다.
이미지 개수 확인
현재 저장되어 있는 Docker 이미지도 확인할 수 있습니다.
Images: 22이미지가 너무 많다면 docker image prune을 이용해 정리할 수 있습니다.
Storage Driver 확인
Docker에서 사용하는 스토리지 드라이버도 확인할 수 있습니다.
Storage Driver: overlay2대부분의 Linux 환경에서는 overlay2가 사용됩니다.
운영 환경에서는 성능과 안정성을 위해 매우 중요한 항목입니다.
Docker Root Directory 확인
Docker가 데이터를 저장하는 기본 디렉터리도 확인할 수 있습니다.
Docker Root Dir: /var/lib/docker이미지, 컨테이너, 볼륨 등의 데이터가 저장되는 위치입니다.
디스크 용량이 부족할 때 반드시 확인해야 하는 정보입니다.
출력 형식 지정
필요한 정보만 출력하려면 --format 옵션을 사용할 수 있습니다.
예를 들어 Docker Root Directory만 확인하려면 다음과 같이 실행합니다.
docker info --format '{{.DockerRootDir}}'자동화 스크립트에서도 자주 사용하는 방법입니다.
Docker Info로 확인할 수 있는 주요 정보
Docker Info에서는 다음과 같은 다양한 정보를 확인할 수 있습니다.
- 컨테이너 개수
- 이미지 개수
- Storage Driver
- Docker Root Directory
- CPU 개수
- 메모리 용량
- 운영체제
- Kernel Version
- Docker Engine 상태
운영 서버를 관리할 때 반드시 확인해야 하는 핵심 정보들입니다.
Docker Info 실무 활용 예제
Docker Info는 Docker Engine의 전체 상태를 확인하는 명령어로, 운영 환경 점검과 장애 분석에서 매우 자주 사용됩니다. 컨테이너 개수, 이미지 개수, 스토리지 드라이버, Docker Root Directory 등 다양한 정보를 한 번에 확인할 수 있어 서버 관리의 첫 단계에서 실행하는 경우가 많습니다.
Docker 환경 전체 확인
가장 기본적인 사용 방법입니다.
docker info현재 Docker Engine의 전체 정보를 확인할 수 있습니다.
운영 서버 점검 시 가장 먼저 실행하는 명령어입니다.
Docker Root Directory 확인
Docker 데이터가 저장되는 위치만 확인하는 예제입니다.
docker info --format '{{.DockerRootDir}}'출력 예시입니다.
/var/lib/docker디스크 용량 부족 문제를 분석할 때 자주 사용하는 정보입니다.
Storage Driver 확인
현재 사용 중인 스토리지 드라이버를 확인합니다.
docker info --format '{{.Driver}}'출력 예시입니다.
overlay2Linux 운영 환경에서는 대부분 overlay2가 사용됩니다.
운영체제 확인
Docker Engine이 실행 중인 운영체제를 확인합니다.
docker info --format '{{.OperatingSystem}}'출력 예시입니다.
Ubuntu 24.04 LTS운영 환경 정보를 빠르게 확인할 수 있습니다.
Linux 서버 문제 해결
운영 중인 Ubuntu 서버에서 새로운 이미지를 다운로드하지 못하는 문제가 발생했습니다.
먼저 Docker 환경을 확인했습니다.
docker info확인 결과 Docker Root Directory가 저장된 디스크의 사용량이 거의 가득 차 있는 것을 확인했습니다.
Docker 데이터 저장 위치를 확인했습니다.
docker info --format '{{.DockerRootDir}}'불필요한 이미지와 중지된 컨테이너가 많이 남아 있어 디스크 공간이 부족한 상태였습니다.
다음 명령으로 정리 작업을 수행했습니다.
docker system prune이후 다시 Docker Info를 확인하여 정상적으로 공간이 확보된 것을 확인했고 새로운 이미지를 문제없이 다운로드할 수 있었습니다.
Docker Info 사용 시 주의사항
Docker Info를 사용할 때는 다음 사항을 알아두는 것이 좋습니다.
첫 번째는 Docker Engine이 실행 중이어야 한다는 점입니다.
Docker 서비스가 중지되어 있다면 정상적인 정보를 가져올 수 없습니다.
두 번째는 Docker Info에는 시스템 정보가 많이 포함되어 있습니다.
자동화 스크립트에서는 --format 옵션을 사용하여 필요한 정보만 출력하는 것이 효율적입니다.
세 번째는 Storage Driver와 Docker Root Directory는 운영 환경에서 매우 중요한 정보입니다.
장애 분석이나 성능 문제를 해결할 때 반드시 확인하는 것이 좋습니다.
네 번째는 Docker Info는 읽기 전용 명령어입니다.
현재 상태를 확인하는 용도로만 사용되며 시스템을 변경하지 않습니다.
Best Practice
Docker Info를 사용할 때는 다음과 같은 방법을 추천합니다.
- Docker 설치 후 가장 먼저 환경 정보를 확인합니다.
- 장애 발생 시 Docker Info를 통해 전체 상태를 점검합니다.
- Docker Root Directory를 정기적으로 확인합니다.
- Storage Driver가 올바르게 설정되어 있는지 확인합니다.
- 자동화 스크립트에서는
--format옵션을 적극 활용합니다. - Docker Version과 함께 사용하여 버전과 시스템 정보를 동시에 점검합니다.
이러한 방법을 적용하면 Docker 운영 환경을 더욱 안정적으로 관리할 수 있습니다.
자주 묻는 질문
Docker Info와 Docker Version의 차이는 무엇인가요?
Docker Version은 Docker Client와 Server의 버전 정보를 확인합니다.
Docker Info는 Docker Engine의 전체 시스템 환경과 설정 정보를 확인합니다.
Docker Info에서 Docker Root Directory는 무엇인가요?
Docker 이미지, 컨테이너, 볼륨 등의 데이터가 저장되는 기본 디렉터리입니다.
기본 경로는 일반적으로 /var/lib/docker입니다.
Storage Driver는 왜 중요한가요?
Storage Driver는 Docker의 파일 시스템 성능과 저장 방식을 결정합니다.
Linux에서는 대부분 overlay2를 사용하는 것이 권장됩니다.
Docker Info가 실행되지 않습니다.
Docker Engine이 실행 중인지 먼저 확인해야 합니다.
다음 명령으로 Docker 서비스를 확인할 수 있습니다.
systemctl status docker마무리
Docker Info는 Docker Engine의 전체 시스템 정보를 확인할 수 있는 매우 중요한 관리 명령어입니다.
컨테이너 개수, 이미지 개수, 스토리지 드라이버, Docker Root Directory, CPU와 메모리 정보 등을 한 번에 확인할 수 있어 운영 환경 점검과 장애 분석에 필수적으로 활용됩니다.
Docker Version, Docker System DF, Docker Inspect와 함께 활용하면 Docker 환경을 더욱 효율적으로 관리하고 문제를 빠르게 해결할 수 있습니다.