woodpecker/README.md

302 lines
7.6 KiB
Markdown
Raw Normal View History

Drone is a [Continuous Integration](http://en.wikipedia.org/wiki/Continuous_integration) platform built on [Docker](https://www.docker.io/)
2014-02-07 10:10:01 +00:00
2014-02-13 22:43:02 +00:00
[![Build Status](http://beta.drone.io/github.com/drone/drone/status.png?branch=master)](http://beta.drone.io/github.com/drone/drone)
2014-02-14 07:40:29 +00:00
[![GoDoc](https://godoc.org/github.com/drone/drone?status.png)](https://godoc.org/github.com/drone/drone)
2014-02-13 22:43:02 +00:00
2014-03-02 03:58:07 +00:00
* [System Requirements](#system)
* [Installation](#setup)
* [Builds](#builds)
* [Images](#images)
* [Application Environment](#environment)
* [Git Command Options](#git-command-options)
* [Deployments](#deployments)
* [Notifications](#notifications)
* [Database Services](#databases)
* [Caching](#caching)
2014-03-02 03:58:07 +00:00
* [Params Injection](#params-injection)
* [Documentation and References](#docs)
2014-02-07 10:10:01 +00:00
### System
Drone is tested on the following versions of Ubuntu:
* Ubuntu Precise 12.04 (LTS) (64-bit)
* Ubuntu Raring 13.04 (64 bit)
Drone's only external dependency is the latest version of Docker (0.8)
### Setup
Drone is packaged and distributed as a debian file. You can download an install
using the following commands:
```sh
$ wget http://downloads.drone.io/latest/drone.deb
$ sudo dpkg -i drone.deb
2014-02-07 10:10:01 +00:00
$ sudo start drone
```
Once Drone is running (by default on :80) navigate to **http://localhost:80/install**
and follow the steps in the setup wizard.
**IMPORTANT** You will also need a GitHub Client ID and Secret:
* Register a new application https://github.com/settings/applications
* Set the homepage URL to http://$YOUR_IP_ADDRESS/
* Set the callback URL to http://$YOUR_IP_ADDRESS/auth/login/github
* Copy the Client ID and Secret into the Drone admin console http://localhost:80/account/admin/settings
2014-02-07 21:00:38 +00:00
I'm working on a getting started video. Having issues with volume, but hopefully
you can still get a feel for the steps:
https://docs.google.com/file/d/0By8deR1ROz8memUxV0lTSGZPQUk
2014-02-07 10:10:01 +00:00
### Builds
Drone use a **.drone.yml** configuration file in the root of your
repository to run your build:
```
image: mischief/docker-golang
env:
- GOPATH=/var/cache/drone
script:
- go build
- go test -v
services:
2014-02-07 10:10:01 +00:00
- redis
notify:
email:
recipients:
- brad@drone.io
- burke@drone.io
```
2014-02-07 18:18:26 +00:00
### Images
In the above example we used a custom Docker image from index.docker.io **mischief/docker-golang**
Drone also provides official build images. These images are configured specifically for CI and
have many common software packages pre-installed (git, xvfb, firefox, libsqlite, etc).
Official Drone images are referenced in the **.drone.yml** by an alias:
```sh
image: go1.2 # same as bradrydzewski/go:1.2
```
Here is a list of our official images:
```sh
2014-02-08 20:37:33 +00:00
# these two are base images. all Drone images are built on top of these
2014-02-07 18:18:26 +00:00
# these are BIG (~3GB) so make sure you have a FAST internet connection
docker pull bradrydzewski/ubuntu
docker pull bradrydzewski/base
# clojure images
docker pull bradrydzewski/lein # image: lein
# dart images
docker pull bradrydzewski/dart:stable # image: dart
# erlang images
docker pull bradrydzewski/erlang:R16B # image: erlangR16B
docker pull bradrydzewski/erlang:R16B02 # image: erlangR16B02
docker pull bradrydzewski/erlang:R16B01 # image: erlangR16B01
# gcc images (c/c++)
docker pull bradrydzewski/gcc:4.6 # image: gcc4.6
docker pull bradrydzewski/gcc:4.8 # image: gcc4.8
# go images
docker pull bradrydzewski/go:1.0 # image: go1
docker pull bradrydzewski/go:1.1 # image: go1.1
docker pull bradrydzewski/go:1.2 # image: go1.2
# haskell images
docker pull bradrydzewski/haskell:7.4 # image: haskell
# java and jdk images
docker pull bradrydzewski/java:openjdk6 # image: openjdk6
docker pull bradrydzewski/java:openjdk7 # image: openjdk7
docker pull bradrydzewski/java:oraclejdk7 # image: oraclejdk7
docker pull bradrydzewski/java:oraclejdk8 # image: oraclejdk8
# node images
docker pull bradrydzewski/node:0.10 # image node0.10
docker pull bradrydzewski/node:0.8 # image node0.8
# php images
docker pull bradrydzewski/php:5.5 # image: php5.5
docker pull bradrydzewski/php:5.4 # image: php5.4
# python images
docker pull bradrydzewski/python:2.7 # image: python2.7
docker pull bradrydzewski/python:3.2 # image: python3.2
docker pull bradrydzewski/python:3.3 # image: python3.3
docker pull bradrydzewski/python:pypy # image: pypy
# ruby images
docker pull bradrydzewski/ruby:2.0.0 # image: ruby2.0.0
docker pull bradrydzewski/ruby:1.9.3 # image: ruby1.9.3
# scala images
docker pull bradrydzewski/scala:2.10.3 # image: scala2.10.3
docker pull bradrydzewski/scala:2.9.3 # image: scala2.9.3
```
2014-02-07 10:10:01 +00:00
### Environment
Drone clones your repository into a Docker container
at the following location:
```
/var/cache/drone/src/github.com/$owner/$name
```
2014-02-07 18:18:26 +00:00
Please take this into consideration when setting up your build commands, or
if you are using a custom Docker image.
2014-02-07 10:10:01 +00:00
2014-03-02 03:58:07 +00:00
### Git Command Options
2014-02-07 10:10:01 +00:00
2014-03-02 03:58:07 +00:00
You can specify the `--depth` option of the `git clone` command (default value is `50`):
2014-02-07 10:10:01 +00:00
```
2014-03-02 03:58:07 +00:00
git:
depth: 1
2014-02-07 10:10:01 +00:00
```
### Deployments
Drone can trigger a deployment at the successful completion of your build:
```
deploy:
heroku:
app: safe-island-6261
publish:
s3:
acl: public-read
region: us-east-1
bucket: downloads.drone.io
access_key: C24526974F365C3B
secret_key: 2263c9751ed084a68df28fd2f658b127
source: /tmp/drone.deb
target: latest/
```
Drone currently has these `deploy` and `publish` plugins implemented (more to come!):
**deploy**
- [heroku](#docs)
- [git](#docs)
- [modulus](#docs)
- [ssh](#docs)
**publish**
- [Amazon s3](#docs)
2014-02-07 10:10:01 +00:00
### Notifications
Drone can trigger email, hipchat and web hook notification at the beginning and
completion of your build:
2014-02-07 10:10:01 +00:00
```
notify:
email:
recipients:
- brad@drone.io
- burke@drone.io
urls:
- http://my-deploy-hook.com
hipchat:
room: support
token: 3028700e5466d375
on_started: true
on_success: true
on_failure: true
2014-02-07 10:10:01 +00:00
```
2014-03-02 03:58:07 +00:00
### Databases
2014-03-02 03:58:07 +00:00
Drone can launch database containers for your build:
```
2014-03-02 03:58:07 +00:00
services:
- cassandra
- couchdb
- couchdb:1.0
- couchdb:1.4
- couchdb:1.5
- elasticsearch
- elasticsearch:0.20
- elasticsearch:0.90
- neo4j
- neo4j:1.9
- mongodb
- mongodb:2.2
- mongodb:2.4
- mysql
- mysql:5.5
- postgres
- postgres:9.1
- rabbitmq
- rabbitmq:3.2
- redis
- riak
- zookeeper
```
2014-03-02 03:58:07 +00:00
If you omit the version, Drone will launch the latest version of the database. (For example, if you set `mongodb`, Drone will launch MongoDB 2.4.)
**NOTE:** database and service containers are exposed over TCP connections and
have their own local IP address. If the **socat** utility is installed inside your
Docker image, Drone will automatically proxy localhost connections to the correct
IP address.
### Caching
Drone can persist directories between builds. This should be used for caching dependencies to
decrease overall build time. Examples include your `.npm`, `.m2`, `bundler`, etc.
```
cache:
- /usr/local/bin/go/pkg
```
This will cache the directory relative to the root directory of your repository:
```
cache:
- .npm
```
**NOTE:** this is an alpha quality feature and still has some quirks. See https://github.com/drone/drone/issues/147
2014-02-13 15:03:40 +00:00
### Params Injection
You can inject params into .drone.yml.
```
notify:
hipchat:
room: {{hipchatRoom}}
token: {{hipchatToken}}
on_started: true
on_success: true
on_failure: true
```
![params-injection](https://f.cloud.github.com/assets/1583973/2161187/2905077e-94c3-11e3-8499-a3844682c8af.png)
2014-02-07 10:10:01 +00:00
### Docs
2014-02-14 07:40:29 +00:00
* [drone.readthedocs.org](http://drone.readthedocs.org/) (Coming Soon)
* [GoDoc](http://godoc.org/github.com/drone/drone)
2014-02-07 10:10:01 +00:00