jenkins构建

jenkins构建与部署全流程指南

配置jenkins

配置全局工具

Jenkins 的全局工具配置允许你定义各种构建工具的路径，这对于后续的项目构建至关重要。进入 Jenkins 控制台，点击左侧菜单栏的 “Manage Jenkins”，然后选择 “Global Tool Configuration”。在这里，你可以配置 Maven、JDK、Git 等工具。根据自己的项目需求，指定这些工具的安装路径或让 Jenkins 自动安装。

配置-全局工具配置入口

插件管理

Jenkins 的强大之处在于其丰富的插件生态系统。以使用 Gitee 作为源代码管理为例，你需要安装 Gitee 插件：

进入 “Manage Jenkins”
选择 “Manage Plugins”
切换到 “Available” 选项卡
在右侧的 Filter 输入框中输入 “Gitee”
勾选搜索结果中的 Gitee 插件并点击 “Install without restart”

配置-插件管理入口

系统配置

安装完 Gitee 插件后，需要配置 Gitee 连接：

前往 Jenkins -> Manage Jenkins -> Configure System -> Gitee Configuration -> Gitee connections
在 “Connection name” 中输入标识名称，如 “Gitee”
Gitee host URL 中输入 Gitee 完整 URL地址： https://gitee.com （Gitee 私有化客户输入部署的域名）
配置 Credentials：
- 点击 “Add” 按钮，选择 Jenkins
- Domain 选择 “Global credentials”
- Kind 选择 “Gitee API Token”
- Scope 选择所需范围
- Gitee API Token 输入你的 Gitee 私人令牌，获取地址：https://gitee.com/profile/personal_access_tokens
- 为凭证设置 ID 和描述
- Credentials 选择配置好的 Gitee APIV5 Token
  - 点击 Advanced ，可配置是否忽略 SSL 错误（视您的Jenkins环境是否支持），并可设置链接测超时时间（视您的网络环境而定）
  - 点击 Test Connection 测试链接是否成功，如失败请检查以上步骤。

配置-系统配置

构建新项目

完成基础配置后，就可以开始创建新的构建项目了：

创建新项目

在 Jenkins 首页，点击 “New Item”
输入项目名称，选择 “Freestyle project” 并点击 “OK”

构建-入口

配置源码管理

在项目配置页面的 “GitHub 组织” 部分：

选择 Git
输入 Gitee 项目的 URL
选择之前配置的 Gitee 凭证
指定要构建的分支

构建-源码管理

配置构建步骤

以 Maven 项目为例：

在 “Build” 部分，点击 “Add build step” 并选择 “Invoke top-level Maven targets”
选择之前配置的 Maven 版本
在 “Goals and options” 中输入 “clean install”

配置完成后，点击 “Save” 保存项目配置。

构建-构建配置

执行构建

保存项目配置后，就可以手动触发构建：

在项目页面，点击左侧的 “Build Now”
构建过程中，可以点击左侧的构建编号查看构建进度
点击 “Console Output” 查看详细的构建日志

构建-开始构建

构建的时候可以查看构建日志

点击构建的项目序号

构建

点控制台输出就可以看到构建的日志了

构建-控制台输出

构建完成之后可以看到工作空间中会有构建完成的项目

构建-工作空间

部署应用

Jenkins 支持多种部署方式，下面介绍 WAR 包和 JAR 包的部署方法。

war包部署

WAR 包通常部署到 Servlet 容器如 Tomcat 中。首先需要安装 “Deploy to container” 插件：

进入 “Manage Plugins”
安装 “Deploy to container” 插件

部署-插件

回到项目的配置中，增加构建后操作步骤

然后在项目配置中添加构建后操作：

在项目配置页面，滚动到 “Post-build Actions” 部分
点击 “Add post-build action” 并选择 “Deploy war/ear to a container”

部署-构建后操作
配置 WAR 文件路径和目标容器

部署-部署配置
需要在 Tomcat 的 tomcat-users.xml 中配置用户权限：

<!-- jenkins使用 -->
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<user username="jenkins_user" password="tomcat" roles="manager-gui,manager-script,manager-jmx,manager-status"/> 

配置完成之后启动tomcat即可

jar包部署

JAR 包的部署通常通过归档成品实现：

在项目配置的 “Post-build Actions” 部分
选择 “Archive the artifacts”
在 “Files to archive”选择需要存档的文件，我这里使用的是**/target/*.jar

jar包归档
构建完成后，JAR 包会被归档到 Jenkins 服务器

归档文件

这样，通过 Jenkins 你就可以实现从代码拉取、构建到部署的全自动化流程。