如何通过Jenkins Pipeline克隆GitHub代码至Windows虚拟机？求Node.js示例

前置准备 #

确保完成以下配置：

• 谷歌云Windows虚拟机已部署Jenkins Agent节点，且该节点标记为windows-node（可根据实际修改标签）
• Jenkins全局工具配置中已添加Node.js安装器，指定好所需版本（比如18.x）
• GitHub仓库已配置部署密钥（将Agent的公钥添加到仓库），确保Agent能无密码克隆代码

完整Pipeline代码（Jenkinsfile） #

pipeline {
    agent {
        label 'windows-node'  // 指向谷歌云Windows虚拟机的Jenkins Agent标签
    }
    tools {
        nodejs 'NodeJS-18.x'  // 对应Jenkins全局配置的Node.js工具名称
    }
    stages {
        stage('克隆GitHub代码') {
            steps {
                // 替换为你的GitHub仓库地址和分支
                git url: 'git@github.com:your-username/your-nodejs-repo.git',
                    branch: 'main',
                    credentialsId: 'github-ssh-credential'  // Jenkins中配置的SSH凭据ID
            }
        }
        stage('Node.js项目依赖安装') {
            steps {
                bat 'npm install'  // Windows环境用bat执行命令
            }
        }
        stage('Node.js项目构建（可选）') {
            steps {
                bat 'npm run build'  // 替换为你的项目构建命令
            }
        }
    }
    post {
        success {
            echo '代码克隆及项目操作执行成功！'
        }
        failure {
            echo '执行失败，请检查日志排查问题'
        }
    }
}

关键部分说明 #

• Agent匹配：label 'windows-node'必须和谷歌云Windows虚拟机上Jenkins Agent的标签一致，保证任务运行在目标机器上
• Git克隆配置：如果用HTTPS地址，将url替换为https://github.com/your-username/your-nodejs-repo.git，credentialsId换成对应的用户名密码凭据ID
• Node.js环境加载：tools块会自动在Windows Agent上加载指定版本的Node.js，无需手动配置环境变量
• Windows命令适配：Windows环境下必须用bat执行命令，不要用Linux环境的sh，避免兼容性问题

常见问题处理 #

• 克隆失败：检查Agent的SSH密钥是否正确添加到GitHub，或Jenkins中的凭据ID配置是否有误
• Node.js命令报错：确认Jenkins全局工具配置的Node.js安装路径在Windows虚拟机上可正常访问
• 通信失败：确保谷歌云虚拟机防火墙开放Jenkins Master与Agent的通信端口（默认50000）

内容的提问来源于stack exchange，提问作者Yang wom vieira