Giters

isabella232 / drone_playground

Helping get up to speed with drone via examples

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

drone_playground

Helping get up to speed with drone via examples.

Fork this repository into your own namespace and have a try out the examples.

DO NOT CHECK CREDENTIALS INTO THIS REPO

This repository

This contains lots of different kinds of builds as listed below. Just follow their instructions to try them out.

After you have forked this repository.

There are a couple ways to try it out.

  1. Run this on your installation of Drone. You will be able to add your forked repository, and then run builds.
  2. Run this on cloud.drone.io You will need to have an established github account. Once you log into cloud.drone.io you will be able to add your forked repository, and then run builds.
  3. Follow the instructions for setting up drone in aws, at the bottom of this readme. You will be able to add your forked repository, and then run builds.

Drone Basics

Conditionals

Here is a concrete example of conditional usage in drone. For more complex usage look here To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./basic/conditional.yml

Parallelism

Here is a concrete example of parallel builds in drone. For more complex usage look here To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./basic/parallel.yml

Triggers and multiple pipelines

Here is a concrete example of triggers and multiple pipelines in drone. To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./basic/triggers_and_pipelines.yml

Further reading into what is possible

For more complex usage docker usage look here

Language specific build examples

Golang build

Code lives here in the golang folder, it contains an example go project and a basic .drone.yaml file that:

  • go vet
  • go test
  • builds a binary

To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./golang/.drone.yml

For more advanced information on golang builds go here

Java build

Code lives here in the java folder, it contains an example project and a basic .drone.yaml file that:

  • builds a class
  • runs the class

To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./java/.drone.yml

For more advanced information on Java builds go here

Localstack service

Localstack provides a mock framework for developing cloud applications, which you can spin up a local test environment which provides the same functionality and API's as the real AWS Cloud Environment.

Code lives here in the localstack folder, it runs a localstack service in a basic .drone.yml file that:

  • provisions a localstack service that enables you to interact with the localstack api's
  • localstack health check that waits on the localstack service to come up
  • create kineses stream step, which creates a kineses resource on localstack to produce and consume records from
  • put records step, which put's 100 records into kinesis using a for loop
  • get records step, which consumes all the records from kinesis
  • delete kinesis stream step, which deletes the kinesis resource from localstack

To try this build, In the settings of this repo in your drone ui, set the path for the drone file to ./localstack/.drone.yml

For more advanced information on services go here https://docs.drone.io/pipeline/kubernetes/syntax/services/

Minio

MinIO is an open source distributed object storage server written in Go.

Code lives here in the minio folder, it runs a localstack service in a basic .drone.yml file that:

  • provisions a minio service that enables you to interact with its object storage service
  • health check step that waits on the minio service to come up
  • configures the minio client mc and creates a minio bucket
  • writes a file to the local filesystem and uploads the file to the minio object store
  • uses mc cat to read the content of the object on minio

To try this build, In the settings of this repo in your drone ui, set the path for the drone file to ./minio/.drone.yml

For more advanced information on services go here https://docs.drone.io/pipeline/docker/syntax/services/

MongoDB

MongoDB is a source-available cross-platform document-oriented database program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with optional schemas.

Code lives here in the mongodb folder, it runs a mongodb service in a basic ./mongodb/.drone.yml file that:

  • provisions a mongodb service that runs the database
  • health check step that waits on the mongodb service to come up
  • as mongodb supports javascript, theres a script to generate dummy data and write to mongodb collection
  • a step to read from mongodb using a query

Mysql database

Code lives here in the mysql folder, it runs a mysql service in a basic .drone.yaml file that:

  • mysql service that runs the database
  • mysql health check that waits on the mysql service to come up
  • DDL sql step to create and insert data into a table
  • DML sql step to get data from the table

To try this build. In the settings of this repo in you drone ui. Set the path for the drone file to ./mysql/.drone.yml

For more advanced information on services go here https://docs.drone.io/pipeline/kubernetes/syntax/services/

Running and installing Drone in AWS using Github as the git provider

THIS IS NOT RECOMMENDED FOR PRODUCTION THIS IS NOT RECOMMENDED FOR PRODUCTION

