데이터를 영구적으로 저장하기: 볼륨(Volume)

컨테이너의 휘발성과 데이터 보존의 필요성

컨테이너 내부의 파일 시스템은 이미지를 기반으로 임시로 생성된 것입니다. 컨테이너 내부에서 파일을 만들거나 데이터를 수정하면, 이는 일시적인 쓰기 계층(Writable Layer)에 저장됩니다.

컨테이너가 죽으면 데이터도 죽는다

컨테이너가 중지(stop)될 때는 데이터가 남아있지만, 컨테이너를 아예 삭제(rm)하면 이 임시 쓰기 계층도 통째로 날아갑니다. 만약 데이터베이스 컨테이너에 고객 정보를 저장해 두었다면, 컨테이너 재생성 시 백지 상태로 돌아가게 됩니다. 이를 방지하기 위해서는 컨테이너 내부의 특정 폴더를 내 컴퓨터(호스트)의 안전한 저장 공간과 연결해 두어야 합니다.

볼륨(Volume)과 바인드 마운트(Bind Mount)

도커에서 데이터를 영구적으로 저장하는 방법은 크게 두 가지로 나뉩니다. 두 방식 모두 개념은 "호스트 컴퓨터의 폴더를 컨테이너 안의 폴더처럼 속여서 연결하는 것"입니다. 이를 마운트(Mount)라고 부릅니다.

바인드 마운트 (Bind Mount)

내 컴퓨터(호스트)의 특정 경로(예: 내 문서 폴더, 바탕화면 등)를 직접 지정하여 컨테이너의 특정 경로와 연결하는 방식입니다.

• 주로 소스 코드를 컨테이너에 밀어넣을 때 많이 사용합니다.
• 호스트에서 코드를 수정하면, 컨테이너 안에서도 즉시 수정된 내용이 반영됩니다.
• 바이브코딩 시 프론트엔드 실시간 미리보기를 띄울 때 필수적입니다.

도커 볼륨 (Named Volume)

경로를 내 마음대로 지정하지 않고, 도커 엔진이 알아서 안전한 곳에 폴더를 만들고 관리하도록 맡기는 방식입니다.

• 이름만 지정해주면 도커가 알아서 호스트 어딘가에 데이터를 안전하게 숨겨둡니다.
• 주로 데이터베이스의 실제 데이터(Data Files)를 저장할 때 사용합니다.
• 내 컴퓨터의 파일 시스템 구조에 구애받지 않아 여러 환경에서 일관되게 동작합니다.

볼륨 마운트 설정 방법

포트 매핑에 `-p` 옵션을 썼던 것처럼, 볼륨을 연결할 때는 `-v` (volume) 옵션을 사용합니다.

`-v 호스트_경로:컨테이너_경로` 공식

이 공식 역시 콜론(:)을 기준으로 왼쪽이 호스트(또는 볼륨 이름), 오른쪽이 컨테이너 내부 경로입니다.

docker run -d \
  --name my-postgres \
  -e POSTGRES_PASSWORD=secret \
  -v my-db-data:/var/lib/postgresql/data \
  postgres:15