jenkinsci/slave

Jenkins Agent Docker镜像

![Gitter聊天]([***]

镜像概述

这是一个基础Docker镜像，包含JDK和Jenkins agent可执行文件（agent.jar）。该可执行文件是https://github.com/jenkinsci/remoting%E7%9A%84%E5%AE%9E%E4%BE%8B%E3%80%82JDK%E7%89%88%E6%9C%AC%E5%8F%96%E5%86%B3%E4%BA%8E%E9%95%9C%E5%83%8F%E5%92%8C%E5%B9%B3%E5%8F%B0%EF%BC%8C%E8%AF%A6%E8%A7%81%E4%B8%8B%E6%96%87%E2%80%9C%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E%E2%80%9D%E9%83%A8%E5%88%86%E3%80%82

更新日志

版本3.35-1及以上的更新日志请参见https://github.com/jenkinsci/docker-slave/releases%E3%80%82%E4%B9%8B%E5%89%8D%E7%89%88%E6%9C%AC%E6%97%A0%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97%EF%BC%8C%E8%AF%B7%E6%9F%A5%E7%9C%8B%E6%8F%90%E4%BA%A4%E5%8E%86%E5%8F%B2%E3%80%82

Jenkins Remoting库的更新日志可在https://github.com/jenkinsci/remoting/releases%E8%8E%B7%E5%8F%96%E3%80%82

核心功能与特性

• 内置JDK环境，支持Java 8和Java 11（取决于具体标签）
• 包含Jenkins agent可执行文件（agent.jar），基于Jenkins Remoting库
• 支持工作目录功能（从Remoting 3.8开始），提供默认日志记录并改变JAR缓存行为
• 多平台支持：Linux（Debian、Alpine）和Windows Containers（Server Core、Nano Server）
• 轻量级基础镜像选项（Alpine Linux）

使用场景

• 作为https://github.com/jenkinsci/docker-jnlp-slave/%E9%95%9C%E5%83%8F%E7%9A%84%E5%9F%BA%E7%A1%80
• 通过“在主节点执行命令启动代理”的启动方式部署Jenkins代理
• 适用于Jenkins分布式构建环境，需要在不同平台（Linux/Windows）运行构建任务的场景

使用方法

基本使用

Linux平台

在Jenkins中设置“远程根目录”为/home/jenkins/agent后，执行以下命令：

sh
docker run -i --rm --name agent --init jenkins/slave java -jar /usr/share/jenkins/agent.jar

Windows Containers平台

在Jenkins中设置“远程根目录”为C:\Users\jenkins\Agent后，执行以下命令：

docker run -i --rm --name agent --init jenkins/agent java -jar C:/ProgramData/Jenkins/agent.jar

工作目录使用

从https://github.com/jenkinsci/remoting/blob/master/CHANGELOG.md#38%E5%BC%80%E5%A7%8B%E6%94%AF%E6%8C%81%E5%B7%A5%E4%BD%9C%E7%9B%AE%E5%BD%95%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%BB%98%E8%AE%A4%E6%97%A5%E5%BF%97%E8%AE%B0%E5%BD%95%E5%B9%B6%E6%94%B9%E5%8F%98JAR%E7%BC%93%E5%AD%98%E8%A1%8C%E4%B8%BA%E3%80%82

Linux平台

sh
docker run -i --rm --name agent1 --init -v agent1-workdir:/home/jenkins/agent jenkins/slave java -jar /usr/share/jenkins/agent.jar -workDir /home/jenkins/agent

Windows Containers平台

docker run -i --rm --name agent1 --init -v agent1-workdir:C:/Users/jenkins/Work jenkins/agent java -jar C:/ProgramData/Jenkins/agent.jar -workDir C:/Users/jenkins/Work

配置说明

该镜像提供多种配置，可通过以下标签访问：

• latest：基于openjdk:8-jdk，包含最新版本的Remoting和JDK 8
• latest-jdk11：基于openjdk:11-jdk，包含最新版本的Remoting和JDK 11
• alpine：基于openjdk:8-jdk-alpine，轻量级Alpine Linux版本，包含JDK 8
• jenkins4eval/agent:windowsservercore-1809：基于adoptopenjdk:8-jdk-hotspot-windowsservercore-1809，Windows Server Core平台，JDK 8
• jenkins4eval/agent:windowsservercore-1809-jdk11：基于adoptopenjdk:11-jdk-hotspot-windowsservercore-1809，Windows Server Core平台，JDK 11
• jenkins4eval/agent:nanoserver-1809：Windows Nano Server平台，JDK 8
• jenkins4eval/agent:nanoserver-1809-jdk11：Windows Nano Server平台，JDK 11

Java 11支持

Java 11支持适用于Debian-based镜像和Windows镜像。Alpine镜像不提供Java 11版本（详见JENKINS-54487）。未来Java 11镜像可能会切换为基于AdoptOpenJDK的基础镜像。