Docker graceful shutdown: SIGTERM, stop-grace-period và zero

Trả lời nhanh: Docker graceful shutdown cần rollout có kiểm soát: chốt topology/version, chạy staging hoặc canary, kiểm tra readiness và theo dõi metric nghiệp vụ trước khi tăng traffic. Mọi mốc dừng và revision quay lại đều được ghi rõ.

Phạm vi: Bài áp dụng cho PID 1 trong môi trường staging/standalone. Kiểm tra Nginx/Docker/OS/database và phiên bản CLI thực tế trước khi chạy; không đưa credential thật vào lệnh, log hay artifact.

Tổng quan Docker graceful shutdown: PID 1 — Tổng quan biên tập cho chủ đề: Docker graceful shutdown.

Tín hiệu cần đối chiếu: PID 1; signal forwarding; app cleanup; điều kiện trước triển khai; staging/canary; health/readiness; rollback

PID 1 — thao tác và bằng chứng

Trước rollout PID 1, ghi topology, version, schema/migration order và endpoint readiness. Một process còn sống không đồng nghĩa request nghiệp vụ đã sẵn sàng. Docker—Container stop

Migration phá schema phải có bước tương thích ngược và kế hoạch backfill riêng. Không chạy lệnh phá dữ liệu trong cùng lượt với đổi image. (docker-graceful-shutdown-sigterm-stop-grace-period · outline 1)

Với PID 1, ghi lại input và phiên bản CLI trước khi chạy; sau đó đối chiếu từng tín hiệu điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup trong stdout, stderr hoặc log audit. Kết quả đạt phải chỉ ra trạng thái và phạm vi tài nguyên; kết quả lỗi phải có chuỗi nhận diện để người trực ca biết bước khoanh vùng kế tiếp. Gắn transcript với docker-graceful-shutdown-sigterm-stop-grace-period, commit/config hash, owner và timestamp. Không dùng exit code đơn độc làm bằng chứng. Che token, private key, cookie và PII trước khi lưu artifact; giữ bản raw trong kho có quyền hạn nếu incident yêu cầu.

signal forwarding — thao tác và bằng chứng

Dùng `docker events –filter container=api –filter event=stop` trên staging/canary cho signal forwarding; kiểm tra điều kiện trước triển khai và staging/canary trước khi tăng traffic. Giữ digest/config revision để tái lập chính xác. Docker—Container stop

Smoke test cần gọi đường đi thật qua proxy/worker/dependency, không chỉ kiểm tra HTTP 200 của process. (docker-graceful-shutdown-sigterm-stop-grace-period · outline 2)

Một lần kiểm tra signal forwarding chỉ có giá trị khi lặp lại được. Chốt workload, hostname, digest hoặc schema, rồi chạy lệnh tương ứng với docker-graceful-shutdown-sigterm-stop-grace-period. Đối chiếu các tín hiệu bắt buộc (điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup) với expected output và error signature; nếu thiếu dữ liệu, ghi unknown. So sánh baseline trước/sau trong cùng cửa sổ và nêu rõ điều gì không được suy ra từ phép đo. Artifact thay đổi cần ghi config diff đã redact, người chịu trách nhiệm và thời điểm hết hạn exception trước khi promote.

app cleanup — thao tác và bằng chứng

Trong cửa sổ quan sát, đối chiếu health với 5xx, latency p95, queue và log migration. Nếu một metric vượt ngưỡng, dừng ở canary thay vì mở rộng blast radius. Docker—Container stop

Rollback theo failure domain: image, config, schema hay traffic. Giữ artifact và xác minh revision cũ trước khi đóng incident. (docker-graceful-shutdown-sigterm-stop-grace-period · outline 3)

