Docker - 개요, 구조, 설치, 기본 명령어

오늘은 개발부터 운영까지, 애플리케이션을 어디서나 동일하게 실행할 수 있도록 도와주는 혁신적인 기술인 도커(Docker)에 대해 정리해 보겠습니다.

1. 도커(Docker) 개요

도커는 애플리케이션을 컨테이너(Container)라는 표준화된 유닛으로 패키징하는 소프트웨어입니다. 이 컨테이너 기술을 통해 우리는 가상화된 운영체제 환경을 손쉽게 구축할 수 있습니다.

• 독립된 격리 환경: 프로그램(S/W)과 데이터를 각각 독립된 환경에 격리시킵니다.
• 상호 간섭 방지: 환경이 철저히 격리되어 있어, 여러 컨테이너를 띄워도 서로 간섭이 발생하지 않습니다.
• 업데이트 이슈 해결: 의존성 충돌이나 업데이트 문제가 발생할 걱정이 없습니다. 문제가 생기면 격리된 환경을 제공하는 '컨테이너' 단위로만 교체하면 끝납니다.

도커 데스크톱 설치 링크:

Docker Desktop Windows 설치 공식 문서

Install Docker Desktop on Windows

---

2. 도커의 구조

도커 시스템이 하드웨어 위에서 어떻게 동작하는지 계층별로 살펴보겠습니다.

계층	설명
컨테이너 (Containers)	Nginx(웹서버), FastAPI(WAS), MySQL(DB) 및 데이터가 세팅된 독립적이고 격리된 실행 공간입니다.
이미지 (Images)	컨테이너를 생성하기 위한 '틀'입니다. Docker Hub나 AWS ECR 등에서 다운로드하여 인스턴스로 작동시킵니다.
도커 엔진 (Docker Engine)	컨테이너를 생성하고 관리하는 핵심 S/W (리눅스 기반 환경 제공)입니다.
운영체제 (OS)	Windows, macOS, Linux (AWS Ubuntu 이미지 등) 호스트 운영체제입니다.
하드웨어 (Hardware)	물리적 장비(노트북) 또는 클라우드 인프라(AWS EC2 인스턴스 등)의 CPU, RAM, SSD 등입니다.

docker 구조

---

3. 설치 및 실행 확인

설치 과정 자체는 매우 직관적이며 큰 특이사항은 없습니다. 다만, 윈도우 환경에서는 반드시 WSL(Windows Subsystem for Linux)이 설치되어 있어야 도커가 리눅스 커널을 활용하여 정상 작동합니다.

(도커 설치하시고 윈도우 재시작하시는 것을 추천드립니다! 그럼 WSL 설치하라고 cmd 창이 열리더라고요..)

 

실행 확인 방법:

설치 후 CMD(명령 프롬프트)나 PowerShell을 열고 아래 명령어를 입력하여 CLI 모드가 정상 작동하는지 확인합니다.

docker

명령어가 정상적으로 인식된다면 Docker Client가 가동된 것입니다. 도커 데스크톱 앱에서의 로그인은 선택 사항(Skip 가능)이지만, 이미지를 자주 다운로드하거나 관리한다면 로그인을 진행하는 것이 좋습니다.

---

4. Docker CLI (Command Line Interface) 기본 문법

도커는 주로 터미널에서 명령어를 입력해 제어합니다. 공식 명령어 레퍼런스는 아래 링크에서 확인할 수 있습니다.

Docker CLI 공식 문서

docker

 

구분	설명 및 예시
기본 문법	docker [OPTIONS] COMMAND
1차 명령어 (Management)	큰 범주의 대상 (예: container, image, volume, network)
2차 명령어 (Common)	실제 수행할 액션 (예: run, ls, stop, rm)
명령어 축약 (예외)	2차 명령어가 특정 1차 명령어에 종속적일 경우 1차를 생략할 수 있습니다. (예: docker container run ➔ docker run)

---

5. 도커 필수 주요 명령어

자주 사용하는 핵심 명령어와 실제 출력 예시를 살펴보겠습니다.

주요 명령어

docker version

도커 데스크톱을 설치하면 서버(Server)와 클라이언트(Client)가 모두 설치됩니다.

표면적으로는 윈도우/맥을 사용 중이더라도, WSL 등을 통해 내부적으로는 리눅스 기반으로 운영된다는 점을 확인할 수 있습니다.

Client:
 Version:           29.6.1
 API version:       1.55
 Go version:        go1.26.4
 Git commit:        8900f1d
 Built:             Fri Jun 26 11:43:32 2026
 OS/Arch:           windows/amd64
 Context:           desktop-linux

Server: Docker Desktop 4.82.0 (233772)
 Engine:
  Version:          29.6.1
  API version:      1.55 (minimum version 1.40)
  Go version:       go1.26.4
  Git commit:       8ec5ab3
  Built:            Fri Jun 26 11:41:04 2026
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.2.5
  GitCommit:        e53c7c1516c3b2bff98eb76f1f4117477e6f4e66
 runc:
  Version:          1.3.6
  GitCommit:        v1.3.6-0-g491b69ba
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

docker system info

도커의 실행 환경, 현재 구동 중인 컨테이너 현황, 보유한 이미지 개수 등 시스템의 전반적인 상태를 제공합니다.

시스템 리소스가 어떻게 할당되어 있는지 파악할 때 유용합니다.

Client:
 Version:    29.6.1
 Context:    desktop-linux
 Debug Mode: false
 Plugins:
  agent: Docker AI Agent Runner (Docker Inc.)
    Version:  v1.98.0
    Path:     C:\Program Files\Docker\cli-plugins\docker-agent.exe
  # ... (기타 플러그인 생략) ...

Server:
 Containers: 0  <-- 현재 생성된 컨테이너 수
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 0      <-- 다운로드된 이미지 수
 Server Version: 29.6.1
 Storage Driver: overlayfs
  driver-type: io.containerd.snapshotter.v1
 Logging Driver: json-file
 Cgroup Driver: cgroupfs
 Cgroup Version: 2
 # ... (중략) ...
 Kernel Version: 6.6.87.2-microsoft-standard-WSL2
 Operating System: Docker Desktop
 OSType: linux
 Architecture: x86_64
 CPUs: 20
 Total Memory: 15.46GiB
 Name: docker-desktop
 # ...

docker system df

현재 도커가 차지하고 있는 디스크 공간(이미지, 컨테이너, 볼륨, 빌드 캐시 등)을 요약해서 보여줍니다.

추후 AWS EC2 등에 도커를 올릴 때, 서버 스토리지 스펙을 조절하거나 불필요한 더미 데이터를 청소할 때 반드시 체크해야 하는 명령어입니다.

TYPE            TOTAL     ACTIVE    SIZE      RECLAIMABLE
Images          0         0         0B        0B
Containers      0         0         0B        0B
Local Volumes   0         0         0B        0B
Build Cache     0         0         0B        0B

 

상세 조회 팁: 더 자세한 항목별 용량을 보고 싶다면 -v (verbose) 옵션을 추가하여 docker system df -v를 입력하면 됩니다. 컨테이너 배포와 삭제를 반복하다 보면 공간이 금방 차게 되므로 정기적인 용량 관리를 권장합니다.