본문 바로가기

개발환경/인프라

Docker를 이용한 PostgreSQL 개발 환경 구축 가이드

728x90

Docker를 이용해 PostgreSQL 개발 환경을 구축하는 방법은 다음과 같다. Docker를 사용하면 PostgreSQL을 간단하게 컨테이너로 실행할 수 있다.

Docker를 이용한 PostgreSQL 개발환경 구축

Docker 설치

먼저, Docker가 설치되어 있는지 확인한다. 설치되어 있지 않다면, Docker 공식 웹사이트에서 Docker Desktop을 다운로드하고 설치한다.

Docker 이미지 다운로드

터미널을 열고 다음 명령어를 입력하여 PostgreSQL의 Docker 이미지를 다운로드한다:

docker pull postgres

PostgreSQL 컨테이너 실행

다음 명령어를 입력하여 PostgreSQL 컨테이너를 실행한다:

docker run --name postgres-container -e POSTGRES_PASSWORD=mysecretpassword -d -p 5432:5432 postgres
  • --name postgres-container: 컨테이너 이름을 postgres-container로 지정.
  • -e POSTGRES_PASSWORD=mysecretpassword: PostgreSQL 루트 사용자 비밀번호를 mysecretpassword로 설정.
  • -d: 백그라운드에서 컨테이너 실행.
  • -p 5432:5432: 호스트의 포트 5432를 컨테이너의 포트 5432에 매핑.

PostgreSQL 컨테이너 확인

다음 명령어를 입력하여 PostgreSQL 컨테이너가 실행 중인지 확인한다:

docker ps

PostgreSQL 접속

psql 클라이언트를 사용하여 PostgreSQL에 접속한다. 터미널에서 docker exec 명령어를 사용하여 PostgreSQL 쉘에 접속하는 방법은 다음과 같다:

docker exec -it postgres-container psql -U postgres

비밀번호로 앞서 설정한 mysecretpassword를 입력한다.

데이터 볼륨 추가 (선택사항)

PostgreSQL 데이터를 영구적으로 저장하려면 Docker 볼륨을 추가한다. 다음 명령어를 사용하여 PostgreSQL 컨테이너를 데이터 볼륨과 함께 실행한다:

docker run --name postgres-container -e POSTGRES_PASSWORD=mysecretpassword -d -p 5432:5432 -v ~/postgresdata:/var/lib/postgresql/data postgres
  • -v ~/postgresdata:/var/lib/postgresql/data: 호스트의 ~/postgresdata 디렉터리를 컨테이너의 /var/lib/postgresql/data 디렉터리에 매핑.

추가 환경 변수 설정 (선택사항)

PostgreSQL의 추가 환경 변수를 설정할 수 있다. 다음 명령어를 사용하여 데이터베이스를 생성하고 사용자 권한을 추가할 수 있다:

docker run --name postgres-container -e POSTGRES_PASSWORD=mysecretpassword -e POSTGRES_DB=mydatabase -e POSTGRES_USER=myuser -e POSTGRES_PASSWORD=mypassword -d -p 5432:5432 postgres
  • -e POSTGRES_DB=mydatabase: mydatabase라는 이름의 데이터베이스를 생성.
  • -e POSTGRES_USER=myuser: myuser라는 사용자 생성.
  • -e POSTGRES_PASSWORD=mypassword: myuser 사용자의 비밀번호를 mypassword로 설정.

마무리

이 단계를 따라하면 Docker를 이용해 PostgreSQL 개발 환경을 구축할 수 있다. Docker를 사용하면 컨테이너 기반의 데이터베이스 환경을 쉽게 설정하고 관리할 수 있다. 추가적으로, Docker와 PostgreSQL의 공식 문서와 튜토리얼을 참고하여 더 많은 기능을 익힐 수 있다.

반응형