一、基本信息
1. Email-Ext Plugin功能简介
支持Jenkins邮件发送时,自定义邮件内容功能。详情可以查看jenkins的wiki : https://wiki.jenkins-ci.org/display/JENKINS/Email-ext+plugin
2. 运行环境
系统环境: OS X 10.10.5
Jenkins版本: 1.532.2
二、安装
1. 分析
通过http://localhost:8080/pluginManager/available查看,未找到此插件,则无法用常规的Jenkins plugins安装方法。则email-ext plugin安装方法,基于此插件的jenkins wiki进行的,即:
- git clone git@github.com:jenkinsci/email-ext-plugin.git
- cd email-ext-plugin
- mvn clean install
2. 克隆email-ext-plugin源码
git clone命令的仓库,我们是无权限访问的。可以直接在github上搜索email-ext-plugin,可以找到此仓库,我们可以将其clone下来。运行如下命令:
cd /var/jenkins-local/jenkins-data/plugins到这个目录下。 -
git clone https://github.com/jenkinsci/email-ext-plugin.git
Note:查看git仓库remote信息,git remote -v
3. mvn工具 - 下载mvn, 可以查看mvn工具官网提供下载:https://maven.apache.org/download.cgi
我下载的方法是,根据它提供的ftp,下载了maven目录下所有的内容。其实,只需要下载maven目录下,maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.zip文件(3.3.3只是它的版本,可以根据自己的情况选择版本)或者apache-maven-3.3.3-bin.tar.gz。
其实,我个人偏好用apache-maven-3.3.3-bin.zip文件。因为,在Mac机上双击此文件便可以解压它。 - 安装:https://maven.apache.org/install.html
基于此链接下的安装,说明过于简洁。所以,我根据自己安装经验,将其详细,希望你不要像我一样走弯路。安装此此工具,对我而言,最困难的地方在于环境变量的设置。 - 配置mvn工具的环境变量
a. apache-maven-3.3.3目录的生成
我的做法是直接双击刚才下载的包apache-maven-3.3.3-bin.zip,解压后便会生成apache-maven-3.3.3目录。然后,我将此目录移动到/usr/local/这个目录下。当然,你也可以用官方文档所讲的方法来做这件事情。
unzip apache-maven-3.3.3-bin.zip 或者 tar xzvf apache-maven-3.3.3-bin.tar.gz
b. 配置环境变量$PATH
官方安装说明中:The installation of Apache Maven is a simple process of extracting the archive and adding the bin folder with the mvncommand to the PATH.。
这样的解说,真真是把我给迷惑住了,不知道啥意思。所以,通过苦苦尝试后,解说一下它的意思。bin folder是指生成的apache-maven-3.3.3目录下的bin目录,当初我一直在
质疑这个bin folder是指:/usr/bin? 或者 /bin? 或者 /usr/local/bin?。$PATH这个变量其实是指,apache-maven-3.3.3目录下的bin目录路径,对应我而言它是
/usr/local/apache-maven-3.3.3/bin。当然,你可以把apache-maven-3.3.3目录放到其它路径下,则对应的$PATH也会发生相应的变化。
c.配置环境变量$JAVA_HOME
mvn这个工具用到了java相关的东西,默认的Mac机上会安装JDK,但是没有配置$JAVA_HOME这个环境变量。
可以看到JDK相关的东西,被安装到此处:/System//Library/Java/JavaVirtualMachines/jdk1.7.0_25.jdk/Contents/Home
但是,从终端输入命令: echo $JAVA_HOME却为空。这是因为,OS X安装了JDK,但未配置此环境变量。此时,需要修改~/.bash_profile(有些mac 系统是~/.profile)文件。添加内容如下:
export JAVA_HOME=$(/usr/libexec/java_home)
export M2_HOME=/usr/local/apache-maven-3.3.3
export PATH=$PATH:$M2_HOME/bin
至于,是否需要添加$M2_HOME和$PATH我也不大确定,我在配置的时候,是添加了这两个环境变量。是否需要,大家可以根据自己的尝试,告诉我是否需要。保存你的修改后,再执行命令 source ~/.bash_profile
为什么JAVA_HOME=
/System//Library/Java/JavaVirtualMachines/jdk1.7.0_25.jdk/Contents/Home 不是这个,可以查看此链接说明:
http://apple.stackexchange.com/questions/96956/java-home-error-while-maven-build-osx-10-8-4-version
d.验证mvn工具是否安装成功
执行命令: mvn --version,如果输出如下,则证明已经安装成功了。
Apache Maven 3.3.3 (7994120775791599e205a5524ec3e0dfe41d4a06; 2015-04-22T19:57:37+08:00)
Maven home: /usr/local/apache-maven-3.3.3
Java version: 1.7.0_10, vendor: Oracle Corporation
Java home: /Library/Java/JavaVirtualMachines/jdk1.7.0_10.jdk/Contents/Home/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "mac os x", version: "10.10.5", arch: "x86_64", family: "mac"
4. 执行mvn clean install命令,安装email-ext plugin
说了那么多,终于快走到目的地了。这个命令需要花一些时间。注意的是,运行此命令时,通过pwd查看到的路径应该是在git clone email-ext plugin这个git仓库所在的路径。例如, 我将jenkins安装在/var/jenkins, 则jenkins插件应该在此目录下/var/jenkins-local/jenkins-data/plugins。那么,你运行mvn clean install的目录应该是/var/jenkins-local/jenkins-data/plugins/email-ext-plugin.