FIX : 실제로 도는 배포로 교체 (라우터 API 의존 제거, SSH 키 로드)

[RosieOh]

🏫 관련 이슈

#94

시크릿 값과 서버 준비는 저장소 밖이라 이 PR 로 닫히지 않는다. 아래 "머지 후 할 일" 참고.

🏫 PR 타입

• 기능 추가
• 기능 수정
• 기능 삭제
• 버그 수정
• 의존성, 환경 변수, 빌드 관련 코드 업데이트

🏫 반영 브랜치

fix/deploy-pipeline-ssh-and-alerts -> main

🏫 변경 사항

main 에 머지해도 배포가 되지 않는다. #78, #80, #96 세 번 모두 실패했다.
시크릿 미설정이 눈에 보이는 원인이지만, 채워도 완주할 수 없는 구조였다.

1. 존재하지 않는 라우터 API 에 의존하고 있었다 ⭐

Blue/Green 전환의 마지막 단계가 HTTP 엔드포인트 두 개를 호출한다.

CURRENT_ENV=$(curl -fsS "$ROUTER_STATUS_URL" || echo "blue")curl -X POST "$ROUTER_SWITCH_URL" -H "Authorization: Bearer $ROUTER_TOKEN" ...

이 API 를 제공하는 구현이 조직 어디에도 없다.
별도 저장소의 블루/그린 도구 CareCode_Nohub_Deploy 는

requirements.txt: requests, python-dotenv, paramiko ← 웹 프레임워크 없음
docker_ops.py: subprocess.run(["docker-compose", ...]) ← 서버에서 로컬 실행

paramiko 로 서버에 붙어 nginx conf 를 고치는 CLI 다. HTTP 서버가 아니다.

더 나쁜 건 실패 지점이다. 시크릿을 다 채우면 Deploy 단계가 성공해서 서버 컨테이너를
이미 갈아치운 뒤Switch traffic 에서 멈춘다. 새 컨테이너는 떠 있는데 트래픽은
넘어가지 않은 어중간한 상태로 끝난다.

→ 검증 후 교체 방식으로 바꿨다.

새 이미지 pull
→ 예비 포트(127.0.0.1:18082)에서 먼저 기동 운영 컨테이너는 그대로
→ /actuator/health 가 UP 될 때까지 대기 (최대 200초)
└ 실패 → 컨테이너 로그 100줄 출력 후 중단 운영은 무사
→ 통과 → 교체 (여기서 짧은 순단)
→ 재확인 → 외부 URL 로 최종 확인

무중단은 잃지만 깨진 이미지가 운영에 올라가지 않는다는 성질은 유지된다.
진짜 무중단은 nginx 를 제어할 수 있을 때 되돌리면 된다.

2. SSH 개인키를 올리는 스텝이 아예 없었다 ⭐

ssh -o StrictHostKeyChecking=no ${{ secrets.PRODUCTION_DEPLOY_USER }}@...

키를 로드하는 곳이 워크플로 어디에도 없다. 시크릿을 전부 채워도 인증에서 막힌다.
키를 env 로 받아 ~/.ssh/deploy_key 에 쓰고 -i 로 지정한다.
호스트키는 *_SSH_KNOWN_HOSTS 가 있으면 고정, 없으면 ssh-keyscan + 경고.
StrictHostKeyChecking=no 는 제거했다.

3. 레지스트리 로그인이 없었다

서버가 GHCR 에서 이미지를 받으려면 로그인이 필요할 수 있다.
잡 토큰을 stdin 으로 흘려보낸다. ssh 인자로 주면 서버 프로세스 목록에 그대로 보인다.

4. 무엇이 없는지 알 수 없었다

test -n "${{ secrets.X }}" 는 실패 이유를 남기지 않는다.
로그에 PRODUCTION_HEALTH_URL: 이 공란으로 찍히는 게 전부였다.

::error::운영 배포에 필요한 시크릿이 없습니다: PRODUCTION_DEPLOY_HOST PRODUCTION_SSH_KEY

