Nginx: reload 중 연결 종료 동작을 검증하는 법

검증 범위

reload 중 연결 종료에서 유지해야 할 동작과 바뀌어야 할 결과를 나눠 적습니다. 정상 reload는 기존 worker가 연결을 마칠 기회를 주지만 worker shutdown timeout과 장기 연결 정책에 따라 강제 종료될 수 있습니다.

대표·경계·실패 조건

source, build artifact, configuration과 DB schema 버전을 나눠 어느 조합에서 실패했는지 확인합니다. process가 다시 떴다는 사실은 readiness나 핵심 기능 정상의 증거가 아닙니다.

조건	확인할 내용
대표 사례	자주 쓰는 조건에서 기대 결과가 나오는가
경계	값이나 동작이 바뀌는 지점이 안전한가
실패	오류가 정해진 방식으로 드러나고 중간 상태가 남지 않는가
반복	다시 실행해도 결과가 예측 가능한가

완료 판단

수정 전 실패 사례는 사라지고 기존 정상 사례는 유지돼야 합니다. 설정 문법 검사 후 reload하고 4xx/5xx, upstream connect/header/response time과 active connection을 비교한다. 새·구 버전이 공존하는 rolling deployment, 취소, 재시도와 rollback을 운영과 같은 순서로 검증합니다. 한 번의 가장 좋은 결과나 화면 한 장으로 완료를 선언하지 않습니다. 실패 입력과 기대 결과를 자동 test나 실행 가능한 점검으로 남깁니다.

공식 문서와 적용 범위

• Nginx Documentation (새 창에서 열림)

문서의 기본값과 동작은 version에 따라 달라질 수 있습니다. 현재 version, 실제 적용 설정, 자원 제한과 운영 환경에서 다시 확인합니다.