如何配置Docker镜像的优雅停机时长，避免10秒后被SIGKILL？

一、延长优雅停机时长的镜像层面实现 #

Docker默认的10秒停机超时是docker stop命令的默认设置，镜像本身没法直接修改这个超时值，但可以通过自定义进程管理逻辑，确保数据库的优雅停机流程优先完成，尽量避免被提前终止：

1. 用自定义ENTRYPOINT脚本做PID 1进程 #

写一个shell脚本作为容器的启动入口，负责启动数据库、捕获终止信号，触发优雅停机流程，直到数据库完全停止后再退出脚本。这样Docker会等着脚本退出（不是只等数据库进程），只要脚本在数据库停机完成前一直运行，就能保证停机流程执行完毕。

示例Dockerfile：

FROM mysql:8.0

# 复制自定义启动脚本到容器内
COPY custom-entrypoint.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/custom-entrypoint.sh

# 设置脚本为容器启动入口
ENTRYPOINT ["custom-entrypoint.sh"]

示例custom-entrypoint.sh脚本：

#!/bin/bash
set -m

# 启动MySQL后台进程
mysqld &
MYSQL_PID=$!

# 定义优雅停机函数
graceful_shutdown() {
    echo "收到终止信号，开始MySQL优雅停机..."
    # 调用MySQL自带的优雅停机命令
    mysqladmin -uroot -p${MYSQL_ROOT_PASSWORD} shutdown
    # 等待MySQL进程完全退出
    wait $MYSQL_PID
    echo "MySQL已完成优雅停机"
}

# 捕获Docker发送的SIGTERM和SIGINT信号，触发停机函数
trap graceful_shutdown SIGTERM SIGINT

# 等待MySQL进程退出（保持脚本运行）
wait $MYSQL_PID

这个脚本作为容器的PID 1进程，收到Docker发的SIGTERM后，会先执行数据库的优雅停机操作，等数据库完全停止后才退出脚本。哪怕停机时长超过10秒，只要脚本没退出，Docker会一直等（注：如果用户没改docker stop的超时参数，Docker还是会在10秒后发SIGKILL，但脚本会优先完成核心的停机操作，尽量降低强制终止的影响）。

二、能不能完全避免被SIGKILL？ #

不行。因为SIGKILL是操作系统级的强制终止信号，任何进程都没法捕获、忽略或者处理它。如果docker stop的超时时间到了，Docker会直接给容器的PID 1进程发SIGKILL，强制终止整个容器。

但可以通过镜像层面的优化，把SIGKILL的影响降到最低：

• 确保数据库的优雅停机命令能快速完成核心数据落盘，就算后续被强制终止，数据一致性也能得到保障。
• 在镜像的说明文档里明确写清楚，这个镜像需要更长的停机时间，提示用户运行容器时用--stop-timeout参数设置合适的超时值（比如docker run --stop-timeout 30 ...）。

内容的提问来源于stack exchange，提问作者ramazan polat