Drone CI 中文文档

在 Windows 上安装 Exec Runner

本文介绍了如何在 Windows 上安装 Exec Runner。Exec Runner 以二进制格式打包并作为 Github Release 分发。

下载 Exec Runner 程序

下载并解压二进制文件。

https://github.com/drone-runners/drone-runner-exec/releases/latest/download/drone_runner_exec_windows_amd64.tar.gz

配置 Exec Runner

Exec Runner 是使用环境变量文件配置的。环境文件应存储在以下路径:

C:\Drone\drone-runner-exec\config

该文件应使用语法 <variable>=value 将变量设置为指定值,并使用 # 表示注释。请注意,这不是 bash 文件。不支持 Bash 语法和 Bash 表达式。

DRONE_RPC_PROTO=https
DRONE_RPC_HOST=drone.company.com
DRONE_RPC_SECRET=super-duper-secret

本文引用了以下配置选项。有关配置选项的完整列表,请参阅 配置

  • DRONE_RPC_HOST
    提供 Drone Server 的主机名(和可选端口)。Runner 连接到指定主机地址的 Server 以接收 Pipeline 以执行。: 提供 Drone Server 的主机名(和可选端口)。Runner 连接到指定主机地址的 Server 以接收 Pipeline 以执行。
  • DRONE_RPC_PROTO
    提供用于连接 Drone Server 的协议。该值必须是 httphttps
  • DRONE_RPC_SECRET
    提供用于向 Drone Server 进行身份验证的共享密钥。这必须与你的 Drone Server 配置中定义的 Secret 匹配。

日志记录

Exec Runner 将日志写入主机上的文件。在启动服务之前,应在环境文件中配置日志文件位置。

DRONE_LOG_FILE=C:\Drone\drone-runner-exec\log.txt

日志文件的存放目录必须在启动服务之前先创建好:

mkdir C:\Drone
mkdir C:\Drone\drone-runner-exec

安装 Exec Runner

使用以下命令安装 Exec Runner 并启动服务。

drone-runner-exec.exe service install
drone-runner-exec.exe service start

验证安装结果

检查日志并验证 Runner 是否成功建立了与 Drone Server 的连接。

$ get-content -Path C:\Drone\drone-runner-exec\log.txt

INFO[0000] starting the server
INFO[0000] successfully pinged the remote server