Jenkins使用自定义Docker镜像作为执行环境的问题求助

核心问题 #

你的Jenkins流水线虽然指定了自定义Docker镜像作为执行环境，但实际执行命令时调用的是Jenkins主机的npm环境，而非容器内的环境。根源在于Jenkins Docker Agent的默认挂载行为覆盖了容器内的用户目录，同时非交互式Shell未加载容器内配置的环境变量。

分步解决方案 #

1. 修正Jenkinsfile的Docker Agent配置 #

禁用Jenkins默认的主机目录挂载，强制使用容器内的jenkins用户和环境：

pipeline {
    agent none

    environment {
        ECR_IMAGE = '<account>.dkr.ecr.us-east-1.amazonaws.com/<team>-ci:latest'
    }
    stages {
        stage('Setup & Run Inside Container') {
            agent { 
                docker { 
                    image "$ECR_IMAGE"
                    // 强制使用容器内的jenkins用户，避免挂载主机目录覆盖容器内容
                    args '--user jenkins --no-volume-from'
                    // 让Jenkins自动处理ECR登录，无需手动拉取镜像
                    registryUrl 'https://<account>.dkr.ecr.us-east-1.amazonaws.com'
                    registryCredentialsId 'aws-credentials-ecr'
                } 
            }
            stages {
                stage('Jenkins debugging') {
                    steps {
                        sh 'pwd'
                        sh 'whoami'
                        sh 'echo $PATH'
                        sh 'npm config get prefix'
                        sh 'which serverless'
                        sh 'npm list -g --depth=0'
                    }
                }
                stage('Version Check') {
                    steps {
                        // 用bash -lc确保加载容器内的环境变量配置
                        sh '''
                        bash -lc 'npm --version'
                        bash -lc 'node --version'
                        bash -lc 'serverless --version'
                        bash -lc 'python --version'
                        '''
                    }
                }
            }
        }
    }
}

2. 优化Dockerfile的环境变量配置 #

确保环境变量在非交互式Shell中也能生效，将配置写入~/.bashrc：

FROM python:3.9-slim-buster

ENV NODE_MAJOR 18

RUN apt-get update && \
    apt-get install -y ca-certificates curl gnupg && \
    mkdir -p /etc/apt/keyrings && \
    curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg && \
    echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | tee /etc/apt/sources.list.d/nodesource.list && \
    apt-get update && \
    apt-get install nodejs -y

RUN useradd -m jenkins

RUN apt-get update && \
    apt-get install -y curl && \
    curl -fsSL https://get.docker.com | sh && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

USER jenkins
ENV NPM_PACKAGES="/home/jenkins/.npm-packages"
# 将环境变量写入.bashrc，确保非交互式Shell也能加载
RUN echo "export NPM_PACKAGES=$NPM_PACKAGES" >> ~/.bashrc && \
    echo "export PATH=\$PATH:$NPM_PACKAGES/bin" >> ~/.bashrc && \
    mkdir -p $NPM_PACKAGES && \
    npm config set prefix $NPM_PACKAGES

RUN bash -lc 'npm install -g serverless'

WORKDIR /workspace

关键原因说明 #

1. 目录挂载冲突：Jenkins Docker Agent默认会挂载主机的Jenkins用户目录到容器内，覆盖了容器中/home/jenkins的内容，导致你看到的是主机的npm环境而非容器内的。
2. 环境变量未加载：Jenkins执行Shell命令时默认使用非交互式模式，不会自动加载~/.bashrc，因此Dockerfile中设置的PATH和npm前缀无法生效。

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