이 문서는 palcar 서비스가 배포 후 정상 수렴하지 않거나, 핵심 경로가 비정상일 때 따르는 상세 대응 절차를 정리한다.
공통 초기 대응은 서비스 배포 이상 1차 대응 절차를 먼저 적용하고, 이 문서에서는 palcar에 특화된 검증 포인트를 본다.
palcar namespace 확인 권한ArgoCD 와 kubectl 확인 권한palcar.do4ai.com/api, admin.palcar.do4ai.com/api, /health 기준 URLpalcarapi Deployment, mysql StatefulSetpalcar/api, /health먼저 아래를 끝낸다.
Application 상태 확인그 다음 palcar 고유 경로와 DB 의존성을 본다.
/health 와 /api 기준을 분리해 본다sudo kubectl get deploy,sts,pods,svc,ing -n palcar
아래 질문을 먼저 분리한다.
/health 만 실패하는가/health 는 되지만 /api 흐름만 실패하는가이 분리가 되면 ingress 문제인지 앱 기능 문제인지 더 빨리 좁혀진다.
api 와 mysql 상태를 같이 본다sudo kubectl logs deploy/api -n palcar --tail=100
sudo kubectl logs statefulset/mysql -n palcar --tail=100
먼저 찾는 것은 아래다.
sudo kubectl describe ingress -n palcar palcar
sudo kubectl get svc -n palcar
아래를 확인한다.
palcar.do4ai.com, admin.palcar.do4ai.com 기준과 맞는가/api, /health path 가 기대한 backend로 연결되는가/health 기준으로 회복 여부를 먼저 본다가능하면 대표 기능보다 먼저 /health 회복 여부를 본다.
이유는 아래와 같다.
api 와 mysql 이 정상 상태로 수렴하는가/api, /health 가 끊기지 않는가아래 중 하나면 즉시 공유 또는 롤백을 검토한다.
ImagePullBackOff 또는 CrashLoopBackOff 가 계속됨/health 가 회복되지 않음Application 상태/api, /health 검증 결과api, mysql, ingress 확인 결과