trion/jenkins-docker-client

Jenkins Docker镜像（含Docker客户端）

镜像概述和主要用途

该Docker镜像包含Docker命令行工具，使Jenkins能够与Docker守护进程进行交互。同时集成了适用于Alpine系统的docker-compose构建版本，便于在CI/CD流程中管理容器化应用。

GitHub仓库：https://github.com/trion-development/docker-jenkins-docker-client

Docker Socket集成

当容器检测到Docker守护进程套接字（/var/run/docker.sock）的绑定挂载时，会自动配置适当权限，允许Jenkins通过套接字访问Docker服务。使用此功能需注意：

• 容器必须以root用户运行
• 通过环境变量JENKINS_USER指定运行Jenkins进程的用户ID（替代docker -u参数）

使用示例

确保本地目录$HOME/.jenkins已创建，执行以下命令启动容器：

bash
docker run -it --name=jenkins -e JENKINS_USER=$(id -u) --rm -p 8080:8080 -p 50000:50000 \
-v $HOME/.jenkins:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock \
--name jenkins trion/jenkins-docker-client

配置即代码（Configuration as Code）

通过设置环境变量JENKINS_CAC=true，可禁用Jenkins初始设置向导，启用配置即代码功能。此时容器预装"Configuration as Code"插件，支持通过环境变量和配置文件定义初始设置。

核心特性

• 可通过环境变量设置初始访问地址和管理员凭据
• 支持挂载自定义配置文件和插件列表
• 自动化Jenkins服务器初始化流程

配置方法

1. 初始配置文件：将YAML格式的配置文件挂载到/provisioning/config.yaml
2. 插件列表：创建插件清单文件并挂载到/provisioning/plugins.txt，建议包含以下基础插件：

   authorize-project:latest
   configuration-as-code:latest
   role-strategy:latest
   

更多配置细节：[***]

配置即代码示例

bash
docker run -it --name=jenkins -e JENKINS_USER=$(id -u) -e JENKINS_CAC=true \
--env JENKINS_ADMIN_ID=username --env JENKINS_ADMIN_PASSWORD=password \
--env JENKINS_LOCATION=http://localhost:8080 \
-v $HOME/.jenkins:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock \
-v ./config.yaml:/provisioning/config.yaml -v ./plugins.txt:/provisioning/plugins.txt \
--name jenkins trion/jenkins-docker-client

初始化完成后，可通过常规方式管理Jenkins服务器。