Jenkins入门配置
准备工作
Jenkins是用Java开发的项目,这使得它拥有良好的跨平台性,这里只介绍最为简单的windows平台下安装的流程。 需求:
- svn(Jenkins已集成相关功能)
- java(略过不提,请自行安装)
- maven(略过不提,请自行安装)
- Jenkins
windows平台下安装Jenkins
1.下载jenkins
- 1.Jenkins官网下载页:https://jenkins.io/download/
- 2.解压、安装在.msi
- 3.安装完成后,会弹出该服务首页,即http://localhost:8080(默认8080端口)
- 4.在安装目录下找到.secretsinitialAdminPassword(无后缀),使用文本编辑器打开(密码一般是32位数字+字母混合)复制到页面进行用户登录
- 5.登录成功后,选择安装推荐插件,等待安装完成
- 6.设置管理员信息,可跳过,跳过则继续使用initialAdminPassword中的密码
注意事项: 默认端口冲突
起因:Jenkins安装成功后,Jenkins项目在会以服务的形式在后台运行,但是默认端口容易与其他项目冲突,此时Jenkins将无法启动,并无任何提示,表现为安装成功后不弹出Jenkins主页。
解决方式: 在Jenkins的安装目录下找到.jenkins.xml ,在第41行找到--httpPort=8080,修改为不冲突,打开/重启 服务即可
2.权限配置:
匿名访问权限
当需要使用批处理或其他方式启动Jenkins构建任务时,必须先在
系统管理-->全局安全配置-->选择登录用户可以做任何事-->勾选Allow anonymous read access
此时便支持匿名构建任务
这种方式存在风险,但是可以在脚本或其他方式远程触发Jenkins Job项目构建时省去认证环节,这里我不推荐开启匿名构建,后面会介绍插件来远程认证并触发Job构建
3.JDK配置
Jenkins-->系统管理-->全局工具配置-->JDK-->新增JDK
别名:别名尽量注明版本号,方便识别
JAVA_HOME:Jdk配置参数,填写jdk根目录位置(如果已存在JDK,不要勾选自动安装)
4.Maven配置
Jenkins-->系统管理-->全局工具配置-->Maven-->新增Maven
Name:识别,注明版本号
MAVEN_HOME:Maven配置参数,填写Maven根目录位置(如果已存在Maven,不要勾选自动安装)
5.插件安装
联网情况下安装
Jenkins-->系统管理--->管理插件,进入插件下载、安装界面
搜索Subversion Plug-in实现svn的功能
选择下载待重启后安装或直接安装
6.创建基本功能项目
1.创建项目:新建项目,选择Jenkins-->新建项目-->命名-->构建一个自由风格的软件项目-->确认
2.基本配置:
1.参数化构建过程:接收参数,并用于构建
2.重试次数:Jenkins从代码库迁出代码失败时,会重试的次数(默认间隔十秒重试一次)
3.使用自定义的工作空间:设置工作空间位置
3.迁出代码设置
1.Repository URL:填项目的svn地址
2.Credentials:选择svn的账号与密码,如果没有,选择Add新建一个,User为svn账号,password为svn密码,其他如非需要可以选择不填
3.Local module directory:可不改动(默认为根目录.,如果已经自定义了工作空间,这里为工作空间的根目录,否则为默认工作空间)
4.Check-out Strategy:看情况选择,如果Jenkins处于几乎不会被关闭,构建对源代码无修改时可使用Use 'svn update' as much as possible,放Jenkins有可能被强制重启或构建会修改源代码时,应使用Use 'svn update' as much as possible,with 'svn revert' before update,可以有效避免svn更新失败
4.代码编译
1.构建-->增加构建步骤-->Invoke top-level Maven targets
2.Maven Version:选择在全局配置中配置的版本
3.Goals:maven编译指令,这里填clean install -DskipTests
4.POM:这里为编译时使用的pom.xml在目录下的相对位置
5.Settings file:该选项可以选择自定义maven的配置文件,
选择Settings file in filesystem
需要使用的settings.xml的绝对路径,如D:apache-maven-3.5.0confsettings.xml
5.文件迁移、发布
1.构建-->增加构建步骤-->Execute Windows batch command
2.命令:windows批处理指令,写在这里运行的指令不会有新的窗口,即使使用start 、cmd等指令,这里推荐使用start指令,否则只有当批处理运行结束时该构建才会被当做结束,例如
copy D:workspacejenkins_Test argetjenkins_test-0.0.1-SNAPSHOT.jar D:Testjarjenkins_test-0.0.1-SNAPSHOT.jar
start java -jar D:Testjarjenkins_test-0.0.1-SNAPSHOT.jar
先拷贝出去再进行部署可以避免代码迁出时或maven编译时遇到文件占用异常导致构建失败,并且使用批处理发布可以不依赖插件和tomcat