DB/PostgreSQL

[ PostgreSQL ] Docker 이미지로 시작하기

Soso Dev 2025. 5. 1. 18:12
반응형

 

 

 

PostgreSQL을 Docker 이미지로 컨테이너에서 실행하려면, 아래와 같은 단계로 진행하시면 됩니다. Docker가 이미 설치되어 있다는 전제입니다.

1. PostgreSQL Docker 이미지 가져오기

docker pull postgres:latest

버전을 지정하고 싶으면 예: postgres:15, postgres:14-alpine 등으로 변경하세요.

2. 컨테이너 실행

docker run --name my-postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_DB=postgres \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  -d postgres

설명:

  • --name my-postgres: 컨테이너 이름
  • -e: 환경변수 설정
    • POSTGRES_USER: 사용자명
    • POSTGRES_PASSWORD: 비밀번호
    • POSTGRES_DB: 초기 생성할 DB 이름
  • -p 5432:5432: 호스트 포트와 컨테이너 포트 바인딩
  • -v pgdata:/var/lib/postgresql/data: 데이터 영속성을 위한 볼륨
  • -d: 백그라운드 실행

3. 컨테이너 접속

docker exec -it my-postgres psql -U postgres

또는 외부 툴에서 localhost:5432, 유저 postgres, 비밀번호 mysecretpassword로 접속 가능합니다.

4. 정리용 명령어

  • 컨테이너 중지: docker stop my-postgres
  • 컨테이너 삭제: docker rm my-postgres
  • 볼륨 삭제: docker volume rm pgdata

필요하다면 docker-compose.yml 방식으로도 구성해드릴 수 있습니다. 구성 방식 원하시나요?

반응형