在Jenkins中使用Dockerfile Agent时如何指定docker run参数？

我正在搭建一个使用Dockerfile Agent的简单Jenkins流水线，对应的Jenkinsfile代码如下：

pipeline {
    agent {
        dockerfile {
            dir 'docker'
            args '-v yarn_cache:usr/local/share/.cache/yarn'
        }
    }
    environment {
        CI = 'true'
    }
    stages {
        stage('Build') {
            steps {
                sh 'yarn install'
                sh 'yarn run build'
            }
        }
        stage('Test') {
            steps {
                sh 'yarn run test'
            }
        }
    }
}

我需要实现yarn缓存的持久化，因此希望容器启动时携带参数'-v yarn_cache:usr/local/share/.cache/yarn'，请问该配置是否正确？如何正确指定docker run参数？

好问题！你的缓存持久化思路是对的，但当前配置有一个关键细节错误，导致缓存无法正常工作：

问题所在 #

Docker卷挂载的容器内路径必须是绝对路径，你写的usr/local/share/.cache/yarn缺少了开头的/，Docker会把这个路径识别为相对路径，无法正确映射到容器内的Yarn缓存目录，最终缓存不会被持久化。

正确的配置方式 #

只需要补全容器内路径开头的/即可，修改后的Jenkinsfile如下：

pipeline {
    agent {
        dockerfile {
            dir 'docker'
            args '-v yarn_cache:/usr/local/share/.cache/yarn' // 补全绝对路径的/
        }
    }
    environment {
        CI = 'true'
    }
    stages {
        stage('Build') {
            steps {
                sh 'yarn install'
                sh 'yarn run build'
            }
        }
        stage('Test') {
            steps {
                sh 'yarn run test'
            }
        }
    }
}

额外注意事项 #

1. 验证缓存路径：不同Yarn版本或安装方式的缓存路径可能不同，你可以在容器内执行yarn cache dir命令，确认实际的缓存目录是否为/usr/local/share/.cache/yarn，避免路径不匹配。
2. 命名卷的优势：这里使用的yarn_cache是Docker命名卷，Jenkins会自动创建该卷（若不存在），后续所有使用该Agent的构建都会复用这个缓存，既保证了隔离性，又能有效加速依赖安装。
3. 主机目录挂载（可选）：如果偏好使用主机本地目录作为缓存，可以写成-v /your/host/path/yarn_cache:/usr/local/share/.cache/yarn，但命名卷在Jenkins流水线场景下更推荐，因为它无需管理主机目录权限问题。

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