在软件开发过程中,自动构建是一个关键的环节,能够大大提高开发效率、降低错误率。本文将介绍如何在 Jenkins 中设置 GitHub 提交代码后的自动构建。
步骤 1: 安装和配置 Jenkins
首先,确保你已经在服务器上安装了 Jenkins。如果没有,请参考Jenkins 官方网站的安装指南进行安装。
步骤 2: 安装 GitHub 插件
- 在 Jenkins 控制台中,导航到“Manage Jenkins” -> “Manage Plugins”。
- 切换到“Available”标签,搜索并安装 GitHub 插件。
步骤 3: 生成 GitHub Token
- 在 GitHub 页面中,导航到
Settings
->Developer settings
->Personal access tokens
。 - 点击
Generate token
,并为该令牌授予适当的仓库访问权限(输入title,再勾选"repo"和"admin:repo_hook"
)。
步骤 4: 创建 Jenkins 任务
- 在 Jenkins 控制台中,选择“New Item”创建一个新任务。选择“Freestyle project”或“Pipeline”作为项目类型。
- 在任务配置中,选择你的版本控制系统(如 Git)。
- 提供 GitHub 仓库的 URL。
- 在“Credentials”中,添加之前生成的 GitHub Token 作为凭据。
步骤 5: 配置构建触发器
在任务配置中,选择适当的构建触发器。常见的是选择 “GitHub hook trigger for GITScm polling” 以便在 GitHub 上代码提交时触发构建。
步骤 6: GitHub Webhook 设置
- 在 GitHub 仓库中,导航到
Settings
->Webhooks
。 - 点击
Add webhook
。 - 在
Payload URL
中输入 Jenkins 的 webhook URL(Jenkins 服务器地址 +/github-webhook/
)。 - 在
Content type
中选择application/json
。 - 在
Which events would you like to trigger this webhook?
中选择适当的事件,常见的是选择Just the push event
。 - 确保启用 webhook,并点击
Add webhook
保存设置。
步骤 7: 保存 Jenkins 任务并测试
- 点击 Jenkins 任务配置页面底部的“Save”按钮保存配置。
- 手动触发构建,或者提交一次代码到 GitHub 仓库,触发 webhook 并自动触发 Jenkins 构建。
通过以上步骤,你已经成功设置了 GitHub 提交代码后的自动构建。在 Jenkins 控制台中,你可以查看构建历史、构建日志等详细信息。
这样一来,每次你在 GitHub 上提交代码时,Jenkins 将自动触发构建,确保你的项目能够始终保持最新、可靠的状态。
这只是一个简单的示例,你可以根据自己的经验和项目的实际需求来扩展和修改内容。希望这篇博文对你有帮助!