EC2에서 PostgreSQL을 Docker로 운영하며 겪었던 오류 해결 과정 정리

 

 

팀 프로젝트를 시작하며 환경셋팅을 하기로 했고, 우리는 EC2환경에서 Docker를 이용하여 PostgreSQL을 사용하기로 했다. 

아래에는 해당 과정을 완료하면서 까지 겪었던 작은 오류들을 정리해 보았다.

 

 

목차

1️⃣ Docker 권한 오류 (permission denied) 해결 → usermod -aG docker
2️⃣ init.sql 파일 전송 오류 (scp에서 : 빠짐) 해결
3️⃣ 테이블 생성 순서 오류 (relation does not exist) 해결
4️⃣ 함수 중복 오류 (function already exists) 해결
5️⃣ PL/pgSQL 변수 충돌 오류 (table_name is ambiguous) 해결
6️⃣ 로컬에서 EC2 PostgreSQL 접속 오류 (Connection timed out) 해결
7️⃣ AWS 보안 그룹 설정 문제 해결 (5432 포트 열기)

 

 

🔥 1. Docker로 PostgreSQL을 실행할 때 발생한 문제들

문제 1: docker: command not found

🔍 원인

• Docker가 설치되지 않아서 발생한 문제

✅ 해결 방법

 

sudo apt update sudo apt install -y docker.io docker-compose

ㄴ> 설치 후 다시 실행

 

docker --version # 정상적으로 버전이 나오면 해결됨!

 

문제 2: permission denied while trying to connect to the Docker daemon socket

🔍 원인

• Ubuntu 계정(ubuntu)이 Docker 실행 권한이 없어서 발생

✅ 해결 방법

 

sudo usermod -aG docker ubuntu su - ubuntu # 변경 사항 적용

ㄴ> 이제 docker ps가 sudo 없이도 실행 가능하다

 

🔥  init.sql을 실행하며 발생한 문제들

문제 3: init.sql이 EC2가 아니라 내 로컬 서버에 복사됨

🔍 원인

• scp 명령어에서 :를 빠뜨려서 로컬에 파일이 복사됨! 

✅ 해결 방법

올바른 scp 명령어 

scp -i your-key.pem ~/Desktop/init.sql ubuntu@<EC2_IP>:~

 

✅ EC2에서 파일 확인

ls -l ~

ㄴ init.sql이 보이면 성공!

 

문제 4: relation "p_category" does not exist 오류 발생

🔍 원인

• 테이블 생성 순서가 잘못되어 참조 관계(FK) 문제가 발생

✅ 해결 방법

✔️ 테이블 생성 순서를 조정!

1️⃣ p_category
2️⃣ p_user
3️⃣ p_restaurant
4️⃣ p_address
5️⃣ p_order
6️⃣ 나머지 테이블 (p_order_item, p_review, p_payment, p_ai_log)

✅  순서를 변경한 후 다시 init.sql 실행!

(이때, 기존 오류 난 테이블과 충돌이 일어날 수 있으니, 제대로 잘 지우고 다시 생성해야 한다.)

sudo docker exec -it postgre psql -U 28team -d 28team -f /init.sql

 

❌ 문제 5: function "update_timestamp" already exists with same argument types

🔍 원인

• 이전에 생성된 update_timestamp 함수가 남아 있어서 다시 생성할 수 없음

✅ 해결 방법

✔️ 기존 함수 삭제 후 다시 실행!

 

DROP FUNCTION IF EXISTS update_timestamp CASCADE;

✅ 그 후 다시 init.sql 실행하면 정상 작동!

 

❌ 문제 6: column reference "table_name" is ambiguous

🔍 원인

• PL/pgSQL의 변수명 table_name이 테이블 컬럼명과 충돌해서 발생

✅ 해결 방법

✔️ 변수명을 table_name → tbl_name으로 변경!

 

DO $$ DECLARE tbl_name TEXT; BEGIN FOR tbl_name IN SELECT table_name FROM information_schema.tables WHERE table_schema = 'public' AND table_type = 'BASE TABLE' LOOP EXECUTE format(' CREATE TRIGGER trigger_update_%I BEFORE UPDATE ON %I FOR EACH ROW EXECUTE FUNCTION update_timestamp();', tbl_name, tbl_name); END LOOP; END $$;

 

✅ 변수명을 바꾸니 정상적으로 실행됨

 

🔥 로컬에서 EC2 PostgreSQL 접속 중 발생한 문제

❌ 문제 7: psql: could not connect to server: Connection timed out

🔍 원인

1. PostgreSQL이 외부 접속을 허용하지 않음
2. AWS 보안 그룹에서 5432 포트가 닫혀 있음

✅ 해결 방법

✔️ PostgreSQL 설정 수정 (postgresql.conf)

 

sudo nano /etc/postgresql/14/main/postgresql.conf

 

📌 listen_addresses = '*' 로 변경

 

✔️ 접속 허용 (pg_hba.conf)

sudo nano /etc/postgresql/14/main/pg_hba.conf

맨 아래 추가

host all all 0.0.0.0/0 md5      # 해당 내용 위의 파일 안에서 수정

✅ PostgreSQL 재시작

 

sudo systemctl restart postgresql

 

✔️ AWS 보안 그룹에서 5432 포트 열기

• AWS 콘솔 → EC2 → 보안 그룹 → 인바운드 규칙 추가
• 5432 포트 허용 (0.0.0.0/0 또는 내 IP 선택)

🚀 이제 로컬에서 EC2 PostgreSQL 접속 가능! 

 

마지막으로 

psql -h <EC2_IP> -p 5432 -U 28team -d 28team

명령어로 접속 혹은 

✅ DBeaver에서 EC2 퍼블릭 IP와 설정한 username, password를 통해 로컬과 연결!

 

 

처음부터 끝까지 모든 과정을 해보면서 작은 오류 사항들이 많았지만, 문제를 해결하며 정말 많은 공부가 되었다.

또한 기존에 경험이 있으신 팀원분의 도움을 받아 큰 어려움 없이 각자 3개의 EC2 인스턴스를 생성하여 각각의 인스턴스에 데이터베이스를 구축해볼 수 있었던 것 같다.