从零开始：Linux 上 Docker 部署 Jenkins 的全面指南

📚 为什么选择 Docker 部署 Jenkins？

📝 优势

• 易于部署：Docker 包含了所有必要的依赖项，确保环境一致性。
• 隔离性：每个 Jenkins 实例运行在独立的容器中，避免冲突。
• 可移植性：可以在任何支持 Docker 的环境中轻松迁移 Jenkins。

📄 准备工作

• 操作系统：任何基于 Debian 或 Red Hat 的 Linux 发行版（如 Ubuntu、CentOS 等）。
• Docker：确保已安装 Docker 并且服务正在运行。
• Docker Compose（可选）：用于更复杂的多容器配置。

🛠️ 安装 Docker

🖥️ 在 Ubuntu 上安装 Docker

sudo apt-get update
sudo apt-get install -y docker.io

🖥️ 在 CentOS 上安装 Docker

sudo yum install -y docker
sudo systemctl start docker
sudo systemctl enable docker

📊 验证 Docker 安装

docker --version

📦 使用 Docker 部署 Jenkins

📝 拉取 Jenkins 镜像

docker pull jenkins/jenkins:lts

📄 创建并运行 Jenkins 容器

docker run -d -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home --name jenkins jenkins/jenkins:lts

• -p 8080:8080：映射 Jenkins Web 界面端口。
• -p 50000:50000：映射 Jenkins Slave 端口。
• -v jenkins_home:/var/jenkins_home：挂载数据卷以持久化 Jenkins 数据。
• --name jenkins：为容器命名。

📊 获取初始管理员密码

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

🖥️ 访问 Jenkins

打开浏览器，访问 http://<你的服务器IP>:8080，输入初始管理员密码进行设置。

🔍 常见问题及解决方案

📄 问题 1：无法拉取 Jenkins 镜像

• Q: 为什么我无法从 Docker Hub 拉取 Jenkins 镜像？
• A: 这可能是因为网络问题或镜像名称错误。
• 解决方案：
  • 检查网络连接。
  • 确认镜像名称正确无误。
  • 使用国内镜像加速器（如阿里云、Docker 中国等）。

📊 问题 2：Jenkins 容器启动失败

• Q: 为什么 Jenkins 容器无法正常启动？
• A: 可能是由于端口冲突或配置错误。
• 解决方案：
  • 检查是否有其他服务占用 8080 和 50000 端口。
  • 查看容器日志以获取更多信息：

docker logs jenkins

📄 问题 3：Jenkins 数据丢失

• Q: 重启后 Jenkins 数据丢失怎么办？
• A: 这可能是由于未正确挂载数据卷。
• 解决方案：
  • 确保使用 -v 参数挂载数据卷。
  • 检查数据卷是否正确创建：

docker volume ls

📊 问题 4：Jenkins 插件安装失败

• Q: 为什么我在 Jenkins 中安装插件时总是失败？
• A: 这可能是因为网络问题或 Jenkins 更新源问题。
• 解决方案：
  • 检查网络连接。
  • 修改 Jenkins 的更新站点 URL，使用国内镜像源：
  1. 进入 Jenkins 管理界面。
  2. 选择 “Manage Jenkins” -> “Manage Plugins” -> “Advanced”。
  3. 将 “Update Site” 更改为国内镜像源，例如：

http://mirrors.jenkins.io/update-center.json

📈 总结

通过本文的详细介绍，你应该能够顺利地在 Linux 系统上使用 Docker 部署 Jenkins。合理利用 Docker 可以极大地简化 CI/CD 流程的管理和维护。希望这篇教程对你有所帮助！