Jenkins 安装与基础配置

Jenkins 是一款开源的自动化工具，广泛用于持续集成（CI）和持续交付（CD）。以下是 Jenkins 的安装和基础配置步骤。

1. Jenkins 安装

Jenkins 可以在多种操作系统和环境中安装，包括 Linux、macOS、Windows 和 Docker 等。下面介绍几种常见的安装方式。

1.1. 使用 WAR 文件安装（适用于所有操作系统）

下载 Jenkins WAR 文件
从 Jenkins 官方网站下载最新的 WAR 文件：Jenkins下载页面.
运行 Jenkins
打开终端，进入存放 Jenkins WAR 文件的目录，执行以下命令启动 Jenkins：
```
java -jar jenkins.war
```
Jenkins 将默认运行在 http://localhost:8080，等待一段时间，直到看到启动信息。
初始解锁
初次运行 Jenkins 时，会要求输入解锁密钥。密钥保存在 Jenkins 的安装目录下，路径为：
```
~/.jenkins/secrets/initialAdminPassword
```
获取密码后，在浏览器中访问 http://localhost:8080，输入解锁密码即可。

1.2. 使用包管理器安装（Linux）

在 Ubuntu/Debian 上安装

安装依赖包

sudo apt update
sudo apt install openjdk-11-jdk

添加 Jenkins 仓库并安装 Jenkins

wget -q -O - https://pkg.jenkins.io/jenkins.io.key | sudo apt-key add -
sudo sh -c 'echo deb http://pkg.jenkins.io/debian/ stable main > /etc/apt/sources.list.d/jenkins.list'
sudo apt update
sudo apt install jenkins

启动 Jenkins 服务

sudo systemctl start jenkins
sudo systemctl enable jenkins

访问 Jenkins
Jenkins 默认运行在 http://localhost:8080，在浏览器中访问。

在 CentOS/Fedora 上安装

安装依赖包
```
sudo yum install java-11-openjdk
```

添加 Jenkins 仓库并安装 Jenkins

sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat/jenkins.io.key
sudo yum install jenkins

启动 Jenkins 服务

sudo systemctl start jenkins
sudo systemctl enable jenkins

访问 Jenkins
Jenkins 默认运行在 http://localhost:8080，在浏览器中访问。

1.3. 使用 Docker 安装

拉取 Jenkins 官方镜像
```
docker pull jenkins/jenkins:lts
```

运行 Jenkins 容器

docker run -d -p 8080:8080 -p 50000:50000 --name jenkins jenkins/jenkins:lts

访问 Jenkins
Jenkins 将在 http://localhost:8080 端口启动，打开浏览器访问。

2. Jenkins 基础配置

2.1. 初始化 Jenkins

解锁 Jenkins
第一次启动 Jenkins 时，需要输入初始的解锁密钥。在终端中运行以下命令来找到密钥：
```
cat /var/lib/jenkins/secrets/initialAdminPassword
```
或者在 Docker 中：
```
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
```
安装推荐插件
解锁 Jenkins 后，系统会要求你安装插件。你可以选择安装“推荐插件”或选择“自定义插件”进行手动选择。推荐插件包括 Git、Maven、Pipeline 等常用插件。
创建管理员用户
安装插件后，Jenkins 会提示你创建管理员账户，输入用户名、密码和其他基本信息。

2.2. 配置 Jenkins 系统

配置全局工具
配置常用工具（如 JDK、Maven、Git）：
- 进入 Jenkins 的“Manage Jenkins” -> “Global Tool Configuration”。
- 配置 JDK、Git、Maven 等工具的路径，以便在构建中使用。
配置系统设置
进入“Manage Jenkins” -> “Configure System”，进行系统级别的配置：
- 设置 Jenkins 主机名称（Jenkins URL）。
- 配置邮件通知服务（如 SMTP 设置）。
- 配置 Jenkins 的工作目录。
配置构建节点
Jenkins 可以通过添加构建节点（Slave）来分布式执行构建任务。进入“Manage Jenkins” -> “Manage Nodes and Clouds”进行配置，添加节点。

2.3. 创建 Jenkins 作业（Job）

新建构建作业
- 进入 Jenkins 的主界面，点击“New Item”。
- 输入作业名称，选择作业类型（如 Freestyle project、Pipeline）。
- 配置作业参数，如源码管理（Git）、构建触发器（定时构建、Webhooks 等）和构建步骤（如构建、测试、部署等）。
配置构建步骤
在作业配置页面，配置构建步骤，例如：
- 执行 Shell 脚本：构建前执行一些自定义的命令。
- 执行 Maven 构建：运行 Maven 构建命令，如 mvn clean install。
- 执行 JUnit 测试：配置测试框架，执行单元测试。
配置构建触发器
配置触发器，使得 Jenkins 自动执行构建任务。例如：
- 定时构建：通过 Cron 表达式设置定时构建。
- 源代码变更触发：每当 Git 仓库有代码提交时触发构建。

3. Jenkins 管理和维护

3.1. 管理 Jenkins 插件

安装和更新插件
- 进入“Manage Jenkins” -> “Manage Plugins”。
- 在“Available”选项卡中，查找并安装所需插件。
- 在“Installed”选项卡中，管理已安装的插件，并进行更新。
插件更新
定期检查插件更新，保持 Jenkins 环境的安全性和稳定性。

3.2. 备份和恢复 Jenkins 配置

备份 Jenkins 数据
- Jenkins 的数据（包括配置、作业、插件）通常保存在 /var/lib/jenkins 或 Docker 容器中的 /var/jenkins_home。
- 定期备份这个目录，防止数据丢失。
恢复 Jenkins 配置
恢复时，将备份的 Jenkins 数据复制到对应目录并重启 Jenkins。

3.3. 安全性配置

配置权限和用户角色
- 进入“Manage Jenkins” -> “Manage Users” 来管理用户。
- 配置权限和角色来限制用户的访问权限，确保 Jenkins 环境的安全性。
启用身份验证
- 在“Configure Global Security”中配置 Jenkins 身份验证（如 LDAP、GitHub 登录等）。