全部产品
Search
文档中心

云效:主机部署问题

更新时间:Oct 22, 2025

本文主要介绍使用云效在安装、主机部署接入中,常见的问题及解决方案。

主机代理问题 — 流水线 Runner

流水线 Runner 问题排查方法

重要

在开始处理主机部署、私有构建机申请环境失败问题之前请先按以下步骤确认机器上云效runner状态。

使用工具排查

只支持Linux系统

  1. 下载工具:

    wget "https://rdc-public-software.oss-cn-hangzhou.aliyuncs.com/runner/runnerStatusCheck" -O runnerStatusCheck
  2. 设置执行权限:

    chmod u+x runnerStatusCheck
  3. 执行工具:

    ./runnerStatusCheck
  4. 按照工具提示信息进行处理,示例如下。

    image.png

手动排查

  1. 检查系统 Linux 版本是否匹配。

    通过命令lsb_release -a查看 Linux 发行版本信息是否满足条件。目前云效统一 Runner 支持以下 Linux 发行版本:

    • centos 6+ 及以上

    • ubuntu 16.04+ 及以上

    • Alibaba Cloud Linux 2/3

  2. 检查 Runner service 状态和日志。

    通过命令ls -al /etc/systemd/system | grep runner查看 Runner 服务名称,通常 Runner 服务的名称为 runner-{版本}-{租户名称}.service,如下图所示。

    image

    通过命令systemctl status runner-{版本}-{租户名称}.service查看 Runner 服务状态,如果服务状态为 active(running),则服务正常,如下图所示。image

    另外,你也可以通过命令journalctl -u runner-{版本}-{租户名称}.service -a --no-pager --since '5 minutes ago' -f查看 Runner 执行日志。

构建/部署运行中,无日志或者主机状态显示为离线

  • 检查主机磁盘是否满了df -hl ,如果磁盘已满请尝试清理后重试。

  • 检查 Runner service 状态,如果状态非 active(running),通过以下步骤重启 Runner service:

    1. 获取服务名称,Runner 的服务名称格式为:runner-{版本}-{租户名称}.service

      systemctl | grep "runner-v" | awk '{print $1}'
    2. 使用获取到的服务名称替换以下命令中$SERVICE_NAME并执行,重启 Runner service。

      systemctl restart $SERVICE_NAME
  • 检查网络连通性是否正常。

    • 通过systemctl status runner-{版本}-{租户名称}.service查询 Runner service 状态,并截取 service 进程参数 --configPath=***,如下图所示。image

    • 查看 configPath 中URL cat {***}/config.yml | grep url

      image

    • 通过以下命令判断是否可以正常访问。

      # 注意替换下面命令中的url
      curl '{url}/api/v2/runner/storage/latest?os=linux&arch=amd64'