Jenkins Pipeline中docker run -it执行失败，报input device is not a TTY错误如何解决？

这个问题我在日常维护Jenkins Pipeline时碰到过好多次，核心原因其实很好理解：Jenkins的Pipeline运行在无交互的后台环境中，而-it参数是docker run用来分配TTY终端并开启交互模式的——这俩需求完全冲突，自然就会抛出「input device is not a TTY」的错误。

下面根据不同场景给你几个可行的解决办法：

场景1：容器不需要交互操作（最常见） #

直接去掉-it参数，换成-d让容器后台运行，或者干脆不指定运行模式，直接执行容器内的命令：

pipeline {
    agent any
    stages {
        stage('启动后台容器') {
            steps {
                // 后台启动Nginx容器
                sh 'docker run --name my-nginx -d nginx:alpine'
                // 或者直接执行容器内命令后退出
                sh 'docker run nginx:alpine echo "容器内执行的输出"'
            }
        }
    }
}

这种方式完全适配Jenkins的无交互环境，是最推荐的做法。

场景2：需要给容器传递输入（轻量交互） #

如果你的容器需要接收一些输入但不需要手动交互，可以保留-i参数（开启标准输入），去掉-t，同时通过管道或者直接指定命令来传递输入：

pipeline {
    agent any
    stages {
        stage('给容器传递输入') {
            steps {
                // 直接在容器内执行命令并获取输出
                sh 'docker run -i nginx:alpine cat /etc/os-release'
                // 通过管道给容器传递输入
                sh 'echo "test content" | docker run -i nginx:alpine grep test'
            }
        }
    }
}

-i只负责开启标准输入流，不强制要求TTY终端，完美避开了错误触发条件。

场景3：容器程序依赖TTY环境（特殊需求） #

如果你的容器内运行的程序必须依赖TTY才能正常工作（比如某些CLI工具），可以单独使用-t参数分配TTY，配合后台启动，再用docker exec进入容器执行命令：

pipeline {
    agent any
    stages {
        stage('模拟TTY环境运行容器') {
            steps {
                // 后台启动带TTY的容器
                sh 'docker run --name my-tty-app -d -t nginx:alpine'
                // 进入容器执行依赖TTY的命令
                sh 'docker exec my-tty-app bash -c "echo \$TERM"'
                // 任务完成后清理容器
                sh 'docker rm -f my-tty-app'
            }
        }
    }
}

这种方式既满足了程序对TTY的依赖，又不会因为Jenkins的无交互环境触发错误。

另外提个小技巧：如果是用Jenkins官方的Docker Pipeline插件（比如通过agent { docker { image 'nginx:alpine' } }指定代理），插件会自动处理容器的启动、终端适配和销毁，根本不需要你手动写docker run，能彻底避免这类终端问题。

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