setup/doc/drone.md

Setup Drone

General

• update your APT cache using

sudo apt update

• upgrade packages

sudo apt upgrade

• setup Docker like this

• download and install Drone

curl -L https://github.com/harness/drone-cli/releases/latest/download/drone_linux_amd64.tar.gz | tar zx
sudo install -t /usr/local/bin drone

Configuration

sudo mkdir -p /etc/drone/ sudo vi /etc/drone/drone.toml

• insert port configuration like this

[server]
port=":80"

sudo vi /etc/drone/drone.toml

• insert GitHub details like this

[github]
client="<enter Client ID from GitHub for this app>"
secret="<enter the Client Secret from GitHub for this app>"
# orgs=[]
# open=false

Drone Server

• download the server like this

docker pull drone/drone:latest

• verify that the latest server image is downloaded like this

docker image ls

• start the server like this

docker run \
  --volume=/var/lib/drone:/data \
  --env=DRONE_GITHUB_CLIENT_ID=your-id \
  --env=DRONE_GITHUB_CLIENT_SECRET=super-duper-secret \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_SERVER_HOST=drone.company.com \
  --env=DRONE_SERVER_PROTO=https \
  --publish=80:80 \
  --publish=443:443 \
  --restart=always \
  --detach=true \
  --name=drone \
  drone/drone:latest

• check logs

docker logs <container name<

Runners

Set up Docker Runner

• pull public image like this

docker pull drone/drone-runner-docker:latest

• start the runner like this

docker run --detach \
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --env=DRONE_RPC_PROTO=https \
  --env=DRONE_RPC_HOST=drone.company.com \
  --env=DRONE_RPC_SECRET=super-duper-secret \
  --env=DRONE_RUNNER_CAPACITY=2 \
  --env=DRONE_RUNNER_NAME=my-first-runner \
  --publish=3000:3000 \
  --restart=always \
  --name=runner \
  drone/drone-runner-docker:latest

• check logs

docker logs <container name<

Links

https://docs.drone.io/cli/install/

https://foxutech.com/how-to-setup-drone/

https://webhookrelay.com/blog/2019/02/11/using-drone-for-simple-selfhosted-ci-cd/

https://laptrinhx.com/how-to-setup-drone-a-continuous-integration-service-in-linux-3923450899/

https://docs.drone.io/server/provider/github/