jenkins构建

jenkins构建与部署全流程指南

配置jenkins

配置全局工具

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

插件管理

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

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

系统配置

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

1. 前往 Jenkins -> Manage Jenkins -> Configure System -> Gitee Configuration -> Gitee connections
2. 在 “Connection name” 中输入标识名称，如 “Gitee”
3. Gitee host URL 中输入 Gitee 完整 URL地址： https://gitee.com （Gitee 私有化客户输入部署的域名）
4. 配置 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 测试链接是否成功，如失败请检查以上步骤。

构建新项目

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

创建新项目

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

配置源码管理

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

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

配置构建步骤

以 Maven 项目为例：

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

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

执行构建

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

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

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

点击构建的项目序号

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

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

部署应用

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

war包部署

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

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

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

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

1. 在项目配置页面，滚动到 “Post-build Actions” 部分

2. 点击 “Add post-build action” 并选择 “Deploy war/ear to a container”

   

3. 配置 WAR 文件路径和目标容器

   

4. 需要在 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 包的部署通常通过归档成品实现：

1. 在项目配置的 “Post-build Actions” 部分

2. 选择 “Archive the artifacts”

3. 在 “Files to archive”选择需要存档的文件，我这里使用的是**/target/*.jar

   

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

   

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