如何将现有Jenkins主服务器与新EC2实例建立连接

• 网络连通性校验 #

  • 首先确认EC2实例安全组的出站规则，允许**Jenkins主服务器对应端口（默认HTTP为8080、HTTPS为443、JNLP代理默认50000、SSH连接默认22）**的TCP访问
  • 登录EC2实例执行连通性测试命令，示例：

    # 测试Web端口连通性
    curl http://<替换为Jenkins主服务器IP/域名>:<替换为Jenkins服务端口>
    # 测试对应业务端口连通性
    telnet <替换为Jenkins主服务器IP/域名> <替换为对应端口>
    

  • 如果返回连接超时/拒绝，优先排查Jenkins主服务器的安全组入站规则、VPC网络ACL、跨VPC场景下的对等连接/路由表配置

• Jenkins节点配置校验 #

  • 确认Jenkins主服务器已提前添加该EC2实例为代理节点，节点配置的远程工作目录、标签、启动方式与EC2实际配置匹配
  • 若采用SSH方式启动代理：确认EC2实例的sshd服务处于运行状态，安全组开放22端口入站允许Jenkins主服务器IP访问，Jenkins节点配置中存储的SSH密钥/用户名密码凭据正确
  • 若采用JNLP方式启动代理：确认Jenkins全局安全配置中已开放JNLP代理端口，EC2实例可正常访问该端口，EC2上执行的代理启动命令中填写的Jenkins地址、节点密钥与主服务器节点详情页给出的信息完全一致

• Java环境校验 #

  • 执行java -version确认EC2上安装的Java版本与Jenkins版本兼容，代理端Java大版本不能低于Jenkins主服务器要求的最低版本
  • 执行echo $JAVA_HOME确认Java环境变量配置生效，未指向错误的安装路径

• 日志排查 #

  • 查看EC2实例上启动Jenkins代理时的终端报错信息，对应定位具体问题
  • 查看Jenkins主服务器系统日志，默认路径为/var/log/jenkins/jenkins.log，查找对应节点的连接报错记录

内容的提问来源于stack exchange，提问作者Bhushan