Jenkins安装与配置详细教程
Jenkins安装与配置详细教程
Jenkins 是一个开源的自动化服务器，主要用于持续集成（CI）和持续交付（CD）。它可以自动化软件开发过程中的各个步骤，帮助开发者快速构建、测试和部署应用程序。Jenkins 支持大量插件，可以与各种开发工具和平台无缝集成。本文将详细介绍如何安装和配置 Jenkins。
1. 安装 Jenkins
1.1 准备工作
在开始安装之前，需要确保你的系统满足以下要求：
- Java：Jenkins 是用 Java 编写的，因此必须在系统上安装 Java 运行环境（JRE）或 Java 开发工具包（JDK）。
- 操作系统：Jenkins 可以安装在 Linux、macOS 和 Windows 系统上。
1.2 安装 Jenkins
1.2.1 在 Linux 上安装 Jenkins
-
安装 Java：
Jenkins 要求 Java 1.8 或更高版本。如果你的系统上还没有安装 Java，可以使用以下命令安装： -
对于 Ubuntu/Debian 系统：
bash
sudo apt update
sudo apt install openjdk-11-jdk -
对于 CentOS/RHEL 系统：
bash
sudo yum install java-11-openjdk
安装完成后，使用 java -version 命令确认 Java 是否安装成功：
bash
java -version
- 添加 Jenkins 仓库：
首先，下载并安装 Jenkins 仓库密钥：
bash
wget -q -O - https://pkg.jenkins.io/jenkins.io.key | sudo tee /etc/apt/trusted.gpg.d/jenkins.asc
然后，添加 Jenkins 仓库源：
-
对于 Ubuntu/Debian 系统：
bash
sudo sh -c 'echo deb http://pkg.jenkins.io/debian/ / > /etc/apt/sources.list.d/jenkins.list' -
安装 Jenkins：
更新本地包数据库，并安装 Jenkins：
bash
sudo apt update
sudo apt install jenkins
- 启动 Jenkins：
安装完成后，启动 Jenkins 服务：
bash
sudo systemctl start jenkins
- 检查 Jenkins 是否运行：
使用以下命令查看 Jenkins 服务状态：
bash
sudo systemctl status jenkins
如果一切正常，你应该看到 Jenkins 正在运行。
1.2.2 在 macOS 上安装 Jenkins
-
安装 Homebrew：
Homebrew 是 macOS 上常用的包管理工具。如果你还没有安装 Homebrew，可以使用以下命令安装：
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
使用 Homebrew 安装 Jenkins：
使用 Homebrew 安装 Jenkins：
bash
brew install jenkins-lts
- 启动 Jenkins：
安装完成后，可以通过以下命令启动 Jenkins：
bash
brew services start jenkins-lts
1.2.3 在 Windows 上安装 Jenkins
-
下载 Jenkins 安装包：
访问 Jenkins 官方网站 Jenkins 下载页面 下载适用于 Windows 的安装包。 -
运行安装程序：
下载完安装包后，双击运行.msi文件，按照向导步骤进行安装。 -
启动 Jenkins：
安装完成后，Jenkins 会自动作为 Windows 服务启动，你可以通过浏览器访问http://localhost:8080来检查 Jenkins 是否成功启动。
2. 配置 Jenkins
2.1 解锁 Jenkins
首次启动 Jenkins 时，它会要求你解锁。按照以下步骤操作：
-
获取解锁密码：
在终端中输入以下命令查看 Jenkins 安装目录中的初始管理员密码： -
对于 Linux 系统：
bash
sudo cat /var/lib/jenkins/secrets/initialAdminPassword -
对于 macOS 系统：
bash
cat /Users/$(whoami)/.jenkins/secrets/initialAdminPassword -
对于 Windows 系统：
初始密码文件位于C:\Program Files (x86)\Jenkins\secrets\initialAdminPassword。 -
解锁 Jenkins：
在浏览器中打开http://localhost:8080，输入获取的解锁密码，点击“继续”按钮。
2.2 安装推荐插件
解锁 Jenkins 后，系统会提示你选择是否安装推荐的插件。建议选择“安装推荐插件”，这样可以自动安装一些常用插件，方便后续配置和使用。安装过程可能需要一些时间，取决于网络速度和插件数量。
2.3 创建管理员账户
插件安装完成后，系统会要求你创建一个管理员账户。填写用户名、密码、全名和邮箱地址，然后点击“保存并继续”按钮。
2.4 配置系统设置
-
配置系统信息：
进入 Jenkins 主页面，点击左侧的“管理 Jenkins” > “系统配置”。在这里，你可以配置 Jenkins 的全局设置，包括 Jenkins 主机名称、JVM 参数、系统环境变量等。 -
配置 Jenkins 工作目录：
在“系统配置”页面，你可以修改 Jenkins 的工作目录路径，设置构建存储路径等。通常，默认设置即可，除非有特殊需求。
3. 使用 Jenkins 构建项目
3.1 创建一个新的 Jenkins 任务
-
创建新任务：
在 Jenkins 首页，点击“新建任务”。输入任务名称，选择构建类型（如自由风格项目、流水线等），然后点击“OK”。 -
配置任务：
在新建任务页面，配置任务的各个选项，如： - 源代码管理：你可以配置从 Git、SVN 等版本控制系统获取源代码。
- 构建触发器：可以设置触发构建的条件，如定时构建、Git 推送触发等。
- 构建环境：可以配置构建前的环境准备工作，如设置环境变量、清理工作区等。
-
构建步骤：配置实际的构建过程，比如运行构建脚本、执行 Maven/Gradle 构建等。
-
保存并构建：
配置完成后，点击“保存”按钮，然后在任务页面点击“立即构建”按钮，开始构建任务。
3.2 配置构建后操作
-
构建后操作：
配置构建完成后需要执行的操作，如发布构建产物、发送通知等。可以在“构建后操作”部分进行配置。 -
通知设置：
Jenkins 支持多种方式发送构建通知，如邮件、Slack、HipChat 等。你可以配置相关插件，及时了解构建的状态。
4. 安装和管理 Jenkins 插件
Jenkins 插件可以极大地扩展其功能。你可以通过以下步骤安装插件：
-
安装插件：
进入“管理 Jenkins” > “管理插件”，在“可用”标签页中，搜索你需要的插件并点击“安装”。 -
更新插件：
在“已安装”标签页中，可以查看所有已安装的插件，并进行更新。 -
卸载插件：
如果某个插件不再需要，可以在“已安装”标签页中选择插件并点击“卸载”按钮。
5. Jenkins 安全配置
5.1 配置安全设置
Jenkins 提供了多种安全选项，包括用户认证、权限控制、访问限制等。你可以在“管理 Jenkins” > “系统配置”中配置相关的安全设置。
- 启用安全性：默认情况下，Jenkins 没有启用安全性，任何人都可以访问和操作 Jenkins。你可以通过启用安全性来限制访问。
- 配置身份验证方式：Jenkins 支持多种身份验证方式，如内置用户数据库、LDAP、GitHub OAuth 等。
5.2 配置授权策略
Jenkins 允许你为不同的用户或用户组分配不同的权限。你可以选择“Matrix-based security”来为每个用户配置不同的操作权限。
6. Jenkins 的备份与恢复
Jenkins 数据包括配置信息、构建记录、插件等内容。为了防止数据丢失，建议定期进行备份。可以手动备份 Jenkins 工作目录下的内容，或者使用插件来实现自动备份。
6.1 手动备份
你可以通过复制 Jenkins 的工作目录来进行备份。常见的工作目录路径如下：
- Linux：
/var/lib/jenkins/ - macOS：
/Users/$(whoami)/.jenkins/ - Windows：`C:\Program Files (x86)\