本文介绍了如何在 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
的协议。该值必须是http
或https
。
-
- 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