Back to articles
AI & Cloud

Transition from Drone CI to Woodpecker CI: Ultra-Light CI/CD Solution on Docker Containers

Guide to migrating from Drone CI to Woodpecker CI for optimizing CI/CD systems with high performance, low cost, and easy integration on Docker containers.

DPTCloud Engineering4 min read
Transition from Drone CI to Woodpecker CI: Ultra-Light CI/CD Solution on Docker Containers

Image credit: Carola68 · Pixabay Content License

Introduction to Drone CI and Woodpecker CI

Drone CI is a popular continuous integration (CI) system built on Docker, supporting automated testing pipelines. However, with growing demands for high performance, low cost, and scalability, many organizations are transitioning to Woodpecker CI — a lightweight, self-hosted, and fully open-source CI/CD solution.

Woodpecker CI is designed to run efficiently in Docker container environments, offering a simple structure, easy deployment, and suitability for small to medium-sized projects. This guide walks through the complete migration from Drone CI to Woodpecker CI, optimizing your CI/CD system for better performance, lower cost, and easier integration.

Comparison Between Drone CI and Woodpecker CI

Feature Drone CI Woodpecker CI
Lightweight Moderate Ultra-light
Operational Cost High Low
Docker Integration Yes Yes
Scalability Moderate High
YAML Configuration Yes Yes
Developed By Drone Labs Woodpecker CI (Community)

Migrating from Drone CI to Woodpecker CI

To migrate, follow these steps:

  1. Create a new project on Woodpecker CI by visiting https://woodpecker-ci.org and registering an account.
  2. Set up pipeline using a .woodpecker.yml file, similar to .drone.yml but with the correct syntax.
  3. Run the Docker container to start the server with the following command:
docker run -d \
  --name woodpecker-server \
  -p 80:80 \
  -v /var/woodpecker:/var/woodpecker \
  -e WOODPECKER_SERVER_HOST=woodpecker.local \
  -e WOODPECKER_SERVER_PORT=80 \
  -e WOODPECKER_DATABASE_DRIVER=sqlite3 \
  -e WOODPECKER_DATABASE_SOURCE=/var/woodpecker/woodpecker.db \
  woodpecker/woodpecker-server:latest
  1. Log in and configure your GitHub/GitLab repositories for integration.
  2. Run the agent on your server or VPS using this command:
docker run -d \
  --name woodpecker-agent \
  -e WOODPECKER_SERVER=http://woodpecker.local:80 \
  -e WOODPECKER_AGENT_TOKEN=your-agent-token \
  woodpecker/woodpecker-agent:latest

System Requirements and Verification

System requirements:

  • Docker 20.10 or higher
  • Minimum 2GB RAM
  • 10GB storage
  • Linux or macOS

Verify operation:

docker logs woodpecker-server
docker logs woodpecker-agent

If no errors appear, pipelines will run automatically upon new commits.

Optimizing Your CI/CD System

Woodpecker CI enables you to:

  • Run pipelines in isolated Docker containers, ensuring application separation.
  • Reduce server load thanks to ultra-light performance.
  • Easily integrate with platforms like GitHub, GitLab, and Bitbucket.
  • Customize pipelines using shell commands, Docker, and common CI tools.

For further optimization, consider combining with MicroVMs using Ignite and Firecracker on VPS to enhance isolation and security.

Troubleshooting

  • Webhook not received from GitHub: Check callback URL and token in Woodpecker CI settings.
  • Agent fails to connect: Verify network, firewall rules, and agent token.
  • Pipeline fails: Check logs using docker logs and validate .woodpecker.yml.

References

Related infrastructure & engineering guides: High-RAM Cloud VPS for Self-Hosted LLMs & API Gateways

DPTCloud Tier III Infrastructure

High-RAM Cloud VPS Plans Optimized for AI, Databases & Cache

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02Recommended

VPS-4E

297.000 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe
ECO · vn-02

VPS-5E

614.900 ₫ / mo

10% VAT included

  • CPU: 8 vCPU
  • RAM: 16 GB
  • SSD: 100 GB NVMe
ADVANCED · vn-03Recommended

VPS-4T

548.900 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478