Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/remram44/drone-runner-qemu
A runner for Drone CI that runs jobs in Qemu virtual machines
https://github.com/remram44/drone-runner-qemu
continuous-integration drone-ci drone-plugin drone-runner gitea qemu virtual-machine
Last synced: about 2 months ago
JSON representation
A runner for Drone CI that runs jobs in Qemu virtual machines
- Host: GitHub
- URL: https://github.com/remram44/drone-runner-qemu
- Owner: remram44
- License: other
- Created: 2024-04-24T18:41:03.000Z (9 months ago)
- Default Branch: trunk
- Last Pushed: 2024-04-27T15:42:11.000Z (9 months ago)
- Last Synced: 2024-12-07T02:45:02.977Z (about 2 months ago)
- Topics: continuous-integration, drone-ci, drone-plugin, drone-runner, gitea, qemu, virtual-machine
- Language: Go
- Homepage:
- Size: 73.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# What is this?
**[Drone](https://www.drone.io/) is an opensource CI server**. It allows you to run commands when you push to a Git repository, for example to build a release, run your unit tests, or publish a website.
Drone relies on **plugins called ["runners"](https://docs.drone.io/runner/overview/) to do the actual command execution**. It comes with runners for running on your machine (which is dangerous, commands in the repository could mess with your system) or on [cloud platforms](https://docs.drone.io/runner/vm/configuration/migration/) such as AWS and GCP.
For self-hosting purposes, being able to **run on virtual machines locally** is desirable for security, reproducibility, and cost. This is what this repository provides, using the [QEMU open-source emulator](https://www.qemu.org/).
# Installation
Download some images:
```console
$ qemu-images/download.sh
```
You can customize how images are run by editing the `.qemu.sh` scripts or making your own.
Download the qemu runner and configure to connect with your central Drone server using your server address and shared secret:
```console
$ DRONE_RPC_HOST=drone.example.com \
DRONE_RPC_PROTO=https \
DRONE_RPC_SECRET=${SECRET} \
DRONE_QEMU_IMAGE_DIR=$(pwd)/qemu-images \
DRONE_QEMU_DEFAULT_IMAGE=ubuntu-22.04 \
./drone-runner-qemu
```
Or with Docker:
```console
$ docker run -d \
--device /dev/kvm \
--env=DRONE_RPC_HOST=drone.example.com \
--env=DRONE_RPC_PROTO=https \
--env=DRONE_RPC_SECRET=${SECRET} \
--env=DRONE_QEMU_IMAGE_DIR=/qemu-images \
--env=DRONE_QEMU_DEFAULT_IMAGE=ubuntu-22.04 \
--restart=always \
--volume=$(pwd)/qemu-images:/qemu-images \
--name=drone-runner-qemu ghcr.io/remram44/drone-runner-qemu
```
That's it. Go make some pipelines with `type: qemu`, they will be run by this system in their own, self-contained, ephemeral virtual machines.
# Usage
Use `type: qemu` in your `.drone.yml`. You can set the top-level `image` key to the name of an image file. For example:
```yaml
---
kind: pipeline
type: qemu
name: default
image: ubuntu-22.04
steps:
- name: greeting
commands:
- echo hello world
```
# License
This software is licensed under the [Blue Oak Model License 1.0.0](https://spdx.org/licenses/BlueOak-1.0.0.html).
# Notice
This software relies on the [runner-go](https://github.com/drone/runner-go) module authored by [Drone.IO, Inc](https://github.com/drone) under a [Non-compete](https://github.com/drone/runner-go/blob/master/LICENSE.md) license. This module can be used in any software for free for any permitted purpose in accordance with the license. This module cannot be used in any software that competes with the licensor.