CentOS 7 上使用 Docker 安装 Jenkins 完整教程
目录
前言
准备工作
系统要求
检查系统信息
更新系统
安装Docker
第一步：卸载旧版本Docker（如果存在）
第二步：安装必要的软件包
第三步：添加Docker官方仓库
第四步：安装Docker CE
第五步：启动Docker服务
第六步：验证Docker安装
第七步：配置Docker用户权限（可选但推荐）
拉取Jenkins镜像
选择Jenkins镜像版本
查看下载的镜像
创建Jenkins容器
第一步：创建数据目录
第二步：运行Jenkins容器
第三步：验证容器运行状态
初始化Jenkins
第一步：获取初始管理员密码
第二步：访问Jenkins Web界面
第三步：解锁Jenkins
第四步：安装插件
第五步：创建管理员用户
第六步：实例配置
第七步：开始使用Jenkins
基础配置
配置系统设置
Jenkins URL配置
邮件通知配置
全局工具配置
安全配置
插件管理
常见问题及解决方案
问题1：无法访问Jenkins Web界面
问题2：Jenkins容器启动失败
问题3：Jenkins运行缓慢
问题4：忘记管理员密码
问题5：插件安装失败
总结
下一步建议
有用的命令速查
相关资源
前言
Jenkins是一个开源的持续集成和持续部署(CI/CD)工具，广泛用于自动化构建、测试和部署应用程序。使用Docker安装Jenkins具有以下优势：
- 环境隔离：Jenkins运行在独立的容器中，不会影响主机系统
- 快速部署：几分钟内就能完成安装
- 易于管理：可以轻松备份、迁移和升级
- 版本控制：可以使用不同版本的Jenkins镜像
准备工作
系统要求
- 操作系统：CentOS 7.x
- 内存：至少2GB RAM（推荐4GB以上）
- 磁盘空间：至少10GB可用空间
- 网络：能够访问互联网下载镜像
检查系统信息
# 查看系统版本
cat /etc/redhat-release# 查看内存使用情况
free -h# 查看磁盘空间
df -h
更新系统
# 更新系统软件包
sudo yum update -y
安装Docker
第一步：卸载旧版本Docker（如果存在）
# 卸载可能存在的旧版本Docker
sudo yum remove docker \docker-client \docker-client-latest \docker-common \docker-latest \docker-latest-logrotate \docker-logrotate \docker-engine
第二步：安装必要的软件包
# 安装yum工具包
sudo yum install -y yum-utils \device-mapper-persistent-data \lvm2
解释：
yum-utils：提供yum-config-manager实用程序device-mapper-persistent-data和lvm2：Docker的devicemapper存储驱动程序需要
第三步：添加Docker官方仓库
# 添加Docker CE稳定版仓库
sudo yum-config-manager \--add-repo \https://download.docker.com/linux/centos/docker-ce.repo
第四步：安装Docker CE
# 安装Docker CE
sudo yum install -y docker-ce docker-ce-cli containerd.io
第五步：启动Docker服务
# 启动Docker服务
sudo systemctl start docker# 设置Docker开机自启
sudo systemctl enable docker# 查看Docker状态
sudo systemctl status docker
第六步：验证Docker安装
# 查看Docker版本
sudo docker --version# 运行hello-world测试容器
sudo docker run hello-world
如果看到"Hello from Docker!"的消息，说明Docker安装成功！
第七步：配置Docker用户权限（可选但推荐）
# 将当前用户添加到docker组
sudo usermod -aG docker $USER# 重新登录或执行以下命令使权限生效
newgrp docker# 测试是否可以不使用sudo运行docker命令
docker --version
拉取Jenkins镜像
选择Jenkins镜像版本
Jenkins有两个主要版本：
- LTS版本：长期支持版本，更稳定（推荐）
- 最新版本：包含最新功能，但可能不够稳定
# 拉取Jenkins LTS版本（推荐）
docker pull jenkins/jenkins:lts# 或者拉取最新版本
# docker pull jenkins/jenkins:latest
查看下载的镜像
# 查看本地Docker镜像
docker images
你应该能看到类似这样的输出：
REPOSITORY TAG IMAGE ID CREATED SIZE
jenkins/jenkins lts xxxxxxxxxxxx 2 weeks ago 441MB
创建Jenkins容器
第一步：创建数据目录
为了确保Jenkins数据持久化，我们需要在主机上创建一个目录来存储Jenkins数据：
# 创建Jenkins数据目录
sudo mkdir -p /var/jenkins_home# 设置目录权限（Jenkins容器内的用户ID是1000）
sudo chown -R 1000:1000 /var/jenkins_h