Drone

Drone is continues integration tool like Travis CI. In this document we will install Drone and integrate with Gitea.

Build Status

https://img.shields.io/badge/Last%20Build-passing-brightgreen.svg

Installation

This part of the document describes the process of installing Drone in Ubuntu 16.04 LTS.

Install the necessary packages

  1. Let’s first use the following commands to update and upgrade packages.

    sudo apt update

sudo apt -y upgrade

  2. We need to install docker-ce.

  • To start we will remove docker if it is already installed:

    sudo apt remove docker docker-engine docker.io

  • Make sure you have the following package installed to move forward:

    sudo apt-get install apt-transport-https ca-certificates curl software-properties-common

  • Add Docker’s official GPG key:

    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

  • Set up the stable docker repository:

    sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

  • Update the repo:

    sudo apt update

  • Install the latest version of Docker CE:

    sudo apt-get install docker-ce
  1. Now we will install docker-compose

  • Download the latest version of Docker Compose:

    sudo curl -L "https://github.com/docker/compose/releases/download/1.22.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

  • Make it executable:

    sudo chmod +x /usr/local/bin/docker-compose

Pull the drone image

We will pull the drone docker image to our host machine.:

sudo docker pull drone/drone:0.8

Configuration

Now we will create a docker-compose.yaml file with all the configuration to run drone. We will open docker-compose.yaml with our favourite editor:

nano docker-compose.yaml

Now paste the following to create the basic configuration:

version: '2'

services:
  drone-server:
    image: drone/drone:0.8

    ports:
      - 8000
      - 9000
    volumes:
      - drone-server-data:/var/lib/drone/
    restart: always
    environment:
      - DRONE_OPEN=false
      - DRONE_HOST=${DRONE_HOST}
      - DRONE_SECRET=${DRONE_SECRET}

  drone-agent:
    image: drone/agent:0.8

    command: agent
    restart: always
    depends_on:
      - drone-server
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - DRONE_SERVER=drone-server:9000
      - DRONE_SECRET=${DRONE_SECRET}

volumes:
  drone-server-data:

We can do a lot more tweak in the docker-compose.ymal file which can be found in the Drone Docs: Installation Overview.

Thought Drone supports GitHub, GitLab, Gitea, Gogs, Bitbucket Cloud, Bitbucket Server and Coding but in this document we will configure Gitea to run with Drone. The configuration for other git web service can be found in the Drone Docs: Integrations. For Gitea integration we simply need to add two environment variable bellow DRONE_HOST variable.:

- DRONE_GITEA=true
- DRONE_GITEA_URL=http://gitea_url.ltd:port

Customization

We can customize the drone to use it only in private mode and set Drone admin user.

Gitea private mode

If Gitea installation is running in private mode we can run our Drone in private mode as welli by adding the following bellow DRONE_GITEA_URL variable:

- DRONE_GITEA_PRIVATE_MODE=true

Gitea admin

We can define Gitea admin user(s). Only those who are added as Gitea admin can login into Drone. To add Drone admin add DRONE_ADMIN variable under DRONE_GITEA_URL as well:

- DRONE_ADMIN=$user_name