The setup here is for testing purposes only, there are settings here that are inherently insecure (the open ssh/http ports).

AWS setup

  • Go to your EC2 dashboard we are using Ohio region us-east-2
  • Click on the Launch Instance button
  • On screen 1 Ubuntu 20.04 - You may need to click the subscribe button to get the latest image.
  • On screen 2 t2.medium 4gb mem
  • On screen 3 In advanced details - inside 'user data' paste in the following
#cloud-config
users:
- default
- name: root
  sudo: ALL=(ALL) NOPASSWD:ALL
  groups: sudo

apt:
  sources:
    docker.list:
      source: deb [arch=amd64] https://download.docker.com/linux/ubuntu $RELEASE stable
      keyid: 9DC858229FC7DD38854AE2D88D81803C0EBFCD88
      
packages:
- docker-ce
- vim

write_files:
- path: /root/docker-compose.yml
  content: |
    version: "3.8"
    services:
        drone:
            image: drone/drone:latest
            ports:
            - "80:80"
            environment:
            - DRONE_SERVER_HOST=${AWS_HOSTNAME}
            - DRONE_SERVER_PROTO=http
            - DRONE_RPC_SECRET=bea26a2221fd8090ea38720fc445eca6
            - DRONE_COOKIE_SECRET=e8206356c843d81e05ab6735e7ebf075
            - DRONE_COOKIE_TIMEOUT=720h
            - DRONE_GITHUB_CLIENT_ID=${DRONE_GITHUB_CLIENT_ID}
            - DRONE_GITHUB_CLIENT_SECRET=${DRONE_GITHUB_CLIENT_SECRET}
            - DRONE_LOGS_DEBUG=true
            - DRONE_CRON_DISABLED=true
            volumes:
            - ./data:/data
        runner:
            image: drone/drone-runner-docker:latest
            environment:
            - DRONE_RPC_HOST=drone
            - DRONE_RPC_PROTO=http
            - DRONE_RPC_SECRET=bea26a2221fd8090ea38720fc445eca6
            - DRONE_TMATE_ENABLED=true
            volumes:
            - /var/run/docker.sock:/var/run/docker.sock
runcmd:
  - [ systemctl, daemon-reload ]
  - [ systemctl, restart, docker ]
  - sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
  - sudo chmod +x /usr/local/bin/docker-compose

output: {all: '| tee -a /var/log/cloud-init-output.log'}

This script installs docker, docker-compose, vim and creates '/root/docker-compose.yml' for you.

  • On screen 4 select the storage size
  • On screen 5 add any neccessary tags
  • On screen 6 set up a security group to allow ports 80 and 22 (http/ssh) from anywhere.
  • Review your settings, finally select your key pair you have created / or create a new key pair.

Setting up Github Oauth

  • Setup Github Oauth
  • Set the home page to http://localhost * this is not important
  • Set the Authorization callback URL to http://${AWS_HOSTNAME}/login
  • Create your client id and secret. Keep these safe !! this is the only time you will see these.

Running Drone

  • SSH into the box as ubuntu using your aws pem file ssh -i key_pair.pem ubuntu@${AWS_HOSTNAME}. Use whatever your key pair is called.
  • Change to the root user sudo su
  • Change directory into the root folder cd /root
  • Edit the docker compose file vim docker-compose.yml

Changing the following 3 settings

DRONE_SERVER_HOST=${AWS_HOSTNAME}                          # your aws instance hostname
DRONE_GITHUB_CLIENT_ID=${DRONE_GITHUB_CLIENT_ID}           # taken from your Github oauth application
DRONE_GITHUB_CLIENT_SECRET=${DRONE_GITHUB_CLIENT_SECRET}   # taken from your Github oauth application
  • Run the following command to start the Docker containers docker-compose up. You should see the Drone server and Drone runner start.
  • Open a browser and go to http://{AWS_HOSTNAME}

TODO's

  • Add workspace setting for golang .drone.yml, to remove cd hack.

About

Helping get up to speed with drone via examples

Languages

Language:JavaScript 36.6%Language:Go 27.9%Language:Shell 19.4%Language:Java 16.0%