Jenkins基础篇 系列之-—04 节点配置
一、节点配置
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:\Windows\system32\java.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：
- Environment variables:配置环境变量(可以在脚本中引用，好方便啊\(^o^)/~)
- 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节点的名称
