如何在 Django 请求处理程序线程中对 SIGTERM 执行代码

How to execute code on SIGTERM in Django request handler thread

我目前正在尝试了解 Django 在收到 SIGTERM 时的信号处理。

背景资料

我有一个应用程序可能有 运行 长请求,运行 在 Docker 容器中。当Docker想要停止一个容器时,它首先发送一个SIGTERM信号,等待一段时间,然后发送一个SIGKILL。通常,在 SIGTERM 上,您会停止接收新请求,并希望当前 运行 请求在 Docker 决定发送 SIGKILL 之前完成。 但是,在我的应用程序中,我想保存已尝试过哪些请求,并且发现这比立即完成请求更重要。所以我更希望当前请求在 SIGTERM 上关闭,这样我就可以优雅地结束它们(并保存它们的状态),而不是等待 SIGKILL。

我的尝试

我的理论是,您可以为 SIGTERM 注册一个信号侦听器,执行 sys.exit(),从而引发 SystemExit 异常。然后我想在我的请求处理程序中捕获该异常,并保存我的状态。作为第一个实验,我为 Django 开发服务器创建了一个模拟项目。 我在 Appconfig.ready() 函数中注册了信号:

import signal
import sys

from django.apps import AppConfig

import logging

logger = logging.getLogger(__name__)

def signal_handler(signal_num, frame):
    sys.exit()

class TesterConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'tester'

    def ready(self):
        logger.info('starting ready')
        signal.signal(signal.SIGTERM, signal_handler)

并创建了一个捕获异常和基本异常的请求处理程序:

import logging
import sys
import time

from django.http import HttpResponse

def handler(request):
    try:
        logger.info('start')
        while True:
            time.sleep(1)
    except Exception:
        logger.info('exception')
    except BaseException:
        logger.info('baseexception')

    return HttpResponse('hallo')

但是当我启动开发服务器用户 python manage.py runserver 然后使用 kill -n 15 <pid> 发送终止信号时,没有 'baseexception' 消息被记录('start' 确实被记录) . 完整的代码可以在 here.

我的问题

我的假设是 SIGTERM 信号是在主线程中处理的,所以 sys.exit() 调用是在主线程中处理的。所以在线程 运行 请求处理程序中不会引发异常,也不会捕获任何内容。 如何更改我的代码以在请求处理程序线程中引发 SystemError?我需要那个线程的一些信息来记录,所以我不能直接在信号处理程序中 'log' 一些东西。

好的,我做了一些调查,找到了我自己问题的答案。正如我在提出问题时有些怀疑的那样,在这种问题中,您可能想要与所要求的解决方案不同的解决方案。但是,我会 post 我的发现在这里,因为如果将来有人发现问题并发现他 - and/or 她自己处于类似情况。

上面的方法不起作用有几个原因。首先是我忘记在INSTALLED_APPS中注册我的应用程序,所以TesterConfig.ready中的代码并没有真正执行。

接下来,原来Django也为SIGTERM信号注册了一个处理程序,参见the Django source code。因此,如果您向进程发送 SIGTERM,这就是被触发的那个。我暂时在我的虚拟环境中评论了该行以进行更多调查,但当然这永远不会导致真正的解决方案。

sys.exit() 函数确实引发了 SystemExit 异常,但它仅在线程本身中处理。如果您想在线程之间进行通信,您可能需要使用 Event 并在要执行的线程中定期检查它。

如果你正在寻找如何在 运行 Django 通过 gunicorn 时做这样的事情的建议,我发现如果你使用 sync worker,你可以在你的 views.py,因为请求将在主线程中处理。 最后,我最终在这里注册了信号,并编写了一条日志记录行并在信号处理程序中引发了一个异常。然后由已经存在的异常处理来处理。