Supplement · Nginx

Graceful reload và operations

Khi reload (HUP), master parse config mới, mở log/listener/resource rồi spawn worker mới; worker cũ ngừng nhận connection mới và drain connection hiện có. Nếu apply thất bại, master tiếp tục cấu hình cũ.

Runbook

  1. Render/diff config và secret references.
  2. Chạy nginx -t, kiểm file permission, certificate/key và bind.
  3. Reload bằng signal/service manager; không kill worker trực tiếp.
  4. Verify PID/generation, listener, synthetic request, certificate, error rate và old worker drain.
  5. Có rollback artifact; theo dõi long-lived WebSocket/stream giữ old worker.

Log rotation dùng USR1 để reopen files. Binary upgrade và graceful quit có signal/lifecycle riêng; process supervisor phải không đánh nhau với master.

Nguồn chính thức