DOCS/journey/plans/260309_51123_구IP하드코딩_실행경로제거_계획.md

tags

tags
infra 51123 ip ssot runtime plans

51123 구 IP 하드코딩 실행 경로 제거 계획

상태: 완료 (2026-03-10 기준)

상위 원칙

• Infra Project Identity
• Core Infrastructure Principles
• Operational Guardrails
• 공통 작성 원칙: 0_VALUE Writing Principles

관련 문서

• Infra Journey
• 51123 구 IP 하드코딩과 런타임 SSOT 불일치 이슈
• 51123 구 IP 하드코딩 실행 경로와 런타임 SSOT 불일치 리서치
• 23서버 워크스페이스 SSOT 구조전환 계획
• 51123 구IP active runtime 제거 1차
• 24서버 robeing runtime workspace-config 단일화

목표

• 51123 주소 기준을 /home/admin/workspace-config/runtime.env의 HOST_51123=192.168.0.100으로 단일화한다.
• active runtime에서 192.168.219.45를 실제로 사용하는 경로를 제거한다.
• 코드 기본값과 compose fallback에서 과거 IP를 제거해, 재빌드와 복구 시에도 구 IP가 다시 살아나지 않게 한다.

변경 대상 범위

1. 즉시 교정 대상(active runtime)

• robeing/skill-email/docker-compose.yml
• robeing/skill-email/.env
• robeing/skill-calendar/docker-compose.yml
• robeing/skill-calendar/.env
• fluent-bit/data-prepper/pipelines.yaml

2. 같은 작업 단위에서 함께 제거할 fallback/code default

• auth-server/app/providers/gmail_passport.py
• robeing/skill-calendar/services/google_calendar_service.py
• robeing/admin-dashboard/backend/services/system_service.py
• robeing-gateway/docker-compose.yml

3. 같은 작업 단위에서 함께 고정할 공용 env 경로

• workspace-config만 공용 SSOT로 사용한다.
• /home/admin/infra-config/*.env 참조는 실행 경로에서 허용하지 않는다.

실행 원칙

• 과거 IP 192.168.219.45를 새 값과 병행 허용하지 않는다.
• "안 되면 예전 IP로 재시도" 같은 폴백을 추가하지 않는다.
• IP literal 대신 의미 있는 환경변수 또는 현재 SSOT 값만 참조하게 바꾼다.
• 문서 수정만으로 닫지 않고, 재빌드와 실연결 검증까지 완료해야 닫는다.

단계별 계획

1. active runtime 교정

• skill-email
  • .env의 AUTH_SERVER_URL, DATABASE_URL, POSTGRES_CONNECTION_STRING에서 과거 IP를 제거한다.
  • docker-compose.yml fallback도 같은 작업 단위에서 교체한다.
  • 컨테이너 내부 AUTH_SERVER_URL, DATABASE_URL에 과거 IP가 남지 않게 한다.
• skill-calendar
  • .env의 DATABASE_URL에서 과거 IP를 제거한다.
  • docker-compose.yml fallback과 services/google_calendar_service.py code default를 같은 작업 단위에서 교체한다.
  • 컨테이너 내부 env에 과거 IP가 남지 않게 한다.
• data-prepper
  • sink host를 192.168.0.100:9200 또는 동일 의미의 SSOT 값으로 교체한다.
  • 재시작 후 timeout 로그가 사라지는지 확인한다.

2. fallback과 code default 제거

• auth-server/app/providers/gmail_passport.py
  • DATABASE_URL 기본값에서 과거 IP literal을 제거한다.
• robeing/skill-calendar/services/google_calendar_service.py
  • 코드 기본값을 SSOT 기준으로 교체하거나, env 미주입 시 즉시 실패하도록 정리한다.
• robeing/admin-dashboard/backend/services/system_service.py
  • 51124에서 51123으로 접근할 때 과거 IP 폴백을 제거하고 현재 기준값만 사용하게 정리한다.
• robeing-gateway/docker-compose.yml
  • env_file 경로를 /home/admin/workspace-config/runtime.env, /home/admin/workspace-config/secrets.env만 보게 교체한다.

3. 재배포와 재검증

• 변경 서비스별로 docker compose down && docker compose up -d --build로 재기동한다.
• 컨테이너 env, TCP 연결, 헬스체크, 로그를 다시 확인한다.
• 192.168.219.45로 향하는 연결 시도가 남지 않았는지 재검색한다.

검증 계획

1. 설정 검증

• 실행 경로 파일 검색에서 192.168.219.45가 0건인지 확인한다.
• .env와 docker compose config에서 과거 IP가 0건인지 확인한다.
• 컨테이너 env에서 AUTH_SERVER_URL, DATABASE_URL, OpenSearch host 관련 값에 과거 IP가 없는지 확인한다.

2. 연결 검증

• 23 서버 호스트에서 다음 경로가 모두 192.168.0.100 기준으로 열리는지 확인한다.
  • 9000 auth-server
  • 5432 PostgreSQL
  • 9200 OpenSearch
• 컨테이너 내부에서도 같은 경로를 다시 확인한다.

3. 로그 검증

• data-prepper에서 Timeout connecting to [/192.168.219.45:9200]가 사라졌는지 확인한다.
• skill-email, skill-calendar에서 과거 IP 대상 연결 실패 로그가 없는지 확인한다.

4. 완료 검증

• 24 서버에서 23 서버 DB/인증/모니터 경로를 재확인해 과거 IP 재참조가 없는지 확인한다.
• 필요 시 admin-dashboard 재배포 전 코드 fallback 제거 상태를 별도 점검한다.

완료 판단 기준

• active runtime 컨테이너 skill-email, skill-calendar, data-prepper가 더 이상 192.168.219.45를 사용하지 않는다.
• code default와 compose fallback에서 과거 IP literal이 제거된다.
• 실행 경로에서 /home/admin/infra-config/*.env 참조가 0건이고, 공용 env는 workspace-config만 사용한다.
• TCP 연결, 헬스체크, 로그 재검증에서 과거 IP timeout이 재현되지 않는다.
• 51123 주소 기준은 192.168.0.100 하나로만 설명 가능하다.

상위 원칙/근거 문서 연결

• Infra Project Identity
• Core Infrastructure Principles
• Operational Guardrails