Jenkins 系列2 --- Node/Agent

发布时间 2023-07-09 22:34:07作者: 白马黑衣

一、概要

1. 承上启下

Jenkins系列

2. 概念

(1) Node/Agent

Node节点是Jenkins环境的重要组成部分,它用于执行Pipeline。

为了支持分布式CD,Jenkins设计了一个Controller对应多个Node/Agent的架构,Node可以与Controller部署在同一机器上,但是大部分情况应该是位于不同的机器上,甚至这些机器拥有不同的运行环境(Windows、Linux、Node.js、Java、Python)。

Controller和Node通过TCP或SSH连接,Controller的作用是管理、监控、编排(orchestrate)连接到自己的Node。Node的任务是接受Controller分配的任务并执行。

(2) Built-In Node

当我们安装完Jenkins登录后,首页右上方会给出提示:

意思是为了安全考量,推荐我们自己创建单独的Agent,而不是使用Jenkins自带的Node。

3. 消除警告

(1) 登录Jenkins,进入Dashboard->Manage Jenkins->Nodes and Clouds

(2) 此时,我们可以看到系统内建的Node

点击编辑,将其"Number of executors"调整为0。

保存后,右上角的警告随之去除。

二、部署

从链接方式的角度来看,Jenkins支持两种Node部署方式,一种是SSH(主要用于远程Node部署),另一种是TCP方式,本文选用后者。

1. 依赖

部署Node的依赖条件非常简单:

a. 宿主机有可用网络;

b. Java环境。

2. Agent TCP Port

进入Dashboard->Manage Jenkins->Security页面,找到Agents配置节:

将TCP port for inbound agents的选项设置为Random并Save。

3. 创建新Node

(1) 在Dashboard->Nodes页面,点击右上角的"+ New Node":

填写Node Name,选择Permanent Agent,点击"Create"。

(2) 进一步配置Node的其他属性

a. Name: 是必填项,不允许包含特殊字符(?*/\%!@#$^&|<>[]:;)

b. Number of executors: 同一时间执行Pipeline的个数,建议设置为Node所在服务器的CPU核心数;

c. Remote root directory: 是Node所在服务器分配给当前Node运行的目录,需要创建;

d. Labels: 标签是一个非常实用的功能,用于区分不同的Node类型。设想一下,公司应用端分为Windows和OS,两者的编译和打包环境不同,Node1用于Windows环境,Labels值为"Windows";Node2用于OS环境,Lables值为Apple。在Pipeline的定义文件中,可以指定Pipeline所用的Node Labels,当启动Pipeline时,Jenkins会自动寻找合适的Node执行Pipeline。

多个Labels用空格拆分。

4. 配置Node宿主机

(1) 创建目录

sudo mkdir -p /var/opt/Jenkins/nodes/Node1
sudo mkdir -p /var/opt/Jenkins/nodes/Node2

(2) 下载agent.jar

curl -sO https://jenkins.example.com/jnlpJars/agent.jar

(3) 启动Agent

java -Djavax.net.ssl.trustStore=/var/opt/java/cacerts -Djavax.net.ssl.trustStorePassword=changeit -jar agent.jar -jnlpUrl https://jenkins.example.com/computer/Node1/jenkins-agent.jnlp -secret "xxx" -workDir "/var/opt/Jenkins/nodes/Node1"

注意,如果Jenkins使用了自签名证书,则需要解决证书信任问题,可参考 Java自签名证书的信任处理

(4) 检查Node状态

三、参考

1. 官方

https://www.jenkins.io/doc/book/using/using-agents/