Jenkins - 安装

Jenkins - 安装指南

下载 Jenkins

Jenkins 的官方网站是 https://www.jenkins.io/。导航到下载页面：https://www.jenkins.io/download/

通常你会找到两个主要的发布分支：

LTS (长期支持): 推荐用于生产环境的稳定版本。更新频率较低，但会接收关键错误和安全修复。
周版本: 包含最新特性和更新，适用于测试或优先考虑最新功能而非稳定性的环境。

根据你的需求选择合适的发布分支。你可以下载：

通用 Java 包 (.war): 平台无关，可独立运行或部署到 Servlet 容器中。
平台特定软件包: 适用于 Docker、Windows、macOS 和各种 Linux 发行版 (如 Debian/Ubuntu, Red Hat/CentOS/Fedora 等) 的安装程序或软件包。它们通常会将 Jenkins 设置为服务运行。

在本指南中，为简单起见，我们将重点介绍通用 .war 文件。

启动 Jenkins (使用 .war 文件)

确保你已安装兼容的 Java 运行时环境 (JRE) (推荐使用 Java 11 或 17 - 请查阅当前 Jenkins 文档了解具体要求)。
打开你的终端或命令提示符。
进入你下载 jenkins.war 文件的目录。
运行命令：

java -jar jenkins.war --httpPort=8080

(如果需要，你可以将 8080 修改为其他端口)。

Jenkins 将使用内嵌的 Jetty Web 服务器启动。你会在控制台输出中看到日志消息，包括：

INFO: Jenkins is fully up and running

注意：默认情况下，Jenkins 将其数据存储在用户主目录下的 .jenkins 目录中。你可以使用 JENKINS_HOME 环境变量或系统属性修改此路径。详情请参阅配置章节。

初始设置向导

Jenkins 启动后，打开你的 Web 浏览器并导航到 http://localhost:8080 (或你指定的端口)。
解锁 Jenkins: 系统会提示你输入初始管理员密码。Jenkins 在启动期间的控制台输出中会显示此密码文件的路径 (initialAdminPassword)。从该文件中复制密码并粘贴到浏览器字段中。

控制台输出示例，显示密码位置：

*************************************************************

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

[Long alphanumeric password string here]

This may also be found at:
/path/to/your/jenkins_home/secrets/initialAdminPassword

*************************************************************

自定义 Jenkins (安装插件): 系统会要求你安装插件。你可以选择“安装推荐插件”(推荐给初学者) 或“选择要安装的插件”。
创建第一个管理员用户: 设置主要 Jenkins 管理员账户的用户名、密码、全名和电子邮件地址。
实例配置: 确认 Jenkins URL (通常会自动正确检测)。
Jenkins 已就绪: 设置完成！点击“开始使用 Jenkins”以访问 Jenkins 控制面板。

其他安装方法 (简要介绍)

Docker: 强烈推荐的方法。使用官方 Jenkins Docker 镜像 (例如 jenkins/jenkins:lts)。这简化了依赖管理和升级。

docker run -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts

原生软件包: 使用 apt、yum、brew 或 Windows 安装程序将 Jenkins 设置为系统服务，使其更易于管理 (启动/停止/重启)。

请参考官方 Jenkins 文档了解这些方法的详细说明：https://www.jenkins.io/doc/book/installing/