microdc/jenkins-auto-jnlp-slave

Jenkins自动注册JNLP Slave镜像

该镜像基于https://github.com/shamil/docker-jenkins-auto-jnlp-slave%E9%A1%B9%E7%9B%AE%E5%88%86%E5%8F%89%E5%BC%80%E5%8F%91%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8EKubernetes%E9%9B%86%E7%BE%A4%E7%8E%AF%E5%A2%83%EF%BC%8C%E4%B8%8Ehttps://github.com/microdc/k8s-jenkins%E4%B8%BB%E8%8A%82%E7%82%B9%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E3%80%82

核心功能

• 基于JNLP协议的代理节点
• 自动向Jenkins主节点注册，容器退出时自动注销
• 启动时从主节点下载agent.jar，避免版本兼容性问题
• 预装Docker、AWS CLI和kubectl工具，支持集群内的构建、推送和部署操作

使用场景

• Kubernetes集群中的Jenkins构建任务执行
• 容器镜像的构建与推送
• 基于AWS或Kubernetes的应用部署

配置说明

环境变量

常用变量：

• JENKINS_AUTH：Jenkins服务器的用户名和密码/API token（格式：user:secret）
• JENKINS_URL：Jenkins主节点地址（示例：http://localhost:8080）
• JENKINS_SLAVE_NAME：注册的slave名称（默认：$HOSTNAME）
• JENKINS_SLAVE_NUM_EXECUTORS：执行器数量（默认：1）

次要变量（可保持默认）：

• DOCKER_GROUP：Docker组名称（默认：docker）
• DOCKER_SOCKET：Docker socket路径（默认：/var/run/docker.sock）
• JAVA_OPTS：传递给slave.jar的Java选项（默认未设置）

权限要求

需创建具有以下权限的非管理员用户：

• Overall/Read
• Agent/Connect
• Agent/Create
• Agent/Delete

部署示例

基础运行命令

sh
docker run -d \
    --net host \
    -e JENKINS_URL=http://jenkins.internal.domain:8080 \
    -e JENKINS_AUTH=registrator:1234567890123456789012 \
    -v /任意路径:/var/jenkins_home \
    microdc/jenkins-auto-jnlp-slave

需挂载/var/jenkins_home卷以支持任务构建。

支持Docker命令的运行命令

sh
docker run -d \
    --net host \
    -e JENKINS_URL=[***] \
    -e JENKINS_AUTH=registrator:1234567890123456789012 \
    -v /任意路径:/var/jenkins_home \
    -v /run/docker.sock:/run/docker.sock \
    -v /usr/bin/docker:/usr/bin/docker \
    microdc/jenkins-auto-jnlp-slave