第8章 云服务器安装 Docker 并部署 Jenkins

本章目标

在云服务器上通过 Docker 快速启动 Jenkins。

1. 前置条件

• 一台云服务器（2C4G 起步更稳）
• 已开放安全组端口（至少 8080、22）
• 可使用 sudo 权限

2. 安装 Docker（示例思路）

按你的系统（Ubuntu/CentOS）安装 Docker 与 Docker Compose。
安装后验证：

docker --version
docker compose version

建议把当前登录用户加入 docker 用户组，避免每次都写 sudo：

sudo usermod -aG docker $USER
newgrp docker

3. 启动 Jenkins 容器

你项目已有 docker-compose.yml，在服务器项目目录执行：

docker compose up -d

当前仓库的 docker-compose.yml 默认映射：

• 8080:8080（Jenkins Web）
• 50000:50000（Agent 通信）
• /data/jenkins_home:/var/jenkins_home（数据持久化）

检查：

docker ps
docker logs jenkins --tail 100

4. 首次登录 Jenkins

浏览器访问：http://<服务器IP>:8080

初始化密码查看方式（根据容器名调整）：

docker logs <jenkins_container_name>

复制 initialAdminPassword 完成初始化。

若容器名就是 jenkins，可直接执行：

docker logs jenkins | rg "initialAdminPassword|Please use the following password"

5. 安装基础插件

建议至少安装：

• Pipeline
• Git
• Credentials Binding
• HTML Publisher（可选，便于展示报告）

6. Jenkins 基础配置

• 配置时区为 Asia/Shanghai
• 配置工具（可选 Python）
• 配置全局凭据（Git 凭据、SMTP 凭据）

7. 进入第9章前的最后确认

• Jenkins 容器状态为 Up
• 浏览器可访问 http://<服务器IP>:8080
• 服务器可访问你的 Git 仓库（私有仓库要提前配好凭据）
• 安全组已放行 8080

本章验收标准

• Jenkins 可访问并可登录
• 插件安装完成
• 能新建 Pipeline 任务