Jenkins系列之-—05 节点配置

Posted 2020-12-24 liuyitan

一、节点配置

1. 进入【系统管理】-【节点管理】-【新建节点】，录入节点名，选择Permanent Agent，下一步录入节点详细配置信息，如下：

• Name：节点名称
• Description：节点描述
• # of executors：并发构建数(根据机器的性能定，单颗四核cpu建议不要超过5)
• Remote FS root：节点的根目录(注意：如果目录不存在，会自动创建目录。你必须对该目录有读写权限，不然会报错：hudson.util.IOException2: Failed to copy xxxx)
• Labels：标记(又叫做标签)用来对多节点分组,标记之间用空格分隔.
• 用法：尽可能的使用这个节点/只允许运行绑定到这台机器的Job(二选一)
• Launch method：运行方式有四个选项。建议选择第1、2种方式配置。详细如下：

1)   【推荐】Launch slave agents on Unix machines via SSH  
在Unix(包括Linux)机器上通过SSH通道连接节点 (适用于Unix和Linux)

　　Host：节点主机的ip地址
　　Credentials：凭据(如果为空或者不可选择，请在系统管理→Manage Credentials中配置。Manage Credentials的配置非常简单，这里就不在描述了。Manage Credentials配置完成后，需刷新节点配置页面才会显示。)
　　Port：端口默认22
　　JavaPath：[可选]JDK路径，默认和master节点相同。路径必须指定到Java程序，如：/path/bin/java
　　JVM Options：[可选]JVM可选参数
　　Prefix Start Slave Command：[可选]不知道干什么用的参数
　　Suffix Start Slave Command：[可选]不知道干什么用的参数
　　测试可以使用Unix命令，会自动拼接在[SSH] Starting slave process:[Prefix Start Slave Command] cd ‘/path‘ && /path/bin/java -jar slave.jar [Suffix Start Slave Command]

2)   【推荐】Launch slave agents via Java Web Start  
通过Java Web Start连接节点 (适用于所有支持Java程序的系统)

　　Tunnel connection through：[可选]在端口转发这种情况下使用
　　JVM options：[可选]JVM可选参数
　　这种方法的缺点：如果该节点宕机了，主节点无法自动重启它。

3)   Launch slave via execution of command on the Master 
通过主节点的控制台连接节点

　　该选项下Launch command的帮助。
　　Jenkins的开发者考虑到某些企业可能有N++ 个节点(N>=你猜!)。如果在界面配置，那么升级版本之类的操作会很麻烦。所以允许你使用shell脚本去配置管理节点(貌似很方便的样子)。具体的脚本需要你自己写。
　　Launch command：Unix运行脚本的命令，如：sh aaa.sh

4)   【不建议使用】Let Jenkins control this Windows slave as a Windows service  
让Jenkins节点添加到Windows服务中

　　 这个选项比Launch slave agents via Java Web Start添加为服务更加稳定(帮助文档是这么说的)。采用这种运行方式，那么这个系统不能登录任何用户。这种配置方式是非常的麻烦和折腾。具体请查看 点我去看帮助
　　Administrator user name：域管理员账号
　　Password：密码
　　Host：节点主机IP或者域名
　　Run service as：
　　　　Use Local System User：使用本地系统用户
　　　　Log on using a different account：使用不同的用户登录
　　　　　　User name：账号
　　　　　　Password：密码
　　　　Use Administrator account given above：使用上面的用户登录
　　Path to java executable：[可选]JDK路径。必须指定到Java程序,如：C:Windowssystem32java.exe
　　JVM options：[可选]JVM可选参数

• Availability：

1)  Keep this slave on-line as much as possible：尽可能保持节点在线【推荐】

2)  Take this slave on-line according to a schedule：根据时间表在线(类似于Linux的定时任务)

• Startup Schedule：类似于Linux定时任务的时间
• Scheduled Uptime：超过任务时间后延迟多少分钟离线。如果此数值大于在线总时间(单位：分)，就会一直保持在线【必须为数字】
• Keep on-line while jobs are running：当有Job在构建时(到达离线时间了)继续保持在线

3)  Take this slave on-line when in demand and off-line when idle：让Jenkins根据需求自动连接或者离线

• In demand delay：告诉Jenkins如果有Job需要在此节点构建，需要在任务队列等待多长时间才会进入任务状态进行构建【必须为数字】
• Idle delay：告诉Jenkins多少分钟内如果没有Job需要构建就离线【必须为数字】
• Node Properties： 

1.  Environment variables:配置环境变量(可以在脚本中引用，好方便啊(^o^)/~)
2.  Tool Locations：工具的目录【推荐】。说明：可以替换系统设置的各种工具目录。如：JDK目录、Ant目录、Maven目录等。好处就是在不更改Job配置的情况下，不同环境(如：Windows和Linux) Job配置通用。好方便啊(^o^)/~

【注意】：默认情况下启动方式只显示第三种类型。在【系统管理】-【Configure Global Security】中，TCP port for JNLP agents ，禁用换成随机选取，则显示第二种

 

 二、节点连接

一、通过SSH连接node

此种方式连接时，master和slave必须是能够通过ssh进行连接的，必须有slave机器的账号才行，但不要求必须是root账号。 

这种方式的前提是需要安装SSH Slaves plugin插件。 

有如下两种方式Add Credentials： 
1）通过Username with password方式 
需要知道slave机器的用户名和密码，见下图： 

2）通过SSH Username with private key方式 

需要先在master机器上生成ssh key pair。生成的 public key放到slave机器 ~/.ssh/authorized_keys里面。

chmod 600 ~/.ssh/authorized_keys。 
然后，添加连接slave的credential，见下图

 

Username填写在master上生成key pair时使用的用户名。 

Private key选择From the jenkins master ~/.ssh 

 

【扩展知识】 
Jenkins的SSH Credentials Plugin插件，可以集中管理这些ssh 的key。安装完这个插件，可以在Jenkins上看到这样的页面 

 这个页面可以对credentials进行添加、删除、修改等操作。在这里设置的credentials在jenkins的其他需要credentials的地方，可以通过下拉菜单选择使用，比如添加slave时，可以直接在Credentials下拉菜单里选择对应的credential就行： 

还有git clone代码时： 

 
此时一定要把在master上生成的 public key添加到github账号的的Profile setting页面里的SSH Keys Settings中。

2、通过JNLP连接node

将slave主动连接master。 

 

有两种方式启动：

1.Launch agent from browser on slave  下载文件slave-agent.jnlp文件，双击打开。

一般用在Windows系统上，需要javaws.exe(在Java的bin目录中可以找到)程序才能打开。如果提示错误，请卸载JDK后重新安装。

点击左上角的File选择Install as a service就可以添加为Windows的服务了(默认开机自动启动)。

 

2.Run from slave command line  如果你配置了权限那么后面还有一串看不懂的随机Key

下载slave.jar到本地，然后进入存放slave.jar的目录，复制粘贴并运行 java -jar slave.jar -jnlpUrl http://xxxxx  即可启动。

slave.jar下载

三、节点使用

在job的配置页面，勾选Restrict where this project can be run，并且在Label Expression输入节点的标签名（一个标签有可能对应多台slave节点）,也可以输入slave节点的名称