Ansible Role: drone

This role sets up drone agents and the server using docker-compose.

Requirements

To use this role, you need:

• Docker installed on the server.

Role Variables

Configuration Variables

drone_server_image: "drone/drone"
drone_agent_image: "drone/agent"
drone_version: "latest"

You can change the image repository and version used for deployment with these settings.

drone_start_server: true
drone_start_agent: true

These settings let you choose which parts of the drone setup to deploy (default is both the drone agent and server).

drone_agent_count: 1

This setting specifies how many drone agents to deploy (default is 1).

drone_debug: false

This setting decides if drone will run in debug mode (default is false).

drone_open: true

This setting determines if anyone can register with drone (default is true).

drone_agent_debug: false

This setting defines if the drone agent will run in debug mode (default is false).

Drone Specific Parameters

The role includes all the settings needed to configure drone via Ansible.

Server

Required

• drone_secret
• drone_admin
• drone_vcs
• drone_server_url

Optional

• drone_open
• drone_database_driver
• drone_database_config
• drone_orgs
• drone_debug
• drone_server_cert
• drone_server_key
• drone_yaml
• drone_cache_tty

Agent

Required

• drone_secret
• drone_server_host

Optional

• drone_agent_server_url
• drone_agent_https_proxy
• drone_agent_http_proxy
• drone_agent_docker_os
• drone_agent_docker_arch
• drone_agent_docker_max_procs
• drone_agent_docker_cert_path
• drone_agent_docker_tls_verify
• drone_agent_docker_host
• drone_agent_plugin_privileged
• drone_agent_plugin_pull
• drone_agent_max_logs
• drone_agent_timeout
• drone_agent_backoff
• drone_agent_debug

VCS

For GitHub

Required

• drone_github_client
• drone_github_secret

Optional

• drone_github_url
• drone_github_scope
• drone_github_username
• drone_github_password
• drone_github_private_mode
• drone_github_merge_ref
• drone_github_context
• drone_github_skip_verify

For Bitbucket

Required

• drone_bitbucket_client
• drone_bitbucket_secret

Additional Parameters

The Ansible role includes even more parameters - see defaults/main.yml for details.

Example Playbook

- hosts: drone
  vars_files:
    - vars/main.yml
  roles:
    - { role: solutiondrive.drone }

Inside vars/main.yml

drone_admin: "admin"
drone_secret: "thisisnotasecuresecret"
drone_server_host: "drone.domain.tld"
drone_vcs: "github"
drone_github_client: "github_client_token"
drone_github_secret: "github_client_secret"
drone_agent_count: 3

Maintainer

• Patrick Jahns jahns@solutiondrive.de
• Tobias Lückel lueckel@solutiondrive.de