单个运行器的页面
运行器的各个选项卡、RTE 的模式、连接和设置,以及测试连接
选项卡
运行器的页面将其对话框的各个步骤显示为选项卡,并额外显示在其上运行的内容:
| 选项卡 | 内容 |
|---|---|
| 详情 | 名称和描述、默认 开关和 已启用 开关,每种类型的运行器都相同 |
| 类型 | 产品,与对话框中相同。对于 RTE 还有其 模式:数据库(已弃用)、入站 或 出站,即其 RTE 运行时使用的 RTE_MODE(参见 模式) |
| RTE | 仅限 RTE:以文字说明的 模式,以及在套接字模式下的 连接 及其设置(参见 RTE 的设置) |
| 凭据 | 它登录所用的 凭据,即连接 > 凭据 中与运行器类型相同的凭据,保存其令牌或登录信息以及其服务器的地址。RTE 的凭据保存其 RTE_TOKEN,以及 RTE 的地址(出站模式除外)。Semaphore、Rundeck 和 Jenkins 还有 项目 |
| 表单 | 在其上运行的表单及方式:指定 或 作为默认运行器。点击某一行会打开该表单 |
| 作业 | 最近在其上运行的 100 个作业,包括其状态、开始、结束和持续时间。点击某一行会打开该作业 |
每个选项卡都有自己的地址,例如 /settings/runners/<id>/rte,因此链接或书签可以直接打开它。没有该选项卡的运行器会打开 详情选项卡。
详情选项卡的两个开关会立即保存。默认 使该运行器成为其类型的默认运行器;将另一个运行器设为默认 即可将其关闭。已启用 打开或关闭运行器:关闭后,不会有任何作业发往它,即使它是该类型的默认运行器(参见 默认与已启用)。
请求加入的 RTE 打开时会显示一个黄色框 此 RTE 请求加入,其中包含其指纹和它关于自身的说明,以及 批准 和 拒绝(参见 批准 RTE)。配置种子 中的运行器会在其页面顶部 注明这一点,并且为只读。
RTE 的设置
RTE 选项卡让您可以从应用中管理 RTE,而无需在其运行的机器上编辑环境。
连接。 套接字模式的 RTE 会显示一个标记:已连接 或 未连接。悬停在 已连接 上时会显示持有其套接字的应用节点、 RTE 的版本以及其正在运行的作业数量。未连接 表示没有任何应用节点持有到它的套接字: 请检查 RTE 是否在运行、其地址或 APP_URL,以及其令牌。
设置。 出站或入站模式的 RTE 有四项设置,默认均为空:
| 设置 | 等同于 | 作用 |
|---|---|---|
| 最大并发作业数 | RTE_MAX_JOBS | 它同时运行多少个 playbook,默认为 10;0 表示不限制 |
| 作业文件缓存 | RTE_CACHE_MB | 它保留多少应用发来的作业文件,单位为 MB,默认为 1024;0 表示不保留 |
| 停止时的等待时间 | RTE_DRAIN_SECONDS | 正在停止的 RTE 等待其正在运行的 playbook 的时长,默认为 25 秒 |
| 作业文件 | RTE_FILES | 传输:应用随作业发送作业的文件。本地:它从自己挂载的文件夹运行 |
哪个值优先。 页面上的值优先于 RTE 上设置的同名变量。留空的字段使用 RTE 自身的变量, 否则使用默认值。页面会在每个字段下方说明是哪一种:覆盖 RTE 上设置的 RTE_MAX_JOBS(3)。,或 留空:RTE 使用其自身的 RTE_MAX_JOBS,3。;占位符显示留空字段所代表的值。
它们如何到达 RTE。 这些设置与运行器一起保存在应用的数据库中。应用会在 RTE 连接时以及每次保存时 通过 RTE 的套接字发送它们,RTE 会立即应用:缩小的缓存会被裁剪,新的上限从下一个 作业开始计算。RTE 只将它们保存在内存中,不写入任何文件:重启后,它会在连接时、运行第一个作业之前再次获取它们。
数据库模式(已弃用)的 RTE 没有套接字:它从自己的变量读取这些设置,选项卡中也会如此说明。
测试连接
右上角的按钮作用于已保存的运行器。
保存 旁边是 测试连接 和 删除,在凭据选项卡上还有 添加凭据,它会创建一个 与运行器类型相同的凭据并选中它。令牌或密码保存后永远不会再显示:请在凭据上修改它。
测试连接 检查运行器是否应答并接受其令牌或登录信息,并在一条消息中说明结果:运行器连接 正常,或失败的原因。它不运行任何作业。对于 RTE,它还会检查 RTE 使用的协议约定(参见 协议约定):
| RTE | 测试读取的内容 | 失败的情况 |
|---|---|---|
| 出站或入站 | 每个应用节点所记录的套接字持有者,以及 RTE 连接时所报告的内容。它不调用任何东西 | 没有任何应用节点持有到它的套接字:the RTE ‘<name>’ (outbound) is not connected: it has not dialed the app: check its APP_URL, its token and the network from the RTE to the app,对于入站 RTE 则为 no app node could dial it at <address>: check its RTE_URL, its token and the network from the app to the RTE。或者 RTE 使用的协议约定不是 3 |
| 数据库(已弃用) | 使用其令牌调用 RTE 的 /rte/v1/health | RTE 在其地址上没有应答、拒绝令牌,或使用的协议约定不是 2 |
RTE 选项卡的 连接 标记无需测试即可显示同样的套接字状态。