13일. 도커 설치하기

---

도커에 포스트그리를 설치해서 사용하려고 해 초보자도 알 수 있도록 상세하게 진행과정을 설명해줘

무료 한국어 GPT의 말:

좋아요 👍 아주 실용적인 선택이십니다!
Docker에 PostgreSQL을 설치해서 사용하는 건, 초보자라도 비교적 쉽고 안전하게 DB 환경을 구축할 수 있는 방법이에요.
지금부터 완전 초보 기준으로 “명령어 한 줄 한 줄 의미까지” 설명드릴게요.

---

🧩 준비 단계

✅ 1. Docker 설치 확인

먼저 Docker가 설치되어 있어야 합니다.
터미널(또는 명령 프롬프트)에 아래 명령어를 입력하세요.

 

docker --version

• 만약 버전이 출력되면 OK.
• 만약 “명령어를 찾을 수 없습니다” 라면 https://www.docker.com 에서 OS에 맞는 Docker Desktop을 설치하세요.
  설치 후 반드시 Docker Desktop을 실행해둡니다.

---

🐘 PostgreSQL 설치 및 실행 (Docker 방식)

✅ 2. PostgreSQL 컨테이너 실행

터미널에서 아래 명령어를 그대로 입력하세요 👇

 

docker run --name seed-postgres \ -e POSTGRES_USER=seeduser \ -e POSTGRES_PASSWORD=seedpass \ -e POSTGRES_DB=seed_db \ -p 5432:5432 \ -d postgres

🧠 명령어 해석

옵션의미

--name seed-postgres	컨테이너 이름을 ‘seed-postgres’로 지정
-e POSTGRES_USER=seeduser	DB 사용자 이름 설정
-e POSTGRES_PASSWORD=seedpass	비밀번호 설정
-e POSTGRES_DB=seed_db	초기 생성할 데이터베이스 이름
-p 5432:5432	로컬포트 5432를 컨테이너의 5432포트와 연결
-d postgres	백그라운드 실행, 공식 PostgreSQL 이미지 사용

---

✅ 3. 컨테이너가 잘 떴는지 확인

 

docker ps

결과 예시 👇

 

CONTAINER ID IMAGE COMMAND PORTS NAMES a1b2c3d4e5f6 postgres "docker-entrypoint.s…" 0.0.0.0:5432->5432/tcp seed-postgres

이렇게 나오면 정상 작동 중입니다 🚀

---

🧭 4. PostgreSQL 접속하기

방법 ① : Docker 안에서 직접 접속

 

docker exec -it seed-postgres psql -U seeduser -d seed_db

• -it : 터미널 모드로 접속
• -U seeduser : 사용자 이름
• -d seed_db : 접속할 DB 이름

접속 후 나오는 프롬프트 예시 👇

 

seed_db=#

간단한 명령어 예시

 

\dt -- 테이블 목록 보기 \q -- 종료

---

🖥️ 5. GUI로 접속하고 싶다면 (선택)

초보자분들이라면 pgAdmin 4를 추천드려요.

• 설치: https://www.pgadmin.org/download/
• 실행 후 → Add New Server 클릭
  • Host name/address: localhost
  • Port: 5432
  • Username: seeduser
  • Password: seedpass

이제 GUI 환경에서 DB를 관리할 수 있습니다 🎉

---

🔄 6. 자주 쓰는 Docker 명령어 모음

명령어설명

docker ps	실행 중인 컨테이너 확인
docker stop seed-postgres	컨테이너 정지
docker start seed-postgres	컨테이너 재시작
docker logs seed-postgres	로그 보기
docker rm -f seed-postgres	컨테이너 완전 삭제

---

📦 7. (선택) Docker Compose로 자동화하기

매번 명령어를 치기 번거롭다면, docker-compose.yml 파일을 만들어 자동화할 수 있습니다 👇

 

version: '3.1' services: postgres: image: postgres container_name: seed-postgres restart: always environment: POSTGRES_USER: seeduser POSTGRES_PASSWORD: seedpass POSTGRES_DB: seed_db ports: - "5432:5432" volumes: - ./pgdata:/var/lib/postgresql/data

그리고 아래 명령어로 실행합니다:

 

docker-compose up -d

👉 이렇게 하면 컨테이너를 껐다 켜도 데이터가 유지됩니다 (./pgdata 폴더에 저장).

---

✅ 요약

항목핵심 내용

설치 명령	docker run -e POSTGRES_USER=... -d postgres
기본 포트	5432
기본 접속	docker exec -it 컨테이너명 psql -U 사용자명 -d DB명
GUI 관리	pgAdmin 4
유지 방식	volume 마운트로 데이터 영구 저장

---

원하신다면,
👉 다음 단계로 Spring Boot + 이 PostgreSQL 도커를 연결하는 설정 (application.yml 예시 포함) 도 바로 안내해드릴 수 있습니다.

 

 

 

 

 

 

 

