• Swoole从入门到入土(4)——TCP服务器[正确重启]


    在上一篇中,我们提到了一个配置项max_wait_time。这个配置项决定了在服务端在进程经束的时候,在max_wait_time时间内onWorkerStop事件会完成扫尾工作。

    那什么时候worker进程会结束呢?那当然是手动关闭(管理进程收到重启、关闭信号后)或者自动关闭(达到 max_request 时)啦。

    这里我们就会遇到一个问题:当更新了服务端的代码后,为了让新代码生效,如何优雅地终止 / 重启swoole服务端才能保证正在执行的业务不丢失?

    因为一台繁忙的后端服务器随时都在处理请求,如果运维人员通过 kill 进程方式来终止 / 重启服务器程序,有可能导致刚好代码执行到一半终止,没法保证整个业务逻辑的完整性。

    幸好,Swoole 提供了柔性终止 / 重启的机制,管理员只需要向 Server 发送特定的信号或者调用 reload 方法,worker进程就可以保证做好善后工作并结束进程,之后再重新拉起。

    管理员发送信号 :

    # 重启所有worker进程
    kill -USR1 主进程PID
    
    # 仅重启task进程
    kill -USR2 主进程PID
    #SIGTERM: 向主进程 / 管理进程发送此信号服务器将安全终止
    kill -15 主进程PID

    reload()方法:安全地重启所有 Worker/Task 进程。

    SwooleServer->reload(bool $only_reload_taskworkrer = false): bool

    参数$only_reload_taskworkrer:是否仅重启 Task 进程,默认值:false

    注意事项:

    -reload 有保护机制,当一次 reload 正在进行时,收到新的重启信号会丢弃
    - 如果设置了 user/group,Worker 进程可能没有权限向 master 进程发送信息,这种情况下必须使用 root 账户,在 shell 中执行 kill 指令进行重启
    -reload 指令对 addProcess 添加的用户进程无效
    -在 Base 模式下,客户端连接直接维持在 Worker 进程中,因此 reload 时会切断所有连接。

    shutdown() 方法: 关闭服务

    SwooleServer->shutdown(): void

    此函数可以用在 Worker 进程内

    到了这里,大家了解了如何优雅关闭 / 重启swoole服务器了。当然,还没完,我们需要注意以下两点:

    1) 要注意新修改的代码必须要在 OnWorkerStart 事件中重新载入才会生效,比如某个类在 OnWorkerStart 之前就通过 composer 的 autoload 载入了就是不可以的。

    2)  reload 还要配合这两个参数 max_wait_time 和 reload_async,设置了这两个参数之后就能实现异步安全重启。如果没有reload_async,Worker 进程收到重启信号或达到 max_request 时,会立即停止服务,这时 Worker 进程内可能仍然有事件监听,这些异步任务将会被丢弃。设置reload_async后会先创建新的 Worker,旧的 Worker 在完成所有事件之后自行退出。

        如果旧的 Worker 一直不退出,底层还增加了一个定时器,在max_wait_time 秒内旧的 Worker 没有退出,底层会强行终止,并会产生一个 WARNING 报错。

    本文新配置:

     reload_async:设置异步重启开关。【默认值:true】

    如何设置配置?请查看上一篇,基本配置项,点这里传送。

    本文新事件:

    onWorkerStart:此事件在 Worker 进程 / Task 进程启动时发生,这里创建的对象可以在进程生命周期内使用。

    function onWorkerStart(SwooleServer $server, int $workerId);

    $server:SwooleServer 对象

    $workerId:Worker 进程 id(非进程的 PID)

    注意:

    - onWorkerStart/onStart 是并发执行的,没有先后顺序。

    - 可以通过 $server->taskworker 属性来判断当前是 Worker 进程还是 Task 进程。

    - 设置了 worker_num 和 task_worker_num 超过 1 时,每个进程都会触发一次 onWorkerStart 事件,可通过判断 $worker_id 区分不同的工作进程。

    - 由 worker 进程向 task 进程发送任务,task 进程处理完全部任务之后通过 onFinish 回调函数通知 worker 进程。

    - 如果想使用 Reload 机制实现代码重载入,必须在 onWorkerStart 中 require 你的业务文件,而不是在文件头部。在 onWorkerStart 调用之前已包含的文件,不会重新载入代码。

    - 可以将公用的、不易变的 php 文件放置到 onWorkerStart 之前。这样虽然不能重载入代码,但所有 Worker 是共享的,不需要额外的内存来保存这些数据。 onWorkerStart 之后的代码每个进程都需要在内存中保存一份。

    - 发生致命错误或者代码中主动调用 exit 时,Worker/Task 进程会退出,管理进程会重新创建新的进程。这可能导致死循环,不停地创建销毁进程。

    onWorkerStop:此事件在 Worker 进程终止时发生。在此函数中可以回收 Worker 进程申请的各类资源。

    function onWorkerStop(SwooleServer $server, int $workerId);

    $server:SwooleServer 对象

    $workerId:Worker 进程 id(非进程的 PID)

    注意:

    - 程异常结束,如被强制 kill、致命错误、core dump 时无法执行 onWorkerStop 回调函数。
    - 一定不要在 onWorkerStop 中调用任何异步或协程相关 API,触发 onWorkerStop 时底层已销毁了所有事件循环设施。

    onWorkerExit:仅在开启 reload_async 特性后有效。笔者注:这个事件笔者在试验的代码中触发不了,不知道是不是哪个姿势不对

    function onWorkerExit(SwooleServer $server, int $workerId);

    $server:SwooleServer 对象

    $workerId:Worker 进程 id(非进程的 PID)

    注意:

    - Worker 进程未退出,onWorkerExit 会持续触发。
    - onWorkerExit 仅在 Worker 进程内触发, Task 进程不执行 onWorkerExit。
    - 在 onWorkerExit 中尽可能地移除 / 关闭异步的 Socket 连接,最终底层检测到事件循环中事件监听的句柄数量为 0 时退出进程。
    - 等待 Worker 进程退出后才会执行 onWorkerStop 事件回调。

    ----------高级分割线----------

    Linux信号普及:

     

    ---------------------------  我是可爱的分割线  ----------------------------

    最后博主借地宣传一下,漳州编程小组招新了,这是一个面向漳州青少年信息学/软件设计的学习小组,有意向的同学点击链接,联系我吧。

  • 相关阅读:
    InjectAPC全部项目(Win32和Win64位)
    Codeforces Round #377 (Div. 2)
    Codeforces Canada Cup 2016
    UVa 1395 (最小生成树)
    空间表SpaceList
    线程中的临界区的应用
    【题解】狼和羊-C++
    【基础算法-树状数组】入门-C++
    【题解】在你窗外闪耀的星星-C++
    【题解】[NOIP模拟题]我要的幸福-C++
  • 原文地址:https://www.cnblogs.com/ddcoder/p/13610882.html
Copyright © 2020-2023  润新知