Jenkins Pipeline求助：Node.js构建中读取环境变量返回undefined

嘿，我来帮你搞定这个问题，顺便给你梳理下按顺序触发登录、部署、登出的正确姿势，以及跨构建传递数据的方法～

首先得明确：Jenkins Pipeline里的环境变量，默认不会自动暴露给Node.js的process.env，得你手动传递才行，我给你几个靠谱的实现方式：

1. 让Node.js脚本拿到Jenkins环境变量的正确方法 #

方法一：用withEnv包裹Node执行步骤 #

这是最直接的方式，把需要的变量显式传递给Node进程。比如你的LoginToPlatform阶段可以这么写：

stage('LoginToPlatform') {
    steps {
        // 这里把Jenkins里的变量（比如全局配置的JENKINS_USERNAME）映射到Node能识别的环境变量
        withEnv(["username=${env.JENKINS_USERNAME}", "password=${env.JENKINS_PASSWORD}"]) {
            sh 'node login-script.js'
        }
    }
}

这样在你的login-script.js里，process.env.username和process.env.password就能拿到对应的值了。

方法二：通过命令行参数传递（更适合敏感信息） #

如果是敏感数据（比如密码），用命令行参数传递有时候更安全，也不容易出环境变量传递的问题。比如：

stage('LoginToPlatform') {
    environment {
        // 可以是Pipeline自定义变量，或者用Jenkins凭证管理的加密值
        PLATFORM_USER = 'your-username'
        PLATFORM_PASS = credentials('platform-login-password') // 从Jenkins凭证库拿加密密码
    }
    steps {
        sh 'node login-script.js --username $PLATFORM_USER --password $PLATFORM_PASS'
    }
}

然后在Node.js脚本里用process.argv或者yargs这类库来解析参数，比如：

// login-script.js
const args = require('yargs').argv;
console.log('用户名:', args.username);
console.log('密码:', args.password);

2. 跨构建/阶段传递数据的正确姿势 #

你需要在登录、部署、登出之间传递数据（比如登录后的token），分两种情况处理：

同一Pipeline内的多阶段传递 #

如果这三个操作是同一个Pipeline里的不同stage，直接用Pipeline变量存储即可，比如：

// 定义一个全局变量存token
def platformAuthToken = ''

stage('LoginToPlatform') {
    steps {
        withEnv(["username=${env.PLATFORM_USER}"]) {
            script {
                // 假设login-script.js执行后会把token输出到标准输出
                platformAuthToken = sh(script: 'node login-script.js', returnStdout: true).trim()
            }
        }
    }
}

stage('DeployApp') {
    steps {
        // 把token传递给部署脚本
        withEnv(["AUTH_TOKEN=${platformAuthToken}"]) {
            sh 'node deploy-script.js'
        }
    }
}

stage('LogoutFromPlatform') {
    steps {
        withEnv(["AUTH_TOKEN=${platformAuthToken}"]) {
            sh 'node logout-script.js'
        }
    }
}

这里要确保你的Node.js脚本把需要传递的数据输出到stdout，这样Pipeline才能捕获到。

跨独立Job传递数据 #

如果登录、部署、登出是三个独立的Jenkins Job，那可以用这几种方式：

• 参数化触发：登录Job执行完成后，触发部署Job时把token作为参数传递过去
• 共享文件存储：把token写入Jenkins服务器上的某个文件（注意权限和清理），后续Job读取这个文件
• Jenkins stash功能：把包含token的文件存为stash，后续Job通过unstash获取

3. 调试环境变量的小技巧 #

如果还是拿不到值，先在Node.js脚本里打印所有环境变量排查问题：

// 在login-script.js开头加这段
console.log('当前所有环境变量:', process.env);
console.log('尝试获取的username:', process.env.username);

然后去Jenkins的构建日志里看输出，确认变量是不是真的传过来了。另外要注意：Jenkins里的环境变量通常是大写的（比如USERNAME），如果你写的是username，可能是大小写不匹配导致的undefined！

4. 敏感信息的安全建议 #

涉及密码、token这类敏感数据，别用明文环境变量传递，建议用Jenkins的凭证管理功能，比如：

environment {
    // 这是一个存储在Jenkins凭证库的「用户名+密码」凭证
    PLATFORM_CRED = credentials('platform-login-credentials')
}
steps {
    withEnv(["username=${PLATFORM_CRED_USR}", "password=${PLATFORM_CRED_PSW}"]) {
        sh 'node login-script.js'
    }
}

这样Jenkins会自动屏蔽敏感信息的输出，避免泄露。

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