We hope you find this tutorial helpful. In addition to guides like this one, we provide simple cloud infrastructure for developers. Learn more →

How To Set Up Continuous Integration Pipelines with Drone on Ubuntu 16.04

PostedJune 28, 2017 6.7k views Git CI/CD Ubuntu Ubuntu 16.04

Introduction

Drone is a continuous integration and delivery platform written in Go. Through integrations with many popular version control services, you can use it to build, test, and deliver software automatically whenever your code is updated.

In this tutorial, we will fork an example GitHub repository and use Drone to build and test the project.

Prerequisites

Before starting this tutorial, you'll need Drone installed, configured, and linked to your GitHub account. The following tutorials will get you there:

When complete, you should be logged in to Drone, at a screen similar to the following:

Drone default logged in screen

This is Drone's dashboard. It shows that we're logged in, but have no repositories set up in Drone. Let's create a repository now.

Forking the Example Repository

First, we'll need a GitHub repository with with some code to build and test. You can use Drone with many different version control repositories, but in the prerequisites we linked Drone with a GitHub account, so we'll use that throughout this tutorial. Log in to GitHub and navigate to the following repo:

https://github.com/do-community/hello_hapi

hello_hapi repository page

Click the Fork button in the upper-right corner to copy this repository to your own account. If you have access to multiple GitHub organizations, you may be asked to choose where to fork the repository to. Choose your normal user account. After a few moments, you'll be taken to the hello_hapi repository that has been copied to your account.

Next, we'll take a look at how we configure Drone to build and test our code.

Understanding the .drone.yml File

Drone looks for a configuration file named .drone.yml in your repository to determine how it should handle your code. This file is already included in the repository we just forked:

.drone.yml
pipeline:
  build:
    image: node:latest
    commands: npm install
  test:
    image: node:latest
    commands: npm run test

This is a YAML file that defines a pipeline. A pipeline is a continuous integration process that runs multiple steps, one after the other. In our case, we have a two-step pipeline.

The first step, called build will use the node:latest Docker image to run npm install in our repository. This will download and install all of the libraries needed to run the tests.

The next step is called test. It uses the same Docker image to run our test suite. Often, you would run both the build and test commands in one step, but we've split them up to better demonstrate pipelines.

Note that the steps in a pipeline all share the same workspace, so files created in the first step will be available in later steps. Drone has many more options that can be configured with .drone.yml, which you can read about in the Drone documentation. Some of these features include:

  • Matrix builds, where you build and test against multiple versions of a library or runtime to check compatibility
  • Notifications via email or messaging services
  • Publication of build products to npm, container registries, or static site hosts

Next, we'll tell Drone to watch for changes to our repository, and then trigger a build.

Triggering a Continuous Integration Run

Log in to Drone, if you aren't already. The home page will look fairly sparse until we set it up. The empty sidebar prompts us to Activate your repositories to get started.

Drone default logged in screen

Click the Activate link to show a list of all your GitHub repositories:

Drone repository listing

Find the hello_hapi repo and click the gray toggle in the right-hand column to activate it. The toggle will flip and turn green. Behind the scenes, Drone will use GitHub's API to make sure it receives notifications whenever our code changes.

Return to the home page dashboard by clicking the Drone logo in the upper-left corner of the screen, or by using the menu in the upper-right corner next to your user icon:

dashboard link screenshot

The dashboard will now have our new repository listed in the left-hand column. There's no status information yet, because we haven't run a build:

dashboard with hello_hapi and no build info

Click the hello_hapi repository name to enter a detailed view for the repository. It will have some tabs where we can update settings, add secrets like tokens and passwords, and get embeddable build status badges. By default we're on the Builds tab, and no builds are listed yet.

hello_hapi repo details with no builds

Let's trigger a build now.

Leave your Drone page open, and navigate to the hello_hapi GitHub repository in another tab or window. We're going to add a file to the project in order to trigger a build. Any file will do. Click the Create new file button up towards the top of the file list in your repo:

Create file button on GitHub screenshot

Choose any filename. In this case we chose trigger-file. Enter any content:

Filename and content creation on GitHub screenshot

Then, scroll down to the bottom of the content editor and click the Commit new file button:

Commit new file on GitHub screenshot

Upon commit, GitHub will notify our Drone install of the change. Drone will then start a new build. Switch back to your Drone browser window. The interface should update fairly quickly, and a spinning arrow will indicate that a build is happening.

Drone dashboard with build in progress

It may already be finished if you took a few moments to switch back to Drone. Let's look at the build details next.

Viewing the CI/CD Results

Click on the build to enter a detailed view. If the build is still in progress, you'll be able to observe each pipeline step in real-time.

Drone build details

You can click the disclosure arrows for each build step to show more details. Here is the output of our test step:

Drone build step details

If the step is still in progress, clicking the Follow button will show the output as it happens.

Note that there is a clone stage we didn't define in our .drone.yml file. This is always present and gives details on how Drone fetched your source code before the build.

Conclusion

In this tutorial, we forked a demonstration repository, explored the .drone.yml configuration file, and built and tested our repository with Drone.

For more information on configuring Drone to build, test, and deploy your project, refer to the Drone documentation.

0 Comments

Creative Commons License