WINDOWS
1. 安装JDK
JDK下载地址: http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html
选择对应系统的安装包下载
配置环境变量
新建JAVA_HOME系统环境变量,变量值处输入JDK安装目录,如 "D:\Program Files\Java\jdk1.8.0_66"
新建CLASSPATH变量,变量值为".;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar"
修改Path变量,在最后添加";%JAVA_HOME%\bin"
在cmd中输入"java -version",有版本信息返回,说明已添加成功
2.安装Ant
这里采用Ant1.9.6版作为Jenkins的构建脚本
Ant下载地址: http://apache.fayea.com//ant/binaries/apache-ant-1.9.6-bin.zip
下载完后直接解压缩即可。
配置环境变量
新建ANT_HOME系统环境变量,变量值处输入ANT安装目录,如 "D:\Program Files\Apache Software Foundation\apache-ant-1.9.6"
修改CLASSPATH变量,在最后添加";%ANT_HOME%\lib"
修改Path变量,在最后添加";%ANT_HOME%\bin"
在cmd中输入"ant -version",有版本信息返回,说明已添加成功
3.安装Maven
这里采用Maven3.3.9版作为Java代码的公共类库
Maven下载地址: http://mirrors.cnnic.cn/apache/maven/maven-3/3.3.9/binaries/apache-maven-3.3.9-bin.zip
下载完后直接解压缩即可。
配置环境变量
新建MAVEN_HOME系统环境变量,变量值处输入ANT安装目录,如 "D:\Program Files\Apache Software Foundation\apache-maven-3.3.9"
修改Path变量,在最后添加";%MAVEN_HOME%\bin"
在cmd中输入"mvn -version",有版本信息返回,说明已添加成功
4.安装Tomcat
这里采用Tomcat9.0.0版作为Jenkins的Web容器
下载地址: http://mirrors.hust.edu.cn/apache/tomcat/tomcat-9/v9.0.0.M3/bin/apache-tomcat-9.0.0.M3.exe
安装步骤
5.安装Jenkins
方法1:
jenkins.war下载地址: http://mirrors.jenkins-ci.org/war/latest/jenkins.war
将jenkins.war复制到D:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps目录下
配置环境变量
新建JENKINS_HOME系统环境变量,变量值处输入JENKINS安装目录,如 "D:\jenkins"
或者 编辑D:\Program Files\Apache Software Foundation\Tomcat 9.0\conf\context.xml,添加JENKINS_HOME环境变量。
访问Jenkins主页 http://localhost:8080/jenkins
方法2:
jenkins.exe下载地址: http://ftp.yz.yamagata-u.ac.jp/pub/misc/jenkins/windows-stable/jenkins-1.642.2.zip
解压运行 jenkins.msi
访问Jenkins主页 http://localhost:8080
6.运行jenkins有以下几种方式:
1:直接通过java -jar jenkins.war运行
对于这种启动方式,如果每次都通过命令来启动运行,非常不方便,所以,官方提供了Installing Jenkins as a Windows service,这样配置之后,jenkins开机就自启动了。** 这里有个注意点,如果开始通过命令行的方式指定了端口号,那么在Installing Jenkins as a Windows service之后端口号又重新变成了8080(真鸡八巨坑),修改jenkins.xml里面的端口然后重启jenkins服务即可。**
在配置为window service之后碰到一个问题,就是通过java -jar jenkins.war创建的账号和密码登录不上了,默认账号为admin,密码在secrets/initialAdminPassword,如果实在是忘记了,登录不上了,解决方法是到.jenkins目录下面找到config.xml文件,修改注释以下部分内容:
重启jenkins服务,这个时候就可以不用账号和密码进入了,然后可以通过如下方式创建账号和密码:参考资料
系统管理-->Configure Global Security-->勾选相关:
之后在系统管理选项中就会出现管理用户选项,进入就可以创建用户了。
2:部署到tomcat中运行(略)
7.用户权限管理:
1 插件依赖:Role Strategy Plugin
2 具体配置:参考官网
步骤备注:Manage Roles这里面主要配置一些角色,并给这些角色分配权限。比如下图,配置了三个角色,每个角色赋予相应权限:
实际操作中只能配置Global roles,其他的角色都不能登录,报错:没有Overall/Read权限。
Assign Roles:给用户分配角色,比如这里给lz_test01,lz_test02分配的角色为test
8.jenkins SVN,Gradle,android项目集成
1. 环境配置
要安装gradle和Android SDK,并配置好环境变量
2. 安装相关插件:可在线安装也可本地先下载好hpi文件然后上传到jenkins安装。
要安装的插件主要有Gradle plugin,Subversion Plugin(Subversion Plug-in),SVN Publisher plugin等
jenkins的相关插件列表戳这里
关于gradle版本的配置,详见这里如下图,里面有相关的脚本版本配置。
3. 创建一个工程:参考资料,主要就是配置工程SVN路径和账号密码,gradle命令等,项目名千万不能用中文字符
这里注意一下,如果主项目有依赖自己编写的库,并且主项目和依赖库不在同一个路径,这个配置稍微有点改动,首先要把主项目和所有的依赖都添加到modules中,然后设置好Local module directory
4. 构建项目
5. 邮箱配置
关于邮件配置,要注意的地方就是除了要配置如下信息
还要填写如下信息,并且两个地址要一致。
如果要把构建的安装包进行邮件发送,可以参考http://pissedoff-techie.blogspot.com/2015/11/how-to-configure-jenkins-to-send-build.html,主要就是安装Email-Ext plugin这个插件,然后在项目中配置构建后操作:
不要忘记设置Triggers
LINUX
1. Linux安装配置jdk环境
1.1、上传到 Linux 服务器;例如:
上传至: cd /usr/local
1.2、解压:
rpm -ivh jdk-8u111-linux-x64.rpm
1.3、环境变量配置
cd /etc
在etc下,找到 profile文件,增加如下如下配置:
#set java environment
JAVA_HOME=/usr/java/jdk1.8.0_111
CLASSPATH=.:$JAVA_HOME/lib.tools.jar
PATH=$JAVA_HOME/bin:$PATH
export JAVA_HOME CLASSPATH PATH
1.4 、配置生效
source /etc/profile
2. Linux安装配置maven环境
2.1、上传maven到 /usr/local 下
2.2、解压:
tar -zxvf apache-maven-3.3.9-bin.tar.gz
2.3、配置环境变量
进入etc目录下找到profile文件,增加如下环境变量配置:
#set maven environment
MAVEN_HOME=/usr/local/apache-maven-3.3.9
export MAVEN_HOME
export PATH=${PATH}:${MAVEN_HOME}/bin
2.4 、配置生效
source /etc/profile
2.5、查看配置是否成功
mvn -v
2.6、如果抛出权限不够,例如
-bash: /usr/local/apache-maven-3.3.9/bin/mvn: Permission denied
2.7、给maven授权
chmod a+x /usr/local/apache-maven-3.3.9/bin/mvn
3. Linux安装tomcat
3.1、上传至 /usr/local 目录下
3.2、解压
tar -zxvf apache-tomcat-7.0.75.tar.gz
3.3、修改tomcat端口号
找到 tomcat-->config-->server.xml
打开server.xml后修改【8005、8080、8009】其中8080为tomcat的端口号
第22行:8005
第71行:8080
第93行:8009
3.4、增加tomcat用户【用于jenkins部署发布用】
找到tomcat-->config-->tomcat-users.xml
打开后在之间增加如下用户信息:
4. Linux配置并启动 jenkins
4.1、上传jenkins.war到tomcat-->webapps下
4.2、进入tomcat-->bin目录下,使用Linux命令启动tomcat
./startup.sh
4.3、根据tomcat所在服务器ip地址和tomcat路径来访问jenkins项目
4.4、首次进入jenkins如要输入密码,密码位置:/root/.jenkins/secrets/initialAdminPassword
4.5、进入选择插件安装界面,选择第一个(Install suggested plugins)
4.6、插件安装完成之后,需要创建第一个用户,建议统一使用test或者admin
4.7、创建用户之后,就可以使用jenkins了
4.8、点击start using jenkins 进入jenkins
4.9、配置jenkins需要的maven、jdk路径
详情见截图:《1、全局环境配置.png》
4.10、配置安装插件
jenkins plugin
需要安装的插件:
•发布插件 Deploy to container Plugin 必须
•Maven插件 Maven Integration plugin必须
•git插件 Git plugin 这个根据实际情况,我用的是svn
•svn插件 Subversion Plug-in 这个jenkins自带已经安装过了,推荐安装时有显示
非必须安装插件:
•发送邮件插件 Email Extension Plugin
5. 项目配置:
5.1、配置svn项目地址和用户名密码
repossitory url为svn地址,下面有一个add按钮,填写svn用户名密码后保存
然后下拉选择,刚才配置的那个用户
5.2、配置清理并选择maven
root pom 中填写:pom.xml
goals and options中填写:clean install
5.3、配置maven清理
点击“add post-build step”选择“invoke top-level maven targets”
maven version选择maven(该maven是全局环境变量时配置的)
goals 中填写:clean package
5.4、配置部署容器
点击“增加构建后操作步骤”选择 "deploy war/ear to a container"
由于maven项目的war包是在target下,故下target/项目名.war
content path为访问路径
5.5、配置tomcat
点击“and container”添加容器,选择tomcat
由于我的是tomcat7故选择tomcat7
manager user name:填写配置tomcat-user对应的用户名
manager password:填写配置tomcat-user对应的密码
tomcat url :填写配置tomcat-user这个tomcat对应的服务器地址和该tomcat的端口号
例如:http://ip:tomcat端口号