Azure DevOps Pipelines执行az container exec命令出现设备ioctl错误

问题场景 #

在Azure DevOps Pipelines的Azure CLI任务中执行以下命令时，触发终端相关错误：

az container exec --resource-group myRG --name myImageName --exec-command "/bin/bash"

错误信息如下：

[command]/bin/bash /home/vsts/work/_temp/azureclitaskscript1588671209398.sh
The command failed with an unexpected error. Here is the traceback:

(25, 'Inappropriate ioctl for device')
Traceback (most recent call last):
  File "/opt/az/lib/python3.6/site-packages/knack/cli.py", line 215, in invoke
    cmd_result = self.invocation.execute(args)
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/commands/__init__.py", line 625, in execute
    raise ex
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/commands/__init__.py", line 689, in _run_jobs_serially
    results.append(self._run_job(expanded_arg, cmd_copy))
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/commands/__init__.py", line 682, in _run_job
    six.reraise(*sys.exc_info())
  File "/opt/az/lib/python3.6/site-packages/six.py", line 693, in reraise
    raise value
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/commands/__init__.py", line 659, in _run_job
    result = cmd_copy(params)
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/commands/__init__.py", line 324, in __call__
    return self.handler(*args, **kwargs)
  File "/opt/az/lib/python3.6/site-packages/azure/cli/core/__init__.py", line 531, in default_command_handler
    return op(**command_args)
  File "/opt/az/lib/python3.6/site-packages/azure/cli/command_modules/container/custom.py", line 621, in container_exec
    _start_exec_pipe(execContainerResponse.web_socket_uri, execContainerResponse.password)
  File "/opt/az/lib/python3.6/site-packages/azure/cli/command_modules/container/custom.py", line 655, in _start_exec_pipe
    oldtty = termios.tcgetattr(sys.stdin)
termios.error: (25, 'Inappropriate ioctl for device')

原因分析 #

az container exec默认会尝试创建交互式终端（TTY），但Azure DevOps Pipeline的运行环境是非交互式的，不存在可交互的终端设备，导致命令尝试读取终端属性时失败，抛出termios.error。

解决方案 #

1. 执行非交互式命令 #

不要直接进入bash shell，而是直接运行具体的业务命令，完全避开交互式场景：

# 示例：查看容器内指定目录的文件列表
az container exec --resource-group myRG --name myImageName --exec-command "ls -l /app"

# 示例：执行多步命令
az container exec --resource-group myRG --name myImageName --exec-command "cd /app && npm install && npm run build"

2. 强制分配伪终端并执行非交互命令 #

添加--tty参数模拟终端环境，同时通过/bin/bash -c包裹要执行的命令，避免进入交互式shell：

az container exec --resource-group myRG --name myImageName --tty --exec-command "/bin/bash -c 'echo hello world && cat /app/config.json'"

3. 替代方案：使用容器日志排查问题 #

如果只是需要排查容器运行状态，无需进入容器，直接拉取日志即可：

az container logs --resource-group myRG --name myImageName

也可以通过Azure Portal查看容器的实时日志，更直观地获取运行信息。

注意事项 #

Azure DevOps Pipeline的代理环境本身不支持任何交互式操作，所有需要用户手动输入的命令都会执行失败，因此在Pipeline中应尽量使用非交互式的批量命令完成操作。

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