Đừng gộp app cleanup vào một checklist chung. Tạo một phép thử nhỏ có điều kiện, ghi command, exit code, metric và log line riêng cho docker-graceful-shutdown-sigterm-stop-grace-period. Các marker điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup phải xuất hiện ở đúng section để người đọc có thể truy từ claim tới evidence. Khi kết quả không khớp expected (Output của docker-graceful-shutdown-sigterm-stop-grace-period phải có trạng thái success và error phân biệt bằng exit code/stderr; unknown flag, permission denied hoặc timeout dẫn tới nhánh khoanh vùng riêng.), dừng rollout/restore, giữ hiện trường và mở issue thay vì sửa nhiều biến cùng lúc. Artifact công khai chỉ chứa giá trị đã che và hash kiểm chứng.

Quy trình Docker graceful shutdown: signal forwarding — Minh họa đặt cạnh phần hướng dẫn tương ứng.

Compose timeout — thao tác và bằng chứng

Trước rollout Compose timeout, ghi topology, version, schema/migration order và endpoint readiness. Một process còn sống không đồng nghĩa request nghiệp vụ đã sẵn sàng. Docker—Container stop

Trong runbook của docker-graceful-shutdown-sigterm-stop-grace-period, Compose timeout là điểm quyết định: allow/deny, ready/not-ready, pass/fail hoặc baseline/regression. Định lượng bằng tín hiệu điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup, ghi phiên bản và phạm vi áp dụng, rồi nêu ngưỡng chuyển sang rollback. Một output xanh nhưng dependency hoặc health đỏ vẫn là fail. Sau khi sửa, chạy lại cùng lệnh và lưu kết quả cạnh config hash; revoke/rotate credential trước khi dọn mọi bản sao chứa secret.

load balancer drain — thao tác và bằng chứng

Dùng `docker events –filter container=api –filter event=stop` trên staging/canary cho load balancer drain; kiểm tra điều kiện trước triển khai và staging/canary trước khi tăng traffic. Giữ digest/config revision để tái lập chính xác. Docker—Container stop

Smoke test cần gọi đường đi thật qua proxy/worker/dependency, không chỉ kiểm tra HTTP 200 của process. (docker-graceful-shutdown-sigterm-stop-grace-period · outline 5)

Với load balancer drain, ghi lại input và phiên bản CLI trước khi chạy; sau đó đối chiếu từng tín hiệu điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup trong stdout, stderr hoặc log audit. Kết quả đạt phải chỉ ra trạng thái và phạm vi tài nguyên; kết quả lỗi phải có chuỗi nhận diện để người trực ca biết bước khoanh vùng kế tiếp. Gắn transcript với docker-graceful-shutdown-sigterm-stop-grace-period, commit/config hash, owner và timestamp. Không dùng exit code đơn độc làm bằng chứng. Che token, private key, cookie và PII trước khi lưu artifact; giữ bản raw trong kho có quyền hạn nếu incident yêu cầu.

test kill — thao tác và bằng chứng

Một lần kiểm tra test kill chỉ có giá trị khi lặp lại được. Chốt workload, hostname, digest hoặc schema, rồi chạy lệnh tương ứng với docker-graceful-shutdown-sigterm-stop-grace-period. Đối chiếu các tín hiệu bắt buộc (điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup) với expected output và error signature; nếu thiếu dữ liệu, ghi unknown. So sánh baseline trước/sau trong cùng cửa sổ và nêu rõ điều gì không được suy ra từ phép đo. Artifact thay đổi cần ghi config diff đã redact, người chịu trách nhiệm và thời điểm hết hạn exception trước khi promote.

rollback — thao tác và bằng chứng

Trước rollout rollback, ghi topology, version, schema/migration order và endpoint readiness. Một process còn sống không đồng nghĩa request nghiệp vụ đã sẵn sàng. Docker—Container stop

Đừng gộp rollback vào một checklist chung. Tạo một phép thử nhỏ có điều kiện, ghi command, exit code, metric và log line riêng cho docker-graceful-shutdown-sigterm-stop-grace-period. Các marker điều kiện trước triển khai, staging/canary, health/readiness, rollback, PID 1, signal forwarding, app cleanup phải xuất hiện ở đúng section để người đọc có thể truy từ claim tới evidence. Khi kết quả không khớp expected (Output của docker-graceful-shutdown-sigterm-stop-grace-period phải có trạng thái success và error phân biệt bằng exit code/stderr; unknown flag, permission denied hoặc timeout dẫn tới nhánh khoanh vùng riêng.), dừng rollout/restore, giữ hiện trường và mở issue thay vì sửa nhiều biến cùng lúc. Artifact công khai chỉ chứa giá trị đã che và hash kiểm chứng.

