Ansible Shell模块执行带timeout的apt命令为何卡住？

云上老周

2026-6-19

问题描述

现有Ansible Playbook文件pl.yaml内容如下：

- name: say 'hello world'
  hosts: all
  gather_facts: yes
  tasks:
    - name: run command
      shell: "timeout 100 apt install mysql-client -y"
      args:
        chdir: "/root"
      register: output

    - name: debug_output
      debug:
        var: output.stdout_lines

执行命令ansible-playbook pl.yaml -i inventory -f 5 -b后，进程卡在apt命令环节。通过strace追踪apt install mysql-client -y进程，发现其被SIGTTOU信号终止（尽管进程卡住，但mysql-client实际已完成安装）。

出现以下异常规律：

移除timeout命令，直接执行apt install mysql-client -y则正常运行；
修改命令为timeout 100 echo | apt install mysql-client -y，或添加timeout --foreground 100参数，也可正常执行；
直接登录目标服务器执行上述所有命令均无问题。

原因分析

核心差异在于Ansible Shell模块的执行环境与直接登录终端的环境不同：

Ansible通过SSH执行Shell模块时，默认不会为命令分配交互式TTY终端（除非显式指定become_flags: -t或调整ssh_args启用TTY）。
timeout命令默认行为是将自身置于后台运行（脱离终端），此时apt在执行过程中会尝试访问终端（比如检查终端交互状态），而后台进程尝试访问终端时，系统会发送SIGTTOU信号，导致apt进程被终止或卡住。
直接登录服务器时，命令运行在交互式TTY环境中，timeout的后台行为不会触发SIGTTOU信号，因此所有命令都能正常执行。

可行修复方案的对应原理：

添加--foreground参数：强制timeout保持前台运行，不脱离终端，避免apt触发终端访问信号；
用echo | apt ...：将apt的标准输入重定向为管道（而非终端），让apt跳过终端交互检查；
移除timeout：直接消除timeout带来的后台化行为。

解决方法

推荐优先使用以下方案：

使用Ansible内置超时控制（符合Ansible最佳实践）：
无需依赖系统timeout命令，直接在Shell模块中指定timeout参数：
```
- name: run command
  shell: "apt install mysql-client -y"
  args:
    chdir: "/root"
  register: output
  timeout: 100
```

为timeout添加--foreground参数：

- name: run command
  shell: "timeout --foreground 100 apt install mysql-client -y"
  args:
    chdir: "/root"
  register: output

通过管道重定向apt标准输入：

- name: run command
  shell: "timeout 100 echo | apt install mysql-client -y"
  args:
    chdir: "/root"
  register: output

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