Install On Windows
Updated 2 years ago
by
Admin
This article explains how to install the exec runner on Windows. The exec runner is packaged in binary format and distributed as a Github release.
Step 1: Download
Download and unpack the binary.
https://github.com/drone-runners/drone-runner-exec/releases/latest/download/drone_runner_exec_windows_amd64.tar.gz
Step 2: Configuration
The exec runner is configured using an environment variable file. The environment file should be stored at the following path:
C:\Drone\drone-runner-exec\config
This file should use the syntax <variable>=value which sets the variable to the given value and # for comments. Please note this is not a bash file. Bash syntax and Bash expressions are not supported.
DRONE_RPC_PROTO=https
DRONE_RPC_HOST=drone.company.com
DRONE_RPC_SECRET=super-duper-secret
This article references the below configuration options. See Configuration for a complete list of configuration options.
- DRONE_RPC_HOST
provides the hostname (and optional port) of your Drone server. The runner connects to the server at the host address to receive pipelines for execution. - DRONE_RPC_PROTO
provides the protocol used to connect to your Drone server. The value must be either http or https. - DRONE_RPC_SECRET
provides the shared secret used to authenticate with your Drone server. This must match the secret defined in your Drone server configuration.
Step 3: Logging
The exec runner writes logs to a file on the host machine. The log file location should be configured in the environment file before you start the service.
DRONE_LOG_FILE=C:\Drone\drone-runner-exec\log.txt
The log file directory must be created before you start the service:
$ mkdir C:\Drone
$ mkdir C:\Drone\drone-runner-exec
Step 4: Installation
Install and start the service.
$ drone-runner-exec.exe service install
$ drone-runner-exec.exe service start
Step 5: Verification
Inspect the logs and verify the runner successfully established a connection with the Drone server.
$ get-content -Path C:\Drone\drone-runner-exec\log.txt
INFO[0000] starting the server
INFO[0000] successfully pinged the remote server
