Jenkins 入门
简介
Jenkins 是一个开源的持续集成/持续部署(CI/CD)工具,用于自动化构建、测试和部署软件项目。
安装
Docker 安装(推荐)
bash
# 创建数据目录
mkdir -p /var/jenkins_home
chown -R 1000:1000 /var/jenkins_home
# 启动 Jenkins
docker run -d \
--name jenkins \
-p 8080:8080 \
-p 50000:50000 \
-v /var/jenkins_home:/var/jenkins_home \
-v /var/run/docker.sock:/var/run/docker.sock \
jenkins/jenkins:lts手动安装
bash
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-11-jdk -y
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins -y
sudo systemctl start jenkins
sudo systemctl enable jenkins
# CentOS/RHEL
sudo yum install java-11-openjdk -y
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key
sudo yum install jenkins -y
sudo systemctl start jenkins
sudo systemctl enable jenkins初始化配置
解锁 Jenkins
- 访问
http://localhost:8080 - 获取初始密码:
bash
# Docker 方式
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
# 手动安装方式
cat /var/lib/jenkins/secrets/initialAdminPassword安装插件
选择推荐插件或自定义安装:
- 推荐插件:Git、Maven、Docker Pipeline、Pipeline、SonarQube Scanner
- 可选插件:NodeJS、AWS CodeDeploy、Kubernetes
创建管理员用户
- 设置用户名、密码、邮箱等信息
基本概念
Job(任务)
Jenkins 的核心概念,代表一个自动化任务。
Pipeline(流水线)
将构建、测试、部署等步骤组合成一个完整的工作流。
Node(节点)
执行任务的机器,可以是 Jenkins 主节点或从节点。
Plugin(插件)
扩展 Jenkins 功能的组件。
创建第一个 Job
1. 新建任务
- 点击「新建任务」
- 输入任务名称
- 选择任务类型(自由风格项目、Pipeline 等)
2. 配置任务
自由风格项目
General → 描述、参数化构建
源码管理 → Git、SVN
构建触发器 → 定时构建、SCM触发
构建环境 → Maven环境、NodeJS环境
构建 → Execute shell、Invoke top-level Maven targets
构建后操作 → 归档制品、发送邮件Pipeline 项目
General → 描述
Pipeline → Pipeline script 或 Pipeline script from SCM3. 运行任务
- 点击「立即构建」
- 查看构建日志
- 查看构建结果
常用插件
核心插件
| 插件 | 用途 |
|---|---|
| Git | 源码管理 |
| Maven Integration | Maven 构建 |
| Docker Pipeline | Docker 构建 |
| Pipeline | 流水线支持 |
| SonarQube Scanner | 代码质量检查 |
其他常用插件
| 插件 | 用途 |
|---|---|
| NodeJS | Node.js 环境 |
| AWS CodeDeploy | AWS 部署 |
| Kubernetes | Kubernetes 部署 |
| Email Extension | 邮件通知 |
| Slack Notification | Slack 通知 |
| Blue Ocean | 现代化 UI |
全局工具配置
配置 JDK
系统管理 → 全局工具配置 → JDK
→ 添加 JDK
→ 取消勾选"自动安装"
→ 设置 JAVA_HOME 路径配置 Maven
系统管理 → 全局工具配置 → Maven
→ 添加 Maven
→ 设置 MAVEN_HOME 路径配置 NodeJS
系统管理 → 全局工具配置 → NodeJS
→ 添加 NodeJS
→ 选择版本系统配置
邮件配置
系统管理 → 系统配置 → 邮件通知
→ 设置 SMTP 服务器
→ 设置用户名和密码
→ 设置发件人地址GitHub 配置
系统管理 → 系统配置 → GitHub
→ 添加 GitHub Server
→ 设置 API URL 和 CredentialsDocker 配置
系统管理 → 系统配置 → Docker
→ 添加 Docker Server
→ 设置 Docker Host URL安全配置
用户管理
系统管理 → 管理用户
→ 创建用户
→ 设置权限权限管理
系统管理 → 全局安全配置
→ 启用安全
→ 选择授权策略(矩阵式安全、角色策略等)密钥管理
系统管理 → 管理凭据
→ 添加凭据(用户名密码、SSH密钥、API令牌等)备份与恢复
备份
bash
# 备份整个 Jenkins 目录
tar -czvf jenkins_backup_$(date +%Y%m%d).tar.gz /var/jenkins_home
# 仅备份配置
tar -czvf jenkins_config_backup_$(date +%Y%m%d).tar.gz /var/jenkins_home/jobs /var/jenkins_home/config.xml恢复
bash
# 停止 Jenkins
sudo systemctl stop jenkins
# 恢复备份
tar -xzvf jenkins_backup_20240101.tar.gz -C /
# 启动 Jenkins
sudo systemctl start jenkins常见问题
1. Jenkins 无法启动
- 检查端口是否被占用
- 检查 Java 版本
- 查看日志
/var/log/jenkins/jenkins.log
2. 插件安装失败
- 检查网络连接
- 更换插件源
- 手动下载插件安装
3. 构建失败
- 查看构建日志
- 检查源码管理配置
- 检查构建命令
4. 权限问题
- 检查 Jenkins 用户权限
- 检查文件系统权限
- 检查 Docker Socket 权限