This article explains how to install the docker runner. The docker runner is packaged and distributed as a Docker image on Docker Hub. This required the
:lateset version of the agent.
Step 1 - Download
Install Docker and pull the public image:
$ docker pull drone/agent:windows-1903-amd64
Step 2 - Configure
The docker runner is configured using environment variables. This article references the below configuration options. See Reference for a complete list of configuration options.
- 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.
- provides the protocol used to connect to your Drone server. The value must be either http or https.
- provides the shared secret used to authenticate with your Drone server. This must match the secret defined in your Drone server configuration.
Step 3 - Install
The below command creates the a container and start the docker runner. Remember to replace the environment variables below with your Drone server details.
$ docker run -d \ -v //./pipe/docker_engine://./pipe/docker_engine \ -e DRONE_RPC_PROTO=https \ -e DRONE_RPC_HOST=drone.company.com \ -e DRONE_RPC_SECRET=super-duper-secret \ -e DRONE_RUNNER_CAPACITY=2 \ -p 3000:3000 \ --restart always \ --name runner \ drone/agent:windows-1903-amd64