1- docker pull postgres:15

2-

docker run -d `
  --name pg `
  --restart unless-stopped `
  -e POSTGRES_USER=app `
  -e POSTGRES_PASSWORD=app1234 `
  -e POSTGRES_DB=appdb `
  -p 5432:5432 `
  -v pgdata:/var/lib/postgresql/data `
  --health-cmd="pg_isready -U app" `
  --health-interval=10s --health-timeout=5s --health-retries=5 `
  postgres:15

 

 

-한줄짜리 버전

 

docker run -d --name labzang --restart unless-stopped -e POSTGRES_USER=labzang -e POSTGRES_PASSWORD=labzang88 -e POSTGRES_DB=labzangdb -p 5432:5432 -v pgdata:/var/lib/postgresql/data --health-cmd="pg_isready -U app" --health-interval=10s --health-timeout=5s --health-retries=5 postgres:15

 

 

3- docker ps

 

 

4-

docker exec -it esgseed bash

*설정한 이름으로 검색

 

 

5-
root@4da107a874d3:/# psql -U labzang -d labzangdb

6- 이 화면이 나오면 db 접속까지 완성입니다.
labzangdb=#

 

---

1- 
docker pull postgres:15

2-
docker run -d --name esgseed --restart unless-stopped -e POSTGRES_USER=esgseed -e POSTGRES_PASSWORD=esgseed1234 -e POSTGRES_DB=esgseeddb -p 5432:5432 -v pgdata:/var/lib/postgresql/data --health-cmd="pg_isready -U app" --health-interval=10s --health-timeout=5s --health-retries=5 postgres:15

3-
docker ps


docker exec -it esgseed bash


5-
root@4da107a874d3:/# psql -U esgseed -d esgseeddb

6- 이 화면이 나오면 db 접속까지 완성입니다.
esgseeddb=#

 

 

---

 

 

 

 

---

만들어진 db에 test.csv 파일을 test 테이블로 저장하고 싶어. 현재 csv파일은 C:\Users\hi\Documents\project\api-server\src\main\resources\static\csv 이 경로에 있어. 이 경로에 있는 데이터를 도커안에 있는 포스트그리로 옮기고 싶어. 과정을 설명해줘.

 

 

준비: CSV 파일 복사 (이미 했으면 생략)

docker cp "C:\Users\hi\Documents\project\api-server\src\main\resources\static\csv\test.csv" esgseed:/tmp/test.csv

 

1단계: 컨테이너 bash로 들어가기

docker exec -it esgseed bash

 

2단계: psql로 DB 접속

컨테이너 안에서 입력:

psql -U esgseed -d esgseeddb

 

3단계: 테이블 삭제 (기존 테이블 있으면)

psql 안에서 입력:

 

DROP TABLE IF EXISTS test;

 

2. 테이블 다시 생성 (동일)

CREATE TABLE test (
    대상연도 TEXT,
    기관구분 TEXT,
    기관명 TEXT,
    "기준배출량(tonCO₂-eq)" NUMERIC,
    "온실가스 순 배출량(tonCO₂-eq)" NUMERIC,
    "온실가스 총 감축량(tonCO₂-eq)" NUMERIC,
    "온실가스 감축(%)" NUMERIC,
    "권장목표 달성유무(13.2%)" TEXT,
    비고 TEXT
);

3. 데이터 로드 (핵심: FORCE_NULL 추가!)

\copy test FROM '/tmp/test.csv' WITH (FORMAT csv, HEADER true, DELIMITER ',', FORCE_NULL ("기준배출량(tonCO₂-eq)", "온실가스 순 배출량(tonCO₂-eq)", "온실가스 총 감축량(tonCO₂-eq)", "온실가스 감축(%)"), ENCODING 'UTF8');

 

4. 확인

SELECT COUNT(*) FROM test;

 

예상: 12

 

SELECT * FROM test LIMIT 3;

 

"" 있던 곳이 NULL로 들어감

 

 

 

확인: 전체 데이터는 잘 들어갔나요?

sql

 

SELECT COUNT(*) FROM test;

 

 

이걸 입력하면 전체 행 수가 나와요 예: 12 → 12개 행이 다 들어간 거!

---

전체 데이터 보기 (모두 다 보기)

sql

 

SELECT * FROM test;

 

모든 행이 출력됨 (12개)

---

일부만 보기 (예: 앞 5개)

sql

 

 

SELECT * FROM test LIMIT 5;

 

 

 

 

 

 

 

 

깃허브

도커허브

 

 

**이 경로 아님! 참고하지 말것

 

 

 

 

 

 

 

5432

 

터미널에 다음같은 명령어 넣기

 

netstat -ano | findstr 5432 taskkill /PID 1552 /F