Skip to content

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 ​

  1. 访问 http://localhost:8080
  2. 获取初始密码:
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 SCM

3. 运行任务 ​

  • 点击「立即构建」
  • 查看构建日志
  • 查看构建结果

常用插件 ​

核心插件 ​

插件用途
Git源码管理
Maven IntegrationMaven 构建
Docker PipelineDocker 构建
Pipeline流水线支持
SonarQube Scanner代码质量检查

其他常用插件 ​

插件用途
NodeJSNode.js 环境
AWS CodeDeployAWS 部署
KubernetesKubernetes 部署
Email Extension邮件通知
Slack NotificationSlack 通知
Blue Ocean现代化 UI

全局工具配置 ​

配置 JDK ​

系统管理 → 全局工具配置 → JDK
→ 添加 JDK
→ 取消勾选"自动安装"
→ 设置 JAVA_HOME 路径

配置 Maven ​

系统管理 → 全局工具配置 → Maven
→ 添加 Maven
→ 设置 MAVEN_HOME 路径

配置 NodeJS ​

系统管理 → 全局工具配置 → NodeJS
→ 添加 NodeJS
→ 选择版本

系统配置 ​

邮件配置 ​

系统管理 → 系统配置 → 邮件通知
→ 设置 SMTP 服务器
→ 设置用户名和密码
→ 设置发件人地址

GitHub 配置 ​

系统管理 → 系统配置 → GitHub
→ 添加 GitHub Server
→ 设置 API URL 和 Credentials

Docker 配置 ​

系统管理 → 系统配置 → 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 权限