Drone is a self-service continuous delivery platform which can be used for CICD pipelines, devopsy stuff which is really awesome.
With Configuration as Code, Pipelines are configured with a simple, easy‑to‑read file that you commit to your git repository such as github, gitlab, gogs, gitea etc.
Each Pipeline step is executed inside an isolated Docker container that is automatically downloaded at runtime, if not found in cache.
A pipeline can look as easy as:
kind: pipeline steps: - name: test image: node commands: - npm install - npm test services: - name: database image: mysql ports: - 3306
This post will show how to setup Gitea, Drone Server and Drone Agent on a Docker host using docker-compose. The drone example in this tutorial will be very basic, but in future posts I will focus more on pipeline examples using Drone.
Gitea: will be your self hosted git server
Drone Server: will be server being responsible for the web service, repositories, secrets, users, etc.
Drone Agent: will be the workers that runs your builds, jobs etc.
Get the docker-compose.yml:
$ wget -O docker-compose.yml https://gist.githubusercontent.com/ruanbekker/27d2cb2e3f4194ee5cfe2bcdc9c4bf52/raw/25590a23e87190a871d70fd57ab461ce303cd286/2020.02.04-gitea-drone_docker-compose.yml
Verify the environment variables and adjust the defaults if you want to change something, if you want your git clone ssh url to point to a dns name as well as the url for gitea, then change the following to your dns:
gitea: ... environment: - ROOT_URL=http://gi.myresolvable.dns:3000 - SSH_DOMAIN=git.myresolvable.dns
$ docker-compose up -d
The default port for Gitea in this setup is port
Initial configuration will be pre-populated from our environment variables:
From the additional settings section, create your admin user (this user is referenced in our docker-compose as well)
Because I am using gitea as my hostname, you will be redirected to
http://gitea:3000/user/login, if you don't have a host entry setup for that it will fail, but you can just replace your servers ip in the request url and it will take you to the login screen, and after logging on, you should see this screen:
Access drone on port 80, you will be directed to the login screen:
Use the same credentials that you have used to sign up with gitea, and after logging on, you should see this:
If ever your login does not work, just delete the drone access token on gitea (gitea:3000/user/settings/applications)
On gitea, create a new git repository:
You should now see your git repository:
Create a new file
.drone.yml with the following content:
kind: pipeline name: hello-world type: docker steps: - name: say-hello image: busybox commands: - echo hello-world
It should look like this:
Commit the file in your git repository and head over to drone (which should be available on port
80) and select "Sync", after a couple of seconds you should see the git repository:
Select "Activate" and "Activate Repository", on the next screen select "Trusted", verify that the configuration file name is the same as which we created, then select save:
If you click on "Activity Feed" you should see a empty feed. Head back to git and commit a dummy file to trigger the build to start. I will create a file name
trigger with the value as
1 for my dummy file.
After committing the file, you will see on drone that the build started:
When we select the build, you can see we have a clone step and the step that we defined to echo "hello-world":
This was a basic introduction for gitea and drone, but I will use this post in conjunction with more gitea examples in the future.