全部產品
Search
文件中心

Alibaba Cloud DevOps:主機部署問題

更新時間:Oct 23, 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'