[RosieOh]

Refs #94

확인한 사실

리포지토리 시크릿이 하나도 설정돼 있지 않습니다 (gh secret list → 0개). 그래서 main 머지마다 Deploy to Production 이 첫 스텝에서 죽었습니다.

success  Test and Build
success  Security Scan
success  Build Docker Image
failure  Deploy to Production     ← Check required secrets
skipped  Deploy to Staging (Green)
success  Cleanup

#143 ~ #147 까지 다섯 번 연속 같은 모양입니다. 컨테이너를 띄우기 전에 멈추므로 운영 인스턴스를 건드리지는 않습니다. 문제는 그 반대입니다 — 아무것도 배포되지 않는데 매번 빨간불로 끝나서 그 빨간불이 정상처럼 보입니다. 그 상태가 굳으면 진짜 실패도 눈에 띄지 않습니다.

고친 것

시크릿 상태를 세 가지로 나눴습니다.

상태	결과
전부 설정됨	배포한다
하나도 없음	건너뛴다. 실패가 아니고, 잡 요약에 "운영 배포를 건너뜀" 과 설정 문서 경로가 남는다
일부만 있음	실패한다. 호스트는 있는데 키가 없는 식이면 누군가 설정하다 멈춘 것이고, 그건 조용히 건너뛸 일이 아니다

미설정 상태에서도 파이프라인은 초록불이 되고, 배포가 안 됐다는 사실은 모든 실행의 요약에 적힙니다. 빨간불을 무시하게 되는 것보다 낫다고 판단했습니다. 스테이징도 같은 규칙으로 맞췄습니다.

문서

docs/operations/deployment-secrets.md 를 추가했습니다.

• 개인키를 채팅·이슈·PR 에 붙여넣지 않는 방법: gh secret set PRODUCTION_SSH_KEY < ~/.ssh/carecode_deploy
• 배포 전용 키를 따로 만드는 이유(유출 시 그 키만 폐기)
• PRODUCTION_SSH_KNOWN_HOSTS 를 넣어야 하는 이유 — 없으면 ssh-keyscan 이 최초 접속을 그냥 믿습니다
• 서버에 미리 있어야 하는 것: docker 그룹, 스왑 2GB(1GB 인스턴스는 없으면 기동 중 OOM)
• 첫 배포에서 각 스텝이 실패할 때의 의미

솔직히 적은 한계

문서에 그대로 적어 두었습니다.

• 무중단이 아닙니다. 교체 순간에 짧은 순단이 있습니다(nginx 제어 도구가 없습니다). 깨진 이미지가 올라가는 일은 막습니다
• SSH 키 권한을 좁히지 못했습니다. 워크플로가 docker login·run·curl 을 각각 실행하므로 authorized_keys 의 command= 로 하나만 묶을 수 없습니다
• 운영 DB·Redis·메일·카카오 등 애플리케이션 환경 변수는 서버 .env 에 있고 이 문서 범위 밖입니다

이 PR 이 해결하지 못하는 것

시크릿 자체는 제가 넣을 수 없습니다. 머지 후 아래를 직접 실행하셔야 운영 배포가 시작됩니다.

gh secret set PRODUCTION_DEPLOY_HOST --body '배포서버주소'
gh secret set PRODUCTION_DEPLOY_USER --body 'ubuntu'
gh secret set PRODUCTION_HEALTH_URL  --body 'https://배포서버주소'
gh secret set PRODUCTION_SSH_KEY < ~/.ssh/carecode_deploy
ssh-keyscan -H 배포서버주소 | gh secret set PRODUCTION_SSH_KNOWN_HOSTS

넣기 전까지는 배포가 건너뛰어지고(초록불 + 요약에 안내), 넣는 순간부터 main 머지가 운영에 반영됩니다.