woodpecker/docs/cli/machines.md

Machine Management

The drone node create command lets your register new remote servers with Drone. This command should be used in conjunction with docker-machine. Note that you can alternatively register and manage servers in the UI.

Environment Variables

The drone node create command expects the following environment variables:

• DOCKER_HOST - docker deamon address
• DOCKER_TLS_VERIFY - docker daemon supports tlsverify
• DOCKER_CERT_PATH - docker certificate directory

Instructions

Create or configure a new server using docker-machine:

docker-machine create \
    --digitalocean-size 2gb \
    --driver digitalocean \
    --digitalocean-access-token <token> \
    my-drone-worker

This writes setup instructions to the console:

export DOCKER_TLS_VERIFY="1"
export DOCKER_HOST="tcp://123.456.789.10:2376"
export DOCKER_CERT_PATH="/home/octocat/.docker/machine/machines/my-drone-worker"
export DOCKER_MACHINE_NAME="my-drone-worker"
# Run this command to configure your shell: 
# eval "$(docker-machine env my-drone-worker)"

Run the following command (from the above output) to configure your shell:

eval "$(docker-machine env my-drone-worker)"

Register the newly created or configured machine with Drone. Once registered, Drone will immediately begin sending builds to the server.

drone node create