Jenkins安装

• Jenkins
  • 1. 特性
  • 2. 安装
    • 2.1. java 环境
    • 2.2. war 文件
    • 2.3. 基本配置
      • 2.3.1. 解锁 Jenkins
      • 2.3.2. 自定义 jenkins 插件
      • 2.3.3. 创建第一个管理员用户
      • 2.3.4. 完成
• 参考

该文记录 Jenkins 介绍及安装。

Jenkins

Jenkins 是开源 CI&CD 软件领导者，提供超过 1000 个插件来支持构建、部署、自动化，满足任何项目的需要。

	地址
官网	https://www.jenkins.io/
Github	https://github.com/jenkinsci/jenkins

1. 特性

• 持续集成和持续交付：作为一个可扩展的自动化服务器，Jenkins 可以用作简单的 CI 服务器，或者变成任何项目的持续交付中心。

• 简易安装：Jenkins 是一个基于 Java 的独立程序，可以立即运行，包含 Windows、Mac OS X 和其他类 Unix 操作系统。

• 配置简单：Jenkins 可以通过其网页界面轻松设置和配置，其中包括即时错误检查和内置帮助。

• 插件：通过更新中心中的 1000 多个插件，Jenkins 集成了持续集成和持续交付工具链中几乎所有的工具。

• 扩展：Jenkins 可以通过其插件架构进行扩展，从而为 Jenkins 可以做的事提供几乎无限的可能性。

• 分布式：Jenkins 可以轻松地在多台机器上分配工作，帮助更快速地跨多个平台推动构建、测试和部署。

2. 安装¹

Jenkins 通常作为一个独立的应用程序在自己的进程中运行。 Jenkins WAR 文件捆绑了 Winstone（一个 Jetty servlet 容器包装器），可以在任何操作系统或平台上启动，并支持 Jenkins 的 Java 版本。

2.1. java 环境

Jenkins 项目使用 Eclipse Temurin 作为其主要的 JDK，用于构建和测试基于 Java 的应用程序。

下载网址：https://adoptium.net/zh-CN/temurin/archive/

支持版本	长久支持	每周更新
Java 17 or Java 21	N/A	2.463 (June 2024)
Java 11, Java 17, or Java 21	2.426.1 (November 2023)	2.419 (August 2023)
Java 11 or Java 17	2.361.1 (September 2022)	2.357 (June 2022)
Java 8, Java 11, or Java 17	2.346.1 (June 2022)	2.340 (March 2022)
Java 8 or Java 11	2.164.1 (March 2019)	2.164 (February 2019)

根据要求本人以 java17 作为 java 环境。

# 1. 打开文件 /etc/profile
sudo vim /etc/profile

# 2. 设置环境
# 也可以不设置，后续 java 命令使用绝对路径
export JAVA_HOME=/home/august/software/jdk-17.0.12+7/
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar

# 3. 使生效
source /etc/profile

2.2. war 文件

Jenkins Web 应用程序 ARchive （WAR） 文件可以从命令行启动，如下所示：

1. 将 最新的 Jenkins WAR 文件 下载到计算机上的相应目录
2. 打开终端/命令提示符窗口到下载目录
3. 运行命令java -jar jenkins.war
4. 浏览并等待 Unlock Jenkins 页面出现http://localhost:8080

最好是安装最新的，长期支持版也不行，因为后面插件安装并不能自动适配版本(这一点很难受)，只会安装最新的，或者自己手动添加插件

默认路径是 /home/${USER}/.jenkins，httpPort 设置启动端口，默认 8080 端口，详细配置请看官网初始设置²

# 修改端口
java -jar jenkins.war --httpPort=9090

:information_source: 目前 2024/08/06 使用的最新版 Jenkins 2.470

2.3. 基本配置

2.3.1. 解锁 Jenkins

浏览到 http://localhost:8080（或安装时为Jenkins配置的任何端口），并等待 解锁 Jenkins 页面出现。

• 从 Jenkins 控制台日志输出中，复制自动生成的字母数字密码（在两组星号之间）。
• 或者根据提示复制文件中的密码实现解锁。

2.3.2. 自定义 jenkins 插件

解锁 Jenkins 之后，在 Customize Jenkins 页面内， 您可以安装任何数量的有用插件作为您初始步骤的一部分。

两个选项可以设置:

• 安装建议的插件 - 安装推荐的一组插件，这些插件基于最常见的用例.
• 选择要安装的插件 - 选择安装的插件集。当你第一次访问插件选择页面时，默认选择建议的插件。

如果您不确定需要哪些插件，请选择 安装建议的插件 。 您可以通过Jenkins中的Manage Jenkins > Manage Plugins 页面在稍后的时间点安装（或删除）其他Jenkins插件 。

Jenkins 最好最新版本，不然可能插件安装失败，失败可以继续后续手动安装卸载，自己适配版本。

2.3.3. 创建第一个管理员用户

最后，Jenkins 要求您创建第一个管理员用户。出现创建第一个管理员用户页面时， 请在各个字段中指定管理员用户的详细信息，然后单击保存完成。当 Jenkins 准备好了出现时，单击开始使用 Jenkins。

从这时起，Jenkins用户界面只能通过提供有效的用户名和密码凭证来访问。

2.3.4. 完成

最后就可以开始使用了

不过在使用之前建议将插件文件夹 /home/${USER}/.jenkins/plugins 进行打包备份，不然升级极容易不兼容。

cd /home/${USER}/.jenkins
tar -cvf plugins.tar.2.470 plugins/

参考

1. Installing Jenkins ↩︎

2. Initial Settings (jenkins.io) ↩︎