[실습] 01. Docker기반 NGINX + Master/Worker 구조

NGINX 요약

01. Docker기반 NGINX + Master/Worker 구성

대상 운영/배포 실무 형태 요약 노트 키워드 Docker · NGINX

구성도

핵심 정리

1) 가장 먼저 잡아야 할 흐름

• 컨테이너를 띄운다 → 응답이 나오는지 확인한다 → 설정 파일을 마운트한다 → 무중단으로 reload 한다
• 운영에서는 ‘설정 변경 → reload’가 가장 잦기 때문에, nginx -t와 nginx -s reload 습관이 중요합니다.

2) NGINX 프로세스 구조(헷갈리기 쉬운 포인트)

• Master: 설정 읽기, 소켓 오픈, Worker 생성/관리, 시그널 처리(리로드/종료 등)
• Worker: 실제 클라이언트 연결을 받아서 요청을 처리하는 주체
• 무중단 리로드: 새 설정으로 새 Worker를 띄우고, 기존 Worker는 처리 중인 연결을 정리한 뒤 종료하는 방식

# 문법 검사(추천)
nginx -t

# 전체 설정 출력(인클루드 포함)
nginx -T

# 무중단 리로드
nginx -s reload

3) 최소 예시(Docker)

영상은 Docker 기반으로 진행되므로, 아래 정도만 알고 시작하셔도 따라가기 어렵지 않습니다.

docker pull nginx:stable
docker run --name web -p 8080:80 nginx:stable
curl -I http://localhost:8080

운영 팁

• 컨테이너 환경에서는 nginx.conf를 직접 수정하기보다 템플릿/볼륨 마운트로 관리하면 롤백이 쉬워집니다.
• 리로드 전에는 반드시 nginx -t로 문법을 확인하시는 것을 권장드립니다.

참고 링크

헷갈리기 쉬운 개념/지시어는 공식 문서와 RFC/레퍼런스를 함께 보시면 이해가 빨라집니다.

• NGINX 공식 문서: 시작하기
• NGINX signals(-s reload 등) 설명
• Docker 공식 문서(Compose 개요)