Jenkins EC2插件无法启动节点问题排查请求

错误信息回顾 #

SlaveTemplate{description='jenkins-operations-node', labels='Jenkins DEV Node'}. Cannot provision - no capacity for instances: 0

以下是可能的故障原因及对应解决方法：

• 插件缓存未刷新
  开启Spot请求后，EC2插件可能缓存了错误的容量评估数据，即使关闭Spot功能，缓存没有自动清理，导致错误持续触发。
  解决方法：重启Jenkins服务，或者进入「Manage Jenkins」→「Manage Nodes and Clouds」→「Clouds」找到EC2云配置，点击「Reload Configuration」强制刷新配置。

• Slave模板Spot配置残留
  关闭Spot请求时，模板内的部分隐性配置可能没完全清除（比如Spot价格阈值、实例优先级规则等），导致插件仍按Spot模式评估容量。
  解决方法：打开对应SlaveTemplate的配置页面，检查「Spot Instance Options」区域，确认所有Spot相关选项已彻底禁用；也可以导出模板配置文件，检查是否存在残留的spot相关字段，必要时直接新建一个干净的SlaveTemplate替换原有模板。

• EC2账户实例配额耗尽
  开启Spot请求时可能触发了EC2配额检查，当前区域的按需实例配额可能已用完，或者未终止的Spot请求占用了配额资源未释放。
  解决方法：登录AWS控制台，进入「EC2」→「Limits」页面，检查对应实例类型的按需/Spot实例配额是否为0；若配额不足，提交配额提升申请；同时在「Spot Requests」页面清理所有未终止的Spot请求。

• 插件版本兼容性bug
  开启Spot功能可能触发了EC2插件的潜在bug，即使关闭Spot后，bug仍影响容量评估逻辑。
  解决方法：检查EC2插件版本，若不是最新稳定版，升级到最新版本；如果升级后问题依旧，回退到之前能正常运行的旧版本。

• 目标实例类型无库存
  Slave模板指定的实例类型在当前AWS区域可能没有按需实例库存（之前依赖Spot实例补充容量），关闭Spot后自然没有可用实例供调度。
  解决方法：在AWS EC2控制台验证该实例类型在目标区域是否有按需实例可用，若没有，更换为有库存的实例类型。

内容的提问来源于stack exchange，提问作者prosto.vint