Jenkins应用篇之Publish over SSH插件的使用

ゝ一纸荒年。 2022-06-11 03:08 534阅读 0赞

本文是jenkins应用系统文章的一部分，大部分来自工作和学习中的实践，部分内容来自官方文档和网友的文章，引用的文章会在“参考资料”部分附上原始链接。

# 依赖环境 #

1.  SSH，远程机开启SSH服务，允许Jenkins所在机器通过SSH服务登录到远程机执行脚本；可以设置SSH使用用户名/密码或通过key登录，SSH配置请查专门的资料这里不做说明
2.  JDK，本文部署的是JAVA应用，远程机上要用jdk环境，如非Java应用请忽略
3.  Tomcat或其他web容器，本文是以Tomcat为例，将应用部署到Tomcat中运行，远程机上安装Tomcat是必须的，如非Java应用请忽略，如用其他web容器请查找容器的安装资料

# 插件安装 #

打开Jenkins的“系统管理>管理插件”，选择“可选插件”，在输入框中输入“Publish over SSH”进行搜索，如果搜索不到可以在“已安装”里确认是否已经安装过。在搜索结果中选中“Publish over SSH”，点击页面的“直接安装”按钮，系统会自动安装，此插件安装后不需要重启Jenkins。如果插件安装成功在“系统管理>系统设置”会出现相关配置项。

![技术分享][Center]

# 插件配置 #

## 全局设置 ##

插件安装成功后使用前需要在“系统管理>系统设置”中进行配置，处如图：

![技术分享][Center 1]

每一项都可以被SSH Server的设置所覆盖，这样的设计有一个好处，在服务器环境比较规范的情况下，可以省去每个SSH Server分别配置的繁琐步骤。

### 参数说明 ###

*  Passphrase：SSH的密码  
    使用用户名/密码登录时为用户名的密码，使用私钥登录时为私钥的密码。  
    
 *  Path to key：SSH私钥的文件路径  
    私钥文件的路径，可以是绝对路径，也可以是相对$JENKINS\_HOME的相对路径  
    
 *  Key：私钥  
    私钥导出后的文本内容  
      
    如果“Key”和“Path to key”都设置，则“Key”的优先级较高，私钥的密码是“Passphrase”中设置的内容。  
    
 *  Disable exec：禁止在目标机上执行命令  
    勾选后将会忽略在Job配置中“Exec command”选项中设置的命令。Jenkins的说明文档中的“The Disable exec in the advanced settings for individual configurations will be ignored.”没有完全理解，从实际效果来看，只要“Disable exec”被勾选后，不管SSH Server中是否勾选“Disable exec”，Job中设置的命令都将补忽略。

## Publisher defaults ##

## SSH Server 配置 ##

SSH Server配置为Publish Over SSH中运程机的配置，分“基本设置”和“高级设置”两部分；“基本设置”主要是运程机IP、SSH用户名、SSH端口、连接超时时间等，“高级设置”和大部分“全局设置”中的选项相同。Job中使用的每一个运程机都要在这里进行配置。

### 基本设置    ###

SSH Server的基本设置如下图：

![技术分享][Center 2]

此处设置在使用“172.16.18.192-SSH”的所有设置中都生效，相当于此运程SSH节点的全局设置；基于与“全局设置”中同样的原因这里的设置在Job中也可以被覆盖，这在多用户进行远程操作时很有必要，如在172.16.18.192这台机器上有userA和userB两个用户分别用来部署"应用A"和“应用B”。

*  参数说明  
    
    
     *  Name  
        SSH节点配置的名称，在Job中使用Publish over SSH插件时，此名称将出现在“SSH Server”中“Name”的下拉列表中，如下图：  
        ![技术分享][Center 3]  
        
     *  Hostname  
        通过SSH连接到的机器的主机名或IP  
        
     *  Username  
        SSH服务使用的用户名，使用key进行连接时为key指定的用户名  
        
     *  Remote Derictory  
        运程机器上真实存在的目录，并且“Username”指定的用户要有访问此目录的权限，插件将把文件传送到此目录下。

### 高级设置 ###

高级设置里可以设置SSH端口、重试时间以及重新设置“全局设置”中的选项，由于做用相似，不再做重复说明，设置如下图：

![技术分享][Center 4]

# 在Jenkins中配置Job #

在Job设置中“增加构建步骤”里选择“Send files or execute commands over SSH”，即可以Job中使用Publish over SSH插件，配置如下图：

![技术分享][Center 5]

![技术分享][Center 6]

*  参数说明
    
     *  Name  
        “系统管理>系统设置”设置的SSH Sverver的名字列表。
     *  Source files  
        复制到运程机上的文件，运行表达式，如上图中的“\*\*/\*.war”。
     *  Remove prefix  
        文件复制时要过滤的目录，如上图中的target目录。
     *  Remote directory  
        文件得到到远程机上的目录，此目录是相对于“SSH Server”中的“Remote directory”的，如果不存在将会自动创建。
 *  Exec command  
    在这里可以填写在运程机器上执行的脚本，如：应用部署脚本。下图中的使用shell部署应用到tomcat的示例：  
    ![技术分享][Center 7]

# 参考资料 #

[插件配置和使用（http://www.cnblogs.com/zz0412/p/jenkins\_jj\_10.html）][http_www.cnblogs.com_zz0412_p_jenkins_jj_10.html]

[解决SSH证书问题（http://blog.csdn.net/jiang1986829/article/details/50955359）][SSH_http_blog.csdn.net_jiang1986829_article_details_50955359]

[插件配置和使用（http://my.oschina.net/yangting880815/blog/417661?fromerr=x1QONbYQ）][http_my.oschina.net_yangting880815_blog_417661_fromerr_x1QONbYQ]

[Center]: /images/20220611/94f489beb109499fa553638ca0190a40.png
[Center 1]: /images/20220611/00f856035859416291ca69bf53eb3ec9.png
[Center 2]: /images/20220611/f809a8df32a3464abdee6a20e13892fc.png
[Center 3]: /images/20220611/a6a4898a42d44149886d97276ab7c040.png
[Center 4]: /images/20220611/02c07a4c9d7a497e919a0c72b29249c3.png
[Center 5]: /images/20220611/1f098db98229490c8cda6b44390dafdb.png
[Center 6]: /images/20220611/abccb78d588e4719b36c8a92749b1610.png
[Center 7]: /images/20220611/04408c3827a04cb28ce38d840a6764f7.png
[http_www.cnblogs.com_zz0412_p_jenkins_jj_10.html]: http://www.cnblogs.com/zz0412/p/jenkins_jj_10.html
[SSH_http_blog.csdn.net_jiang1986829_article_details_50955359]: http://blog.csdn.net/jiang1986829/article/details/50955359
[http_my.oschina.net_yangting880815_blog_417661_fromerr_x1QONbYQ]: http://my.oschina.net/yangting880815/blog/417661?fromerr=x1QONbYQ