woodpecker/doc/build/build.md

Build

Drone uses the build section of the .drone.yml to describe your Docker build environment and specify your build and test instructions. The following is an example build definition:

build:
  image: golang
  environment:
    - GOBIN=/drone/bin
  commands:
    - go get
    - go build
    - go test

Build options

The build configuration options:

• image - any valid Docker image name
• pull - if true, will always attempt to pull the latest image
• environment - list of environment variables, declared in name=value format
• privileged - if true, runs the container with extended privileges [1]
• volumes - list of bind mounted volumes on the host machine [1]
• net - sets the container network mode [1]
• commands - list of build commands

[1] Some build options are disabled for security reasons, including volumes, privileged and net. To enable these options, a system administrator must white-list your repository as trusted. This can be done via the repository settings screen.

Build image

The image attribute supports any valid Docker image name:

# Docker library image
image: golang

# Docker library image, with tag
image: golang:1.4

# Docker image, full name, with tag
image: library/golang:1.4

# fully qualified Docker image URI, with tag
image: index.docker.io/library/golang:1.4

Build environment

The build environment has access to the following environment variables:

• CI=true
• DRONE=true
• DRONE_REPO - repository name for the current build
• DRONE_BUILD - build number for the current build
• DRONE_BRANCH - branch name for the current build
• DRONE_COMMIT - git sha for the current build
• DRONE_DIR - working directory for the current build

Skipping builds

Skip a build by including the text [CI SKIP] in your commit message.