Docker를 이용한 PostgreSQL 설치 및 실행 가이드

Docker가 이미 설치되어 있고 실행 중이라고 가정할 때, PostgreSQL을 사용하기 위한 단계별 가이드입니다.
윈도우 기준으로 설명합니다. docker 은 다음 경로에서 다운로드 받을 수 있습니다.
Install Docker Desktop on Windows | Docker Docs

---

PostgreSQL 이미지 다운로드

먼저, Docker Hub에서 최신 버전의 PostgreSQL 이미지를 다운로드합니다.

docker pull postgres:latest

PostgreSQL 컨테이너 실행

다음 명령어를 사용하여 PostgreSQL 데이터베이스를 실행합니다. 이 명령어는 5432 포트를 열고, 'postgres’라는 이름의 컨테이너를 생성하며, 환경 변수를 통해 데이터베이스의 비밀번호를 설정합니다.

docker run -p 5432:5432 --name postgres -e POSTGRES_PASSWORD=q1w2e3r4 -d postgres

데이터베이스 접속 테스트

컨테이너가 정상적으로 실행되고 있는지 확인하기 위해 다음 명령어로 접속 테스트를 진행합니다.

docker exec -it postgres /bin/bash

PostgreSQL 접속

컨테이너 내부에서 PostgreSQL에 접속합니다.

psql -U postgres

사용자 및 데이터베이스 생성

새로운 사용자와 데이터베이스를 생성합니다. 아래 명령어는 'testuser’라는 사용자를 생성하고, 'testdb’라는 데이터베이스를 'testuser’의 소유로 만듭니다.

create user testuser with password 'password' SUPERUSER;
create database testdb owner testuser;

데이터베이스 접속

생성한 데이터베이스에 접속합니다.

\c testdb testuser

SQL 쿼리 수행

마지막으로, 데이터베이스에 있는 테이블 목록을 조회하는 SQL 쿼리를 수행하여 설치가 정상적으로 완료되었는지 확인합니다.

select * from pg_tables limit 10;

Table 생성

FastAPI 초기 실습용 테이블입니다.

CREATE SCHEMA fastapi_test;

CREATE TABLE fastapi_test.test_api (
id int4 NOT NULL,
username varchar NOT NULL,
asset int4 NULL,
CONSTRAINT test_api_pk PRIMARY KEY (id)
);

이상으로 테스트를 위한 DB 설치를 마칩니다.