unox/jenkins

Jenkins Docker镜像（含docker组权限）

镜像概述

该镜像基于官方Jenkins镜像构建，主要修改是将jenkins用户添加到docker用户组。这一调整使容器内的Jenkins能够通过/var/run/docker.sock与宿主机的Docker守护进程通信，从而在Jenkins任务中直接执行Docker相关操作。

核心功能与特性

• 保留官方Jenkins镜像的全部功能，包括自动化构建、测试和部署能力
• jenkins用户已加入docker组，具备访问Docker API的权限
• 支持通过挂载/var/run/docker.sock实现与宿主机Docker环境的交互
• 与官方Jenkins镜像保持兼容，可无缝替换使用

使用场景

• 持续集成/持续部署(CI/CD)流程中需要在Jenkins任务内构建Docker镜像的场景
• 需要在Jenkins Pipeline中执行Docker命令（如镜像推送、容器管理）的环境
• 希望在容器化Jenkins中直接管理宿主机Docker资源的使用场景

使用方法

拉取镜像

bash
docker pull unox/jenkins

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v jenkins_home:/var/jenkins_home \
  --name jenkins-docker \
  unox/jenkins

配置说明

• 端口映射：

  • 8080:8080：Jenkins Web管理界面端口
  • 50000:50000：Jenkins代理节点通信端口

• 数据卷挂载：

  • /var/run/docker.sock:/var/run/docker.sock：挂载宿主机Docker socket，实现Docker API访问
  • jenkins_home:/var/jenkins_home：持久化存储Jenkins配置、任务数据和插件

验证Docker访问权限

容器启动后，可通过以下命令验证Jenkins用户是否具有Docker访问权限：

bash
docker exec -it jenkins-docker sudo -u jenkins docker info

若成功返回Docker系统信息，表明权限配置正确。