Drone

Drone is a Continuous Integration platform built on container technology. Every build is executed inside an ephemeral Docker container, giving developers complete control over their build environment with guaranteed isolation.

Documentation

Drone documentation is organized into several categories:

• Setup Guide
• Build Guide
• API Reference

Community

Contributions, questions, and comments are all welcomed and encouraged! Drone developers hang out in the drone/drone room on gitter.

---

Running Drone:

./drone --config="/path/to/config.toml"

Configuring Drone:

[server]
addr = ":80"
cert = ""
key = ""

[session]
secret = ""
expires = ""

[database]
driver="sqlite3"
datasource="/var/lib/drone/drone.sqlite"

[docker]
cert = ""
key = ""
addr = "unix:///var/run/docker.sock"
swarm = ""

[remote]
kind = "github"
base = "https://github.com"
orgs = []
open = false
private = false
skip_verify = true

[auth]
client = ""
secret = ""
authorize = "https://github.com/login/oauth/authorize"
access_token = "https://github.com/login/oauth/access_token"
request_token = ""

[agents]
secret = ""

Configuration settings can also be set by environment variables using the scheme DRONE_<section>_<confkey>, substituting the section title for <section> and the key for <confkey>, in all caps. For example:

#!/bin/bash
# prepare environment for executing drone
DRONE_REMOTE_BASE="https://github.com"      # for [remote] section, 'base' setting
DRONE_DOCKER_ADDR="tcp://10.0.0.1:2375"     # for [docker] section, 'addr' setting
DRONE_AUTH_CLIENT="0123456789abcdef0123AA"  # for [auth] section, 'client' setting
DRONE_AUTH_SECRET="<sha-1 hash secret>"     # for [auth] section, 'secret' setting
DRONE_AUTH_ACCESSTOKEN="<url>"              # for [auth] section, 'access_token' setting

exec ./drone -config=drone.toml

NOTE: Configuration settings from environment variables override values set in the TOML file.

From Source

Commands to build from source:

make bindata # create .go files for web assets
make         # create binary files in ./bin
make test    # execute unit tests

Commands to run:

bin/drone
bin/drone --debug # debug mode loads static content from filesystem

NOTE if you are seeing slow compile times you can try running go install for the vendored go-sqlite3 library:

go install github.com/drone/drone/Godeps/_workspace/src/github.com/mattn/go-sqlite3