Jenkins在CentOS上如何进行容器化部署

在 CentOS 上使用 Docker 容器化部署 Jenkins

一 环境准备

• 安装 Docker（推荐使用国内镜像源以加速）
  • 安装依赖与仓库：
    • sudo yum update -y
    • sudo yum install -y yum-utils
    • sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
  • 安装并启动 Docker：
    • sudo yum install -y docker-ce docker-ce-cli containerd.io
    • sudo systemctl start docker && sudo systemctl enable docker
  • 可选：配置 Docker 镜像加速器（提升拉取速度），编辑 /etc/docker/daemon.json 添加：
    • { “registry-mirrors”: [“https://hub-mirror.c.163.com”,“https://registry.aliyuncs.com”,“https://docker.mirrors.ustc.edu.cn”] }
    • 然后 sudo systemctl restart docker
• 创建持久化目录（避免容器重启后数据丢失）
  • mkdir -p /data/jenkins_home
  • chown -R 1000:1000 /data/jenkins_home（Jenkins 容器内以 **jenkins:jenkins（UID 1000）**运行，目录属主需匹配，否则会出现权限问题导致容器退出）

二 启动 Jenkins 容器

• 使用 Docker 卷（推荐，便于备份与迁移）
  • docker network create jenkins
  • docker pull jenkins/jenkins:lts-jdk17
  • docker run -d --name jenkins --network jenkins
    -v jenkins_home:/var/jenkins_home
    -p 8080:8080 -p 50000:50000
    –restart=on-failure
    jenkins/jenkins:lts-jdk17
• 使用宿主机目录挂载（便于直接在宿主机查看与备份）
  • docker run -d --name jenkins
    -v /data/jenkins_home:/var/jenkins_home
    -p 8080:8080 -p 50000:50000
    –restart=on-failure
    jenkins/jenkins:lts-jdk17
• 端口说明
  • 8080：Jenkins Web 界面
  • 50000：JNLP 代理（Agent）通信端口，用于添加构建节点

三 初始化与安全配置

• 获取解锁密码
  • 方式一：查看容器日志
    • docker logs jenkins | grep -A 2 “initialAdminPassword”
  • 方式二：进入容器查看
    • docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword
• 访问与初始化
  • 浏览器访问：http://<服务器IP或域名>:8080
  • 选择“安装推荐插件”，随后创建管理员账户
• 提升插件下载速度（可选）
  • 修改文件：/data/jenkins_home/hudson.model.UpdateCenter.xml
  • 将 URL 改为国内镜像源，例如：
    • https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
  • 重启容器或等待 Jenkins 自动刷新元数据

四 可选优化

• 反向代理与域名访问（Nginx 示例）
  • 安装 Nginx：sudo yum install -y nginx
  • 新建配置 /etc/nginx/conf.d/jenkins.conf：
    • server { listen 80; server_name jenkins.your-domain.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }
  • 启动或重启 Nginx：sudo systemctl restart nginx
  • 访问：http://jenkins.your-domain.com（注意云服务器需开放 80/443 端口）
• 云服务器安全组与防火墙
  • 开放 8080（以及使用代理时的 80/443）入站规则；如使用 50000 添加构建代理，也需放通对应端口

五 常见问题排查

• 容器启动后立即退出（Exited）
  • 检查宿主机目录权限：确保 /data/jenkins_home 属主为 1000:1000
  • 查看日志定位：docker logs jenkins
• 忘记解锁密码
  • 通过 docker logs 或 docker exec 读取 /var/jenkins_home/secrets/initialAdminPassword
• 拉取镜像缓慢或失败
  • 配置 Docker 镜像加速器（/etc/docker/daemon.json），然后重启 Docker
• 云上无法访问
  • 确认云厂商安全组与系统防火墙已放行对应端口（如 8080/80/443/50000）