Jenkins Agent Docker镜像

镜像概述

这是一个基于jenkins/agent镜像构建的Jenkins代理Docker镜像，包含JDK环境和Jenkins代理可执行文件（agent.jar），该可执行文件是Jenkins Remoting库的实例。在镜像基础上，扩展集成了Docker客户端以及德语语言和时区配置。JDK版本取决于所使用的镜像标签和平台，具体信息见下方配置说明。

核心功能与特性

基础特性

• 镜像延伸：基于Jenkinsagent镜像构建，确保与Jenkins生态的兼容性和稳定性
• 完整运行环境：内置JDK和agent.jar，满足Jenkins代理的基础运行需求
• 多版本支持：提供多种JDK版本配置，适配不同构建环境需求

扩展功能

• Docker客户端集成：预装Docker客户端，支持在代理节点中执行Docker命令，适用于容器化构建场景
• 德语环境配置：预设德语语言支持和时区设置，适应德语环境下的使用需求

适用场景

• 作为Jenkins构建代理节点，处理各类自动化构建任务
• 需要在代理节点中执行Docker命令的CI/CD流程（如构建、推送Docker镜像）
• 对德语语言环境或特定时区有需求的Jenkins构建环境

配置说明

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

Linux镜像标签

使用方法

拉取镜像

根据项目所需JDK版本，拉取对应标签的镜像：

# 拉取JDK11稳定版（推荐）
docker pull [镜像仓库地址]/jenkins-agent:jdk11

# 拉取JDK8版本
docker pull [镜像仓库地址]/jenkins-agent:jdk8

# 拉取JDK17预览版
docker pull [镜像仓库地址]/jenkins-agent:jdk17

在Jenkins中配置代理节点

1. 登录Jenkins管理界面，进入系统管理 > 节点管理 > 新建节点
2. 配置节点基本信息（名称、远程工作目录、执行器数量等）
3. 在启动方式中选择通过Docker容器运行代理
4. 在Docker镜像字段输入拉取的镜像名称（如[镜像仓库地址]/jenkins-agent:jdk11）
5. 按需配置高级选项（如挂载Docker套接字以支持容器内Docker命令：/var/run/docker.sock:/var/run/docker.sock）
6. 保存配置后，Jenkins将自动使用指定镜像启动代理节点

手动启动代理示例

如需手动测试代理连接，可使用以下命令（需替换实际参数）：

docker run -it --rm [镜像仓库地址]/jenkins-agent:jdk11 \
  java -jar /usr/share/jenkins/agent.jar \
  -url [***] \
  -secret [agent-secret] \
  -name [agent-node-name]

参数说明：

• [***]: Jenkins控制器访问地址
• [agent-secret]: 从Jenkins节点配置页面获取的代理连接密钥
• [agent-node-name]: 预配置的代理节点名称

注意：生产环境中建议通过Jenkins自动管理代理生命周期，手动启动仅用于测试目的。