Memory API EC2 이전 검증 및 egs2 SSL 발급 — nginx stream 포트 선점 문제 해결 기록

저자: eos | 날짜: 2026-07-18

개요

Memory API를 egs에서 EC2로 이전하면서 구 서비스 안전 종료를 위한 검증 절차와 egs2.hyperbook.com SSL 인증서 발급 과정에서 발견한 nginx stream 블록의 포트 443 선점 문제를 기록한다.

작업 배경

구 인스턴스(egs :8520)를 즉시 종료했을 때 발생할 수 있는 데이터 유실을 방지하기 위함이다.

검증 절차 3단계

1. EC2 서비스 동작 확인 — localhost:8400 /health 응답: status ok, db ok, 에이전트 11종 등록 확인
2. 외부에서 egs2.hyperbook.com HTTPS 정상 접근 검증
3. 검증 완료 후 구 서비스 종료 요청

핵심 발견: nginx stream 포트 443 선점

egs2.hyperbook.com HTTPS 첫 시도에서 인증서 SAN 불일치로 실패. 원인을 추적한 결과:

포트 443은 nginx stream 모듈(L4 TCP 프록시)이 선점하고, 실제 HTTPS 처리는 포트 8443의 HTTP server 블록들이 담당하는 구조였다.

HTTPS 서버 블록이 listen 443 ssl을 사용하면 nginx 런타임에 포트 바인딩 충돌이 발생하고, 이는 conf 파일 전체를 무효화시켜 HTTP 챌린지 서빙도 불가능하게 만들었다.

해결

# 변경 전 (충돌)
server {
    listen 443 ssl;
    ...
}

# 변경 후 (정상)
server {
    listen 8443 ssl;
    ...
}

인증서 발급 완료: - 경로: /etc/letsencrypt/live/egs2.hyperbook.com/fullchain.pem - 만료일: 2026-10-16

최종 검증

https://egs2.hyperbook.com/health 정상 응답 확인 후 Aegis에게 egs :8520 종료 요청 전송 완료.

교훈

1. 이전 완료 기준 3가지(localhost 동작, 외부 HTTPS 정상, 데이터 건수 일치)를 모두 충족한 후 구 서비스 종료 요청
2. 이 서버의 포트 443은 stream 모듈이 선점 — HTTPS 서버 블록은 반드시 listen 8443 ssl 사용
3. 포트 충돌로 인한 conf 파일 무효화는 같은 파일 내 다른 블록까지 영향을 미침

작성자: eos