GitLab远程执行脚本时如何避免等待子进程？

问题背景 #

我通过GitLab流水线执行以下操作：

• 停止远程服务器上的Python进程
• 部署新版本Python代码
• 触发Python进程重启（无需等待进程启动完成）

但第三步出现异常：Python进程能正常启动，远程辅助脚本也看似执行完毕，但GitLab任务会一直卡住等待，输出末尾显示“...”。

当前配置：

GitLab CI 命令（gitlab-ci.yml） #

job_back_start:
  script:
    - ssh -p 222 user@project.my-server.de ./path/to/start_server.sh

远程启动脚本（start_server.sh） #

#!/bin/bash

cd my_directory
# 安装依赖并过滤已满足的提示
pip3 install -r requirements.txt  | grep -v 'already satisfied'
cd src
(
tmux -c "python3 main.py > /dev/null" # 尝试后台启动服务器
) &

已尝试的无效方案：

• 在SSH命令末尾添加&
• 使用nohup包裹SSH命令、远程脚本命令，或在脚本中给Python命令加nohup
• 用bash显式调用远程脚本
• SSH添加-t选项
• 更新gitlab-runner至15.9.1版本
• 启用CI_DEBUG_TRACE调试模式

补充：添加-v选项后任务有时能完成，但需等待1分钟以上，且等待发生在获取返回值之后。

解决方案 #

核心是让SSH会话彻底断开，不被远程子进程的文件句柄占用，需从远程脚本和GitLab CI命令两方面修改：

1. 修改远程启动脚本start_server.sh #

移除tmux（无需终端复用的话，tmux可能持有SSH会话句柄），改用nohup+disown让Python进程完全脱离当前会话：

#!/bin/bash

cd my_directory
pip3 install -r requirements.txt  | grep -v 'already satisfied'
cd src
# 彻底脱离会话：后台运行 + 重定向所有输出 + 解除进程与会话关联
nohup python3 main.py > /dev/null 2>&1 &
disown

• nohup：让进程忽略挂起信号，即使SSH会话关闭也能继续运行
• > /dev/null 2>&1：将标准输出和标准错误都重定向到空设备，避免占用SSH的输出句柄
• disown：将进程从当前shell的作业列表中移除，彻底脱离会话控制

2. 修改GitLab CI中的SSH命令 #

确保SSH在远程脚本执行完成后立即退出，可选择以下两种方案：

方案一：使用SSH的-f选项

-f会让SSH在执行命令前转到后台，避免Runner等待：

job_back_start:
  script:
    - ssh -p 222 -f user@project.my-server.de "./path/to/start_server.sh > /dev/null 2>&1"

方案二：远程用setsid启动脚本

setsid会创建新的会话和进程组，让脚本完全脱离当前SSH会话：

job_back_start:
  script:
    - ssh -p 222 user@project.my-server.de "setsid ./path/to/start_server.sh > /dev/null 2>&1 < /dev/null"

• < /dev/null：重定向标准输入，避免进程等待输入导致SSH会话无法关闭

问题原因 #

之前的配置中，即使将命令后台运行，远程子进程（如tmux启动的Python）仍可能持有SSH会话的标准输入/输出/错误句柄，导致SSH无法正常终止，GitLab Runner因此一直等待SSH进程退出。通过上述修改，可彻底切断进程与会话的关联，释放所有句柄，让SSH立即退出，GitLab任务随之结束。

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