How to change default args for docker run in Jenkins Docker Pipeline plugin?

Question

I'm trying to set up a docker agent for this pipeline, but I'm getting this error when running one of the commands inside my pipeline:

+ poetry shell
Spawning shell within /root/.cache/pypoetry/virtualenvs/python-project-template-nESIvdvh-py3.11

(25, 'Not a tty')

From what I've looked at, this is because jenkins executes docker run with the -t argument by default. I understand that removing the -t flag would fix this issue, but I can't find a way to do it. I've looked everywhere for ways to disable this (plus some other default flags) but I haven't found a workaround.

This is what my current Jenkinsfile looks like

pipeline {
    agent { docker {
        image 'matiasch/python3.11-poetry1.7'
        args '-u root --privileged'
    } }
    stages {
        stage('Install Dependencies') {
            steps {
                timeout(time: 5, unit: 'MINUTES') {
                    sh 'poetry install'
                    sh 'poetry shell'
                }
            }
        }
    }
}

And this is the docker run commands jenkins executes, as you can see, there are some default flags I haven't specified before the ones I added in my Jenkinsfile, -t being one of them. docker run -t -d -u 1001:1001 -u root --privileged -w /home/jenkins/workspace/Python_Project_Template_main -v ...

I have tried switching from a declarative pipeline to a scripted one, using different docker images, trying to find some command that 'negates' -t, looking in the jenkins/plugin configuration for default flags, but I can't find something that would fix the issue at its core which is to disable the default flags.

Answer 1

From the comments:

The docker jenkins plugin has been confusing for us for quite some time because of these default arguments. What we have been doing, using a normal runner we are just running sh "docker run ...." commands ourselves

How would this look? Do you have an extra stage before your other ones where you do the setup of the docker container?

We have a Dockerfile

FROM matiasch/python3.11-poetry1.7
RUN poetry install && poetry shell

Then we can test stuff locally, typically from Makefile or justfile:

docker build .
docker run --rm $(docker build -q .) some test commands

And then we do the same in jenkins:

pipeline {
    agent {}
    stages {
        stage('Install Dependencies') {
            steps {
                timeout(time: 5, unit: 'MINUTES') {
                    sh 'docker build .'
                    sh 'docker run --rm $(docker build -q .) some test commands'
                }
            }
        }
    }
}

It is also sometimes nice to put testing commands inside Dockerfile to re-use the caching properties of docker layers.