Tutorial

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

How To Set Up Continuous Integration Pipelines with Drone on 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.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about our products

About the authors

Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
1 Comments


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Had a error: npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! hello@1.0.0 test: NODE_ENV=test node node_modules/lab/bin/lab -v -L -C -D npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the hello@1.0.0 test script. npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in: npm ERR! /root/.npm/_logs/2019-01-21T04_42_10_231Z-debug.log

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Featured on Community

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more