Email-Ext Plugin install ------ Jenkins Plugins

一、基本信息

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.