GitHub Actions远程SSH/Ansible命令执行完成后仍超时问题咨询

1. 远程SSH调用完成后GitHub Actions任务不结束的可能原因 #

• SSH会话流未完全关闭：Ansible执行过程中可能产生后台子进程，这类子进程仍持有SSH会话的标准输出/错误句柄，SSH默认会等待所有关联进程关闭流后才会断开会话。本地CentOS环境运行正常大概率是本地SSH默认配置了后台进程自动解绑逻辑，而GitHub Actions runner的Ubuntu环境没有对应默认配置。
• 输出缓冲未正常刷新：GitHub Actions runner会捕获步骤的所有输出内容，如果Ansible或远程脚本的输出缓冲区没有被正常刷空，runner会判定命令仍在运行，不会结束步骤。
• SSH保活配置不匹配：GitHub Actions runner环境的默认SSH保活参数和远程主机配置冲突，远程命令执行结束后，SSH会话仍因保活机制保持连接，不会主动断开。
• Ansible非交互环境兼容问题：Ansible默认适配交互终端运行，会输出彩色控制字符、进度条等特殊内容，在GitHub Actions的非交互SSH会话中可能出现输出异常，导致会话流无法正常关闭。

2. GitHub Actions对远程SSH运行Ansible playbook的相关限制 #

GitHub Actions本身没有针对Ansible playbook的专属限制，仅存在通用作业/网络限制：

• 作业超时限制：公共仓库默认作业超时时间为6小时，私有仓库超时时间根据账号套餐决定，你遇到的2小时超时大概率是Workflow文件或组织/仓库层面配置了自定义超时策略。
• 空闲会话限制：若SSH会话连续30分钟以上没有输出流量，GitHub runner的网络策略会主动切断会话，你的场景中命令已正常执行完成，不属于这类限制触发的情况。
• 非交互环境限制：GitHub Actions的SSH会话属于非交互终端，没有TTY分配，若Ansible没有配置非交互运行参数，可能出现运行异常或会话卡住的问题，这属于环境适配问题，不是专属限制。

推荐修复方案 #

• 调整SSH命令参数，强制会话命令执行完成后立即断开，参考命令：
  ssh -n -x -o BatchMode=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=2 -i $PRIVATE_KEY_PATH $USER@$IP "/root/run.sh"
  也可以在远程命令末尾添加exit 0强制会话退出，或使用nohup包裹执行命令，让子进程和SSH会话解绑。
• 给Ansible添加非交互运行参数，关闭交互提示和彩色输出：
  ANSIBLE_NOCOLOR=1 ansible-playbook -i inventory/hosts playbook.yml --skip-tags network --non-interactive
• 给对应GitHub Actions步骤显式配置超时，避免无意义挂起：
  在Workflow的对应step中添加timeout-minutes: 110，匹配脚本的最大运行时长即可。

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