Docker를 사용하여 로컬에서 PostgreSQL을 실행하는 방법

PostgreSQL은 오픈 소스이며 프로젝트를 지원하는 커뮤니티가 성장하는 것이 특징인 관계형 데이터베이스입니다.

라이브 애플리케이션의 데이터를 저장하는 데 사용할 수 있도록 Postgres 데이터베이스를 온라인에 저장하는 방법에는 여러 가지가 있습니다. 그러나 로컬 개발의 경우 로컬 시스템에서 Postgres 데이터베이스를 가동할 수 있습니다.

이 기사에서는 로컬 개발을 위해 Docker 컨테이너에서 PostgreSQL을 실행하는 방법을 알아봅니다.

Postgres 도커 이미지 가져오기

아시다시피 Docker를 사용하면 원하는 거의 모든 이미지를 다운로드하여 너무 많은 것을 설치하지 않고도 로컬에서(또는 원하는 곳 어디에서나) 실행할 수 있습니다.

사용 가능한 버전을 확인하는 가장 좋은 방법은 DockerHub로 이동하여 postgres를 검색하는 것입니다.



여기에서 이미지에 대한 설명, 설치 매개변수와 관련된 모든 문서 등을 찾을 수 있습니다.

Docker가 이미 설치되어 있으면 터미널을 열고 실행하십시오.

docker pull postgres

PostgreSQL의 최신 이미지를 다운로드합니다.

Docker 컨테이너 실행

이제 로컬 환경에 이미지가 있으므로 컨테이너를 가동하고 일부 매개변수를 지정할 수 있습니다.

아래에서 전체 명령을 볼 수 있습니다.

docker run 
    --name myPostgresDb 
    -p 5455:5432 
    -e POSTGRES_USER=postgresUser 
    -e POSTGRES_PASSWORD=postgresPW 
    -e POSTGRES_DB=postgresDB 
    -d 
    postgres

파트 하나하나 설명하는 시간! 🔎
docker run는 이미 다운로드한 이미지를 기반으로 새 컨테이너를 생성하고 실행하는 데 사용되는 명령입니다.
--name myPostgresDb는 생성 중인 컨테이너에 할당하는 이름입니다.
-p 5455:5432는 포트 매핑입니다. Postgres는 기본적으로 포트 5432를 노출하며 해당 포트(Docker 내에 있음)를 로컬 포트에 매핑해야 합니다. 이 경우 로컬 5455 포트는 Docker의 5432 포트에 매핑됩니다.
-e POSTGRES_USER=postgresUser , -e POSTGRES_PASSWORD=postgresPW 및 -e POSTGRES_DB=postgresDB 일부 환경 변수를 설정합니다. 물론 우리는 데이터베이스의 이름뿐만 아니라 관리 사용자의 사용자 이름과 암호를 정의하고 있습니다.
-d는 컨테이너가 분리 모드에서 실행됨을 나타냅니다. 이는 컨테이너가 백그라운드 프로세스에서 실행됨을 의미합니다.
postgres는 컨테이너를 만드는 데 사용하는 이미지의 이름입니다.

결과적으로 CLI(실행 중docker ps)에서 새로 생성된 컨테이너를 보거나 Docker Desktop과 같은 일부 UI 도구를 사용하여 볼 수 있습니다.



해당 컨테이너에 대해 정의한 환경 변수를 잊어버린 경우 아래와 같이 Docker Desktop을 사용하거나 docker exec myPostgresDb env 를 실행하여 검색할 수 있습니다.



참고: 최신 이미지 버전에서는 환경 변수가 변경될 수 있습니다. 항상 공식 문서, 특히 사용 중인 이미지 버전과 관련된 문서를 참조하세요.

PgAdmin으로 DB 탐색

이제 Postgres가 실행 중이므로 작업할 수 있습니다.

콘솔을 사용하거나 원하는 경우 UI를 사용하여 DB 작업을 수행할 수 있습니다.

저는 두 번째 접근 방식을 선호합니다(예, 알고 있습니다. 터미널을 사용하는 것처럼 멋지지는 않지만 작동합니다). 그래서 pgAdmin을 다운로드했습니다.

여기에서 실행할 때 정의한 환경 변수를 사용하여 서버에 연결할 수 있습니다docker run. 호스트 이름은 단순히 localhost라는 점을 기억하십시오.



그리고 끝났습니다! 🥳 이제 Postgres의 로컬 인스턴스로 작업하고 더 이상 필요하지 않으면 종료하고 제거할 수 있습니다.

추가 리소스

MongoDB를 로컬에서 실행하는 방법을 설명한 다른 문서에서 Docker를 이미 소개했습니다.

🔗 First steps with Docker | Code4IT

평소와 같이 최고의 리소스는 공식 웹 사이트입니다.

🔗 PostgreSQL image | DockerHub

마지막으로, 내가 Docker로 Postgres를 실행하는 방법을 알려준 Francesco Ciulla에게 특별히 언급하고 C#으로 Postgres를 쿼리하는 방법을 생각했습니다. 예, 상호 지원! 👏

🔗 Francesco Ciulla's blog

마무리

이 기사에서는 Docker를 사용하여 로컬 환경에 PostgreSQL 데이터베이스를 다운로드하고 설치하는 방법을 살펴보았습니다.

몇 가지 명령을 실행하고 입력으로 전달되는 매개변수에 주의를 기울이기만 하면 됩니다.

향후 기사에서는 C#을 사용하여 PostgreSQL 데이터베이스에서 CRUD 작업을 수행하는 방법을 알아봅니다.

(이 기사는 Code4IT에 처음 게재되었습니다.)

지금은 즐거운 코딩하세요!

🐧