extractor 포트 8081 전환

[m-a-king]

한눈에

extractor 가 요청을 받는 포트를 8081 로 옮기는 첫 단계

• 이전: extractor 서버 입구가 8090
  • 포트 숫자가 앱 설정·nginx·배포·SG 에 따로 적힘
• 배포 작업이 infra 포트 파일에서 포트(8081)를 읽어 서버에 넘김
• 서버 입구가 새 포트 8081 과 옛 포트 8090 을 함께 받음
  • core 가 아직 8090 으로 부르므로 옛 포트 유지
• 배포 작업이 renderer 주소를 매번 계산함
  • AWS 설정값 저장소(SSM)에 적어 두던 renderer 주소는 삭제
• 머지하면 extractor 가 prod 서버에 자동 배포됨
  • 머지 전에 작업자가 SSM 의 renderer 주소를 지워야 함

Situation

extractor 포트 8081 전환

• extractor 포트 8081 전환 #108
• 추가: infra 에 서비스 포트 정본 생김 (서비스 포트 정본 추가 infra#131)
  • 숫자를 바꾸는 대신 정본을 읽도록 재작성

Task

extractor 포트 8081 전환

• extractor 포트 8081 전환 #108
• 범위: 1단계 (새 입구 열기와 정본 읽기)
  • 초과: renderer 주소를 배포가 계산

Action

포트를 정본에서 읽음

대상	이전	이후
앱 리슨 포트	설정 파일의 8090	env PORT. 없으면 로컬 기본값과 WARN
슬롯 (blue·green)	18090·18091	배포 블록이 서비스 포트에서 계산
nginx 입구	8090	정본 값·옛 8090
SG 인바운드	8090	정본 값·옛 8090 (http 데이터 소스)
배포 후 프론트 검증 주소	localhost:8090	localhost 의 정본 값

• Dockerfile 의 포트 선언 삭제
  • 원인: publish 에 영향 없음. 이미지 안에 포트 숫자를 두지 않음
• 옛 입구 8090 은 숫자 그대로 둠
  • 원인: 이전이 끝나면 지울 값. 2단계에서 삭제

renderer 주소를 배포가 계산

• 배포 작업(러너)이 infra 의 주소 계산 블록으로 renderer 서버 Name 태그의 사설 IP 를 찾고 정본 포트를 붙임
• 계산한 값을 컨테이너 env 파일 끝에 넣음
• SSM 의 같은 키는 env 파일 변환 블록의 예약 이름으로 막음
  • 결과: SSM 에 옛 주소가 남아 있으면 배포 실패

선택지	장점	비용
SSM 키를 예약으로 막음 (채택)	값이 두 곳에 있을 수 없음	머지 전에 SSM 키를 지워야 함
계산 값을 뒤에 덧붙여 덮어씀	SSM 정리와 머지 순서 무관	옛 값이 SSM 에 남아 조용히 낡음

• 덮어쓰기는 동작함
  • 결과: docker env 파일은 같은 키가 둘이면 마지막 값 하나만 넣음 (로컬 실측)
  • 기각: 정본이 둘로 남음

옛 슬롯을 알아보는 배포 인자 사용

• 배포 블록에 옛 슬롯 18090·18091 을 함께 넘김
• 원인: 서비스 중인 포트가 새 슬롯과 다르면 블록이 첫 배포로 판단
  • 서비스 중인 컨테이너가 blue 면 새 컨테이너 기동 전에 지워짐
  • 결과: 그 경우 JVM 기동 시간만큼 추출 요청 실패

Result

검증

• terraform plan: SG 1건 변경
  • 정본에서 읽은 8081 규칙 추가, 8090 유지
• 실제 서버 상태 파일(green 18091 서비스 중)로 슬롯 판정 확인
  • 결과: 새 슬롯은 blue 18081, 옛 green 은 전환 뒤 종료
• 기본 포트 경고 테스트 2건: PORT 없을 때 경고·있을 때 경고 없음

반영 순서

1. 배포 블록 옛 슬롯 포트 인식 추가 infra#129·#131 머지 (완료)
2. 이 브랜치에서 terraform apply (SG 에 8081 추가)
3. SSM 의 renderer 주소 키 삭제
4. 머지 (prod 서버 자동 배포)
5. 서버에서 8081·8090 응답, PORT 값, renderer 주소 확인
6. 머지로 자동으로 닫힌 extractor 포트 8081 전환 #108 다시 열기 (2단계 남음)

• 위험: 3번과 4번 사이에 옛 커밋을 다시 배포하면 renderer 주소가 없어 새 컨테이너가 뜨지 못함
  • 그 경우에도 서비스 중인 컨테이너가 계속 응답

후속

• core 가 정본으로 extractor 주소를 계산 (core 이슈)
• 2단계: nginx 8090·SG 8090·옛 슬롯 인자 제거

---

연관 이슈

• close extractor 포트 8081 전환 #108

[github-actions]

Discord 스레드 연동용 메타데이터입니다. discord-pr-bot 워크플로가 자동 생성하며, 수정·삭제하면 PR 과 Discord 알림 연동이 끊깁니다.

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: cdcffedd-16bd-454f-a724-3870e47ec157

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}