Skip to content

This repository provides configuration and instructions for how to get started with Drone CI

Notifications You must be signed in to change notification settings

jimsheldon/drone-quickstart

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 

Repository files navigation

drone-quickstart

This repository provides configuration and instructions for how to get started with Drone CI from Harness

Prerequisites

  • Comfortable running commands in the terminal
  • A GitHub account
  • A ngrok account
  • A computer that can run amd64 or arm64 Docker containers (this includes the new M1-based Macs)
    • In your terminal, verify you have docker and docker-compose commands available

Tools used

Steps

Create the tunnel

  1. Login to https://ngrok.com
  2. Open https://dashboard.ngrok.com/get-started/setup, follow the steps to install the ngrok binary and connect to your account
  3. Create the tunnel by running ngrok http 8080 in your terminal, do not stop the process until you are finished with this guide
  4. ngrok will create your tunnel and provide you with a URL such as https://abcd-3fg-hij-k1-mn.ngrok.io, make a note of it

Create the GitHub OAuth Application

  1. Follow Drone's Create an OAuth Application documentation
  • For the "Homepage URL", enter the ngrok URL from the previous step
  • For the "Authorization callback URL", enter the same ngrok URL, with /login appended
  • You will be given the "Client ID" and a "Client secret", make a note of each (the secret is only displayed once, if you misplace it, you will need to generate a new client secret)

Start the Drone and Drone Runner processes

  1. Fork this repository and clone the fork to your computer
  2. Edit the file run.sh
  • Set DRONE_GITHUB_CLIENT_ID and DRONE_GITHUB_CLIENT_SECRET using the "Client ID" and "Client secret" from the previous step
  • Set DRONE_GITHUB_ADMIN to your GitHub username
  • Set DRONE_SERVER_HOST to your ngrok URL, without the https:// (if your ngrok URL is https://abcd-3fg-hij-k1-mn.ngrok.io, set DRONE_SERVER_HOST to abcd-3fg-hij-k1-mn.ngrok.io)
  • Save your changes
  1. Open a new terminal session and change to the directory where you checked out this repository
  • Execute run.sh by typing ./run.sh and hitting enter
  • Open your ngrok URL in a browser, you should be greeted with "Welcome to Drone"! 🎉

Activate your repository

  1. Click "Continue", you will be prompted to authorize your OAuth application in your GitHub account
  • Next you should see the dashboard, if you do not see any repositories, click the "Sync" button
  1. Your forked repository should now appear in the list, click the repository and then click "Activate Repository"

About

This repository provides configuration and instructions for how to get started with Drone CI

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages