mathconst/windows-jenkins-agent-node

Windows Jenkins Agent (NodeJS 10.16.3) 镜像文档

镜像概述

本镜像为基于Windows平台的Jenkins代理（Agent），预装NodeJS 10.16.3及配套npm包管理器。旨在为Jenkins主节点提供Windows环境下的构建能力，特别适用于需要在Windows系统中运行Node.js 10.16.3版本进行项目构建、测试和部署的CI/CD场景。

核心功能与特性

• 系统环境：基于Windows Server核心镜像，提供稳定的Windows运行环境
• 预装组件：已配置NodeJS 10.16.3和对应版本npm，无需额外安装
• Jenkins兼容：支持与Jenkins主节点通过JNLP协议或SSH协议连接
• 即开即用：镜像启动后可直接作为Jenkins代理节点使用，减少环境配置时间

使用场景

• Node.js 10.16.3项目在Windows环境下的自动化构建与测试
• 需要Windows系统依赖的Node.js应用程序打包（如Windows可执行文件）
• 多平台CI/CD流程中Windows节点的补充
• 对Node.js版本有严格要求（10.16.3）的Windows环境构建任务

使用方法与配置

基本使用（docker run）

通过以下命令启动Jenkins代理，连接到指定的Jenkins主节点：

bash
docker run -d \
  -e JENKINS_URL="https://your-jenkins-server" \
  -e JENKINS_AGENT_NAME="windows-nodejs-agent" \
  -e JENKINS_SECRET="your-agent-secret" \
  --name jenkins-windows-agent \
  your-image-name:tag

环境变量说明

持久化工作目录

为避免容器重启后工作目录数据丢失，可挂载本地目录作为工作目录：

bash
docker run -d \
  -e JENKINS_URL="https://your-jenkins-server" \
  -e JENKINS_AGENT_NAME="windows-nodejs-agent" \
  -e JENKINS_SECRET="your-agent-secret" \
  -v C:\local\workspace:C:\jenkins\workspace \
  --name jenkins-windows-agent \
  your-image-name:tag

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jenkins-agent:
    image: your-image-name:tag
    container_name: jenkins-windows-agent
    environment:
      - JENKINS_URL=https://your-jenkins-server
      - JENKINS_AGENT_NAME=windows-nodejs-agent
      - JENKINS_SECRET=your-agent-secret
      - JENKINS_AGENT_WORKDIR=C:\jenkins\workspace
    volumes:
      - C:\local\workspace:C:\jenkins\workspace
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

验证安装

容器启动后，可通过以下命令验证Node.js和npm版本：

bash
docker exec -it jenkins-windows-agent node -v
# 输出应显示：v10.16.3

docker exec -it jenkins-windows-agent npm -v
# 输出应显示对应npm版本（通常为6.9.0，与Node.js 10.16.3匹配）

同时，在Jenkins主节点的"节点管理"页面中应能看到该代理节点状态为"在线"。