Recipe lệnh/config cho docker-graceful-shutdown-sigterm-stop-grace-period

Chạy ở staging cho Docker graceful shutdown với hostname, path và digest đã thay bằng giá trị không nhạy cảm. Lưu exit code cùng stdout/stderr đã redact và gắn artifact với docker-graceful-shutdown-sigterm-stop-grace-period.

docker stop --time 45 api
docker events --filter container=api --filter event=stop
rg -n 'SIGTERM|drain|shutdown complete' api.log

Expected output và error signature — docker-graceful-shutdown-sigterm-stop-grace-period

Output của docker-graceful-shutdown-sigterm-stop-grace-period phải có trạng thái success và error phân biệt bằng exit code/stderr; unknown flag, permission denied hoặc timeout dẫn tới nhánh khoanh vùng riêng. Đối chiếu thêm version, timestamp, health/readiness và log liên quan; output minh họa không phải kết quả production.

Quyết định Docker graceful shutdown: app cleanup — Bảng quyết định giúp chọn bước tiếp theo có điều kiện.

Rollback và stop boundary của docker-graceful-shutdown-sigterm-stop-grace-period

Dừng canary docker-graceful-shutdown-sigterm-stop-grace-period khi 5xx, latency p95, queue hoặc readiness vượt ngưỡng đã ghi. Đưa traffic về digest/config revision trước, kiểm tra smoke test rồi mới đóng rollout.

Failure mode cần tránh ở PID 1

PID 1: thay đổi nhiều biến cùng lúc nên không biết nguyên nhân.
PID 1: đọc exit code nhưng bỏ qua health, dependency hoặc error signature.
PID 1: lưu secret/PII trong log, image layer, backup hoặc ảnh chụp.
PID 1: rollback nhầm failure domain làm blast radius lớn hơn.

Đọc tiếp trong cùng cụm Linux/DevOps — docker-graceful-shutdown-sigterm-stop-grace-period

docker compose production checklist giam downtime và docker restart policy healthcheck production

Nguồn chính thức cho docker-graceful-shutdown-sigterm-stop-grace-period

Docker—Container stop; Docker—Compose file stop_grace_period

FAQ theo đúng chủ đề Docker graceful shutdown

PID 1 áp dụng cho phiên bản nào?

Kiểm tra version/tool và topology trước khi áp dụng PID 1. Chạy recipe ở trên trong staging; nếu expected/error signature khác, dừng và cập nhật runbook thay vì copy nguyên lệnh.

signal forwarding áp dụng cho phiên bản nào?

Kiểm tra version/tool và topology trước khi áp dụng signal forwarding. Chạy recipe ở trên trong staging; nếu expected/error signature khác, dừng và cập nhật runbook thay vì copy nguyên lệnh.

app cleanup áp dụng cho phiên bản nào?

Kiểm tra version/tool và topology trước khi áp dụng app cleanup. Chạy recipe ở trên trong staging; nếu expected/error signature khác, dừng và cập nhật runbook thay vì copy nguyên lệnh.

Compose timeout áp dụng cho phiên bản nào?

Kiểm tra version/tool và topology trước khi áp dụng Compose timeout. Chạy recipe ở trên trong staging; nếu expected/error signature khác, dừng và cập nhật runbook thay vì copy nguyên lệnh.

Cập nhật docker-graceful-shutdown-sigterm-stop-grace-period: 08/09/2026. Nội dung là runbook tham khảo; phải kiểm tra phiên bản, nguồn chính thức và rollback trong môi trường thật trước khi áp dụng. Safety boundary: Không thay thế tư vấn chuyên môn; kiểm tra tình huống thực tế trước khi áp dụng.

Docker graceful shutdown: SIGTERM, stop-grace-period và zero-downtime