本文主要介绍使用云效在安装、主机部署接入中,常见的问题及解决方案。
主机代理问题 — 流水线 Runner
流水线 Runner 问题排查方法
在开始处理主机部署、私有构建机申请环境失败问题之前请先按以下步骤确认机器上云效runner状态。
使用工具排查
只支持Linux系统
下载工具:
wget "https://rdc-public-software.oss-cn-hangzhou.aliyuncs.com/runner/runnerStatusCheck" -O runnerStatusCheck设置执行权限:
chmod u+x runnerStatusCheck执行工具:
./runnerStatusCheck按照工具提示信息进行处理,示例如下。

手动排查
检查系统 Linux 版本是否匹配。
通过命令
lsb_release -a查看 Linux 发行版本信息是否满足条件。目前云效统一 Runner 支持以下 Linux 发行版本:centos 6+ 及以上
ubuntu 16.04+ 及以上
Alibaba Cloud Linux 2/3
检查 Runner service 状态和日志。
通过命令
ls -al /etc/systemd/system | grep runner查看 Runner 服务名称,通常 Runner 服务的名称为 runner-{版本}-{租户名称}.service,如下图所示。
通过命令
systemctl status runner-{版本}-{租户名称}.service查看 Runner 服务状态,如果服务状态为 active(running),则服务正常,如下图所示。
另外,你也可以通过命令
journalctl -u runner-{版本}-{租户名称}.service -a --no-pager --since '5 minutes ago' -f查看 Runner 执行日志。
构建/部署运行中,无日志或者主机状态显示为离线
检查主机磁盘是否满了
df -hl,如果磁盘已满请尝试清理后重试。检查 Runner service 状态,如果状态非
active(running),通过以下步骤重启 Runner service:获取服务名称,Runner 的服务名称格式为:
runner-{版本}-{租户名称}.service。systemctl | grep "runner-v" | awk '{print $1}'使用获取到的服务名称替换以下命令中
$SERVICE_NAME并执行,重启 Runner service。systemctl restart $SERVICE_NAME
检查网络连通性是否正常。
通过
systemctl status runner-{版本}-{租户名称}.service查询 Runner service 状态,并截取 service 进程参数 --configPath=***,如下图所示。
查看 configPath 中URL
cat {***}/config.yml | grep url。
通过以下命令判断是否可以正常访问。
# 注意替换下面命令中的url curl '{url}/api/v2/runner/storage/latest?os=linux&arch=amd64'