Jenkins - 配置

Jenkins - 系统配置

你的 Jenkins 实例的全局配置设置主要在“管理 Jenkins” → “系统” 下管理。你可以在此处定义系统范围的行为、工具位置和集成。

主要配置部分

Jenkins 位置

• Jenkins URL： 你的 Jenkins 实例的根 URL（例如，https://jenkins.example.com/）。为了让通知、webhook 和其他集成中的链接正常工作，此项必须设置正确。Jenkins 通常会自动检测此项，但请验证，特别是在反向代理后方的情况下。
• 系统管理员电子邮件地址： Jenkins 用于发送管理通知的电子邮件地址（例如，配置了低磁盘空间警告时）。也用作基本电子邮件通知的默认“发件人”地址。

主目录

显示 JENKINS_HOME 的路径，这是 Jenkins 存储所有数据（作业、构建、插件、系统配置）的地方。此处虽然显示该路径，但更改它通常需要在启动 Jenkins 之前设置 JENKINS_HOME 环境变量或 Java 系统属性，或修改服务配置文件。

确保 JENKINS_HOME 位于具有充足磁盘空间和良好 I/O 性能（推荐使用 SSD）的分区上至关重要。

Agent（节点）监控

配置 Jenkins 如何监控已连接 agent 的健康状况（例如，检查时钟差异、响应 ping）。

执行器数量

定义可直接在 Jenkins controller 机器上同时运行的构建数量。强烈建议将此设置为 0 或 1。 Controller 应该专注于协调构建，而不是执行它们。将构建分载到 agent 上（参见“分布式构建”章节）。

标签

查看和管理分配给 controller 节点本身的标签。

使用

控制作业如何分配给 controller（通常设置为“仅构建与此节点匹配的标签表达式的作业”，如果 controller 必须运行某些轻量级任务，则使用特定的标签）。

安静期

Jenkins 在检测到提交后等待多少秒才开始构建。这有助于在一次构建中处理多个相关提交。

SCM 检出重试次数

Jenkins 在源代码检出失败时应重试多少次。

全局属性

• 环境变量： 定义将作为环境变量提供给在 Jenkins 上运行的所有构建的键值对。对于设置全局路径或配置值很有用。
• 工具位置： 添加安装在 controller/agent 上、不受全局工具配置自动安装程序管理的工具的路径。如果您需要特定版本或全局工具配置未包含的工具，这将很有用。

Jenkins CLI

配置 Jenkins 命令行界面（CLI）的选项，例如传输协议（HTTP、SSH）。

电子邮件通知

配置内置基本电子邮件通知的全局 SMTP 服务器设置。输入你的 SMTP 服务器主机名、端口、默认用户电子邮件后缀以及所需的身份验证详细信息。点击“测试配置”以验证。

注意： 对于高级电子邮件功能（模板、触发器、附件），请安装并配置 ‘Email Extension’ 插件，而不是或除了本节之外。

其他插件配置

许多已安装的插件会在此处添加其全局配置部分。示例包括 Git、Maven、Gradle、Docker、Kubernetes、云提供商（AWS、Azure、GCP）、安全领域（LDAP、SAML）、通知服务（Slack、Teams）、制品仓库（Nexus、Artifactory）等的设置。

全局工具配置

通过“管理 Jenkins” → “全局工具配置”访问，此部分专门用于管理构建工具的安装（JDK、Maven、Gradle、Git、NodeJS 等）。对于每种工具，你可以：

• 添加多个命名安装： （例如，JDK 11、JDK 17）。
• 指定路径： 通过 *_HOME 指向预安装的工具位置。
• 启用自动安装： 让 Jenkins 自动下载和安装特定工具版本。这对于确保不同 agent 上的工具版本一致而无需手动安装非常有用。

Pipeline 可以使用 tools 指令引用这些命名的工具配置（例如，tools { jdk 'JDK 11'; maven 'Maven 3.8' }）。

正确配置这些全局设置对于 Jenkins 与你的环境、工具和外部服务正确交互至关重要。