islasgeci/jenkins

Jenkins Docker镜像文档

概述

Jenkins是开源的持续集成/持续部署(CI/CD)平台，本Docker镜像提供容器化部署方案，支持通过Docker快速搭建CI/CD环境，集成Docker套接字实现容器内操作Docker，适用于自动化构建、测试和部署流程。

核心功能与特性

• 基于Jenkins LTS版本，提供稳定可靠的CI/CD服务
• 内置JDK11环境，满足Java应用构建需求
• 支持Docker套接字挂载，允许容器内操作宿主机Docker daemon
• 提供持久化存储卷(jenkins_home)，保存配置、插件和构建数据
• 暴露8080端口(Web UI)和50000端口(代理节点连接)
• 支持外部密钥文件挂载，方便集成密钥管理工具

使用场景与适用范围

• 开发团队自动化构建、测试、打包和部署流程
• 容器化环境中的CI/CD流程实现
• 需要快速搭建和迁移的Jenkins环境
• 需在Jenkins中执行Docker命令的场景(如容器化构建)

使用方法与配置说明

前置准备

针对需要Docker集成的场景，建议执行以下准备操作：

shell
# 创建jenkins用户
sudo adduser jenkins
# 将jenkins用户添加到docker组以获取Docker操作权限
sudo usermod -aG docker jenkins
# （可选）将jenkins用户添加到root组
sudo usermod -aG root jenkins
# 授予Docker套接字权限（解决权限问题）
sudo chmod 777 /var/run/docker.sock

拉取镜像

可选择官方镜像或定制镜像：

shell
# 官方LTS JDK11版本
docker pull jenkins/jenkins:lts-jdk11

# 定制镜像（如islasgeci/jenkins）
docker pull islasgeci/jenkins:latest

启动容器

使用官方镜像启动

shell
docker run -d --rm \
  -v /home/ciencia_datos/.vault/.secrets:/.vault/.secrets \  # 挂载密钥文件
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker套接字
  -v jenkins_home:/var/jenkins_home \  # 持久化存储卷
  -p 8080:8080 \  # Web UI端口映射
  -p 50000:50000 \  # 代理节点连接端口映射
  --name jenkins \
  jenkins/jenkins:lts-jdk11

使用定制镜像启动（islasgeci/jenkins）

shell
docker run \
  --detach \
  --name jenkins \
  --publish 50000:50000 \
  --publish 8080:8080 \
  --rm \
  --volume /usr/bin/docker:/usr/bin/docker \  # 挂载Docker可执行文件
  --volume /var/run/docker.sock:/var/run/docker.sock \
  --volume ${HOME}/.vault/.secrets:/.vault/.secrets \
  --volume jenkins_home:/var/jenkins_home \
  islasgeci/jenkins:latest

获取初始管理员密码

容器启动后，通过以下命令获取初始管理员密码（用于首次登录）：

shell
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

常见问题解决

Docker权限问题

错误信息：

shell
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: dial unix /var/run/docker.sock: connect: permission denied

解决方法：

shell
sudo chmod 777 /var/run/docker.sock

配置说明

• 持久化存储：通过-v jenkins_home:/var/jenkins_home挂载命名卷，确保Jenkins配置、插件和数据在容器重启后不丢失
• Docker集成：挂载/var/run/docker.sock允许Jenkins在容器内使用宿主机Docker服务，实现容器化构建和部署
• 密钥管理：通过-v ${HOME}/.vault/.secrets:/.vault/.secrets挂载外部密钥文件，方便集成Vault等密钥管理工具
• 端口映射：8080端口用于Web UI访问，50000端口用于Jenkins代理节点与主节点通信