5. 배포 실패가 아무에게도 닿지 않았다

성공이든 실패든 echo "Production deployment completed" 하나였다.
잡 요약에 남기고 실패는 ::error:: 로 올린다. OPS_SLACK_WEBHOOK_URL 이 있으면 슬랙으로도 보낸다.

6. 그 밖

• 시크릿을 run: 본문에 ${{ secrets.* }} 로 직접 박아 쓰던 것을 전부 env: 로
• 전역 env 의 헬스 URL 제거 — test/scan 잡 환경에까지 실릴 이유가 없다
• 컨테이너에 --restart unless-stopped — 서버 재부팅에도 살아남는다
• 예전 carecode-blue / carecode-green 이 남아 포트를 잡고 있으면 교체가 실패하므로 함께 정리
• 외부 확인 실패는 메시지를 구분 — 서버 안에서 UP 인데 밖에서 안 보이면 프록시/보안그룹 문제다

필요한 시크릿이 8개 → 4개

이전	지금
_DEPLOY_HOST_DEPLOY_USER_HEALTH_URL_ROUTER_STATUS_URL_ROUTER_SWITCH_URL_ROUTER_TOKEN_TARGET_HEALTH_URL_TEMPLATE (+ 없던 SSH 키)	_DEPLOY_HOST_DEPLOY_USER_SSH_KEY_HEALTH_URL

🏫 테스트 결과

워크플로는 CI 에서 직접 돌려볼 수 없어 정적으로 확인했다.

YAML 파싱 OK
deploy-production -> 7 steps (기존 7, 내용 전면 교체)
deploy-staging -> 6 steps (기존 3)
run 블록 16개 + 원격 배포 스크립트 → bash -n 전부 OK

앱 코드는 건드리지 않았으므로 기존 테스트 380건은 그대로다.

🏫 머지 후 할 일 (#94)

저장소 밖이라 여기서 할 수 없다.

시크릿 4개

gh secret set PRODUCTION_DEPLOY_HOST --repo CareCode-Repo/CareCode_Interface
gh secret set PRODUCTION_DEPLOY_USER --repo CareCode-Repo/CareCode_Interface
gh secret set PRODUCTION_SSH_KEY --repo CareCode-Repo/CareCode_Interface <~/.ssh/id_ed25519
gh secret set PRODUCTION_HEALTH_URL --repo CareCode-Repo/CareCode_Interface

서버

• Docker 설치 + 배포 사용자가 docker 실행 가능
• 공개키를 서버의 ~/.ssh/authorized_keys 에 등록
• /opt/carecode/.env 존재, 그 안에 EMAIL_VERIFICATION_BASE_URL 포함 ([ Infra ] #80 머지 전 운영 전제 확인 (XFF 신뢰, 리프레시 토큰 저장소) #90)
  없으면 검증 단계에서 걸린다. 운영은 무사하지만 배포는 실패한다

준비되면 Actions 에서 workflow_dispatch → production 으로 한 번 돌려보면 된다.

🏫 To Reviewer

• 순단을 받아들일지가 핵심 판단이다. 교체 순간 몇십 초 끊긴다.
  무중단이 꼭 필요하면 라우터 API 를 만들거나([ Infra ] 운영 배포 파이프라인이 시크릿 미설정으로 계속 실패한다 #94 의 B안), CareCode_Nohub_Deploy 를
  SSH 로 호출하는 방식(C안)으로 가야 한다. 지금은 "되는 배포" 를 우선했다.
• 컨테이너 이름을 carecode 로 통일했다. 서버에 다른 이름으로 돌고 있는 게 있으면
  교체 단계의 정리 목록에 추가해야 한다.
• -p 8082:8082 로 모든 인터페이스에 바인딩하는 건 그대로 뒀다. 프록시 구성을 모르는
  상태에서 127.0.0.1: 로 좁히면 nginx 가 다른 호스트일 때 깨진다. 확인은 [ Infra ] #80 머지 전 운영 전제 확인 (XFF 신뢰, 리프레시 토큰 저장소) #90.