tdc114plus 배포 검토 회의 1페이지 요약

작성일: 2026-07-20 | 용도: 회의 현장에서 바로 보고 설명하기 위한 A4 1장 요약본

권장방안 및 결론

항목 권장방안 판단 이유
앱 배포 순서 staging -> 내부 검증 -> production 로그인, 세션, 조직도, 프로필 사진까지 함께 검증해야 하므로 production 직행은 위험
최종 배포 대상 tdc114plus 앱 + tdc114plus-auth 서버 실제 운영 구성의 핵심 두 축이며, baron-sso-tdc114plus-api는 로컬 개발/검증용
중계서버 형태 Baron SSO에 흡수하지 않는 독립 서비스 앱 전용 인증/중계 책임이 있어 저장소, 배포, 장애 대응 경계를 분리하는 편이 안전
배치 위치 기존 운영 인프라 안의 독립 실행 구조 처음부터 물리 서버를 새로 만들지 않아도 서비스/설정/배포를 분리해 시작 가능
중계서버 주소 114-auth.hmac.kr 앱과 운영자 모두 역할을 이해하기 쉽고, 도메인/인증서/라우팅 관리가 명확
배포 전략 블루/그린 1순위 로그인/세션 장애 시 직전 버전으로 빠르게 rollback하기 가장 쉬움

이번 회의 핵심

  1. 신규앱 tdc114plus를 어떤 순서로 배포할 것인가
  2. tdc114plus-auth 중계서버를 어디에 둘 것인가
  3. tdc114plus-auth 서버 배포 방식은 무엇으로 할 것인가

왜 staging이 먼저인가

  • 신규앱은 단순 화면 앱이 아니라 로그인, 승인 확인, 앱 세션, 직원검색/조직도, 프로필 사진 프록시가 함께 묶여 있음
  • production에서 처음 검증하면 장애가 바로 운영 이슈가 됨
  • 따라서 Baron SSO 원본 staging 연동을 먼저 안정화한 뒤 production으로 승격하는 구조가 안전

tdc114plus-auth가 중요한 이유

  • 앱 뒤에서 로그인과 중계를 처리하는 핵심 서버
  • Baron SSO와 통신, 승인 결과 확인, 앱 세션 발급, 조직도/직원 데이터 중계, 프로필 사진 프록시 처리 담당
  • 이 서버가 깨지면 앱 로그인과 핵심 조회 기능이 함께 영향을 받음

같은 서버에 둔다는 말의 의미

  • 저장소 분리: Git 저장소를 따로 관리
  • 서비스 분리: 실행 프로그램을 따로 운영
  • 물리 서버 분리: 아예 다른 VM/장비에 배치

현재 권장 방향

  • tdc114plus: 별도 저장소
  • tdc114plus-auth: 별도 저장소
  • Baron SSO: 기존 저장소 유지

다만 tdc114plus-auth는 처음부터 별도 물리 서버를 만들지 않아도 되고, 기존 운영 인프라 또는 Baron SSO 인프라 안에서 독립 프로세스/독립 컨테이너/독립 설정으로 시작할 수 있다.

중계서버 배치 권장안

  • 주소: 114-auth.hmac.kr
  • 운영 형태: tdc114plus-auth 독립 서비스
  • 배치 위치: 기존 운영 서버 또는 Baron SSO 인프라 안의 독립 실행 단위
  • 장점: 주소 명확, 서비스 경계 유지, 초기 인프라 부담 작음, 나중에 별도 서버 분리 쉬움

tdc114plus-auth 배포 절차 요약

  1. Gitea에서 배포할 버전 또는 태그 확정
  2. staging 서버에 먼저 배포
  3. /health, 로그인, link/init, link/poll, 조직도, 프로필 사진 확인
  4. Android 실기기에서 실제 로그인과 조회 흐름 검증
  5. 문제 없으면 production 반영
  6. 배포 직후 로그와 장애 여부 집중 확인, 문제 시 즉시 rollback

왜 블루/그린인가

  • 기존 운영 서버를 바로 덮어쓰지 않고 새 버전을 옆에 준비한 뒤 전환
  • rollback이 빠름
  • 로그인/세션 장애 시 즉시 이전 버전으로 되돌리기 쉬움
  • 초보자도 구조를 이해하기 쉬움

회의에서 꼭 확인할 질문

  1. tdc114plus-auth를 올릴 기존 운영 인프라가 있는가
  2. 114-auth.hmac.kr 같은 전용 서브도메인을 사용할 수 있는가
  3. staging 도메인과 production 도메인을 나눌 수 있는가
  4. HTTPS 인증서와 secret 주입은 누가 담당하는가
  5. 블루/그린을 할 수 있을 정도의 서버 자원이 있는가
  6. 장애 시 rollback 책임자와 절차는 어떻게 되는가

회의용 최종 제안 문안

신규앱은 production 직행보다 staging 연동 안정화 후 production으로 승격하는 구조가 안전하다. 최종 배포 대상은 tdc114plus 앱과 tdc114plus-auth 서버이며, baron-sso-tdc114plus-api는 로컬 개발용으로 보고 최종 배포 필수 구성에서는 제외하는 것이 맞다. tdc114plus-auth는 Baron SSO에 흡수하지 않고 독립 서비스로 유지하되, 초기에는 114-auth.hmac.kr 같은 전용 서브도메인과 기존 운영 인프라 안의 독립 실행 구조로 시작하는 것이 현실적이다. 서버 배포 방식은 현재 단계에서는 rollback이 빠른 블루/그린을 1순위로 제안한다.