DPTCloud
Quay lại danh sách
Tin tức công nghệ

Tối ưu hóa chi phí DevOps: Triển khai Gitea và Woodpecker CI trên VPS cấu hình tối giản

27 tháng 5, 2026

Giới thiệu xu hướng tối ưu hóa hạ tầng DevOps

Trong kỷ nguyên số hóa, việc quản lý mã nguồn và tự động hóa quy trình triển khai phần mềm (CI/CD) đã trở thành xương sống của mọi đội ngũ phát triển. Tuy nhiên, đối với các doanh nghiệp vừa và nhỏ (SMEs) hoặc các nhóm startup, chi phí duy trì các nền tảng đám mây lớn như GitHub Enterprise, GitLab Ultimate hay Bitbucket có thể trở thành một gánh nặng tài chính đáng kể. Đặc biệt hơn, vấn đề bảo mật mã nguồn nội bộ và quyền kiểm soát dữ liệu tuyệt đối đang khiến nhiều nhà quản trị tìm kiếm giải pháp tự lưu trữ (self-hosted).

Nhắc đến self-hosted, GitLab thường là cái tên đầu tiên được nghĩ tới. Tuy nhiên, GitLab khét tiếng là một "quái vật" ngốn tài nguyên, yêu cầu cấu hình tối thiểu thường từ 4GB đến 8GB RAM để hoạt động ổn định. Đối với một VPS (Virtual Private Server) cấu hình tối giản (chỉ 1GB hoặc 2GB RAM), việc chạy GitLab là điều hoàn toàn bất khả thi. Đó chính là lý do sự kết hợp giữa Gitea và Woodpecker CI trở thành một giải pháp cứu cánh hoàn hảo: Siêu nhẹ, tốc độ cao, và tiêu tốn cực kỳ ít tài nguyên.

Tại sao lại chọn Gitea và Woodpecker CI?

Để hiểu tại sao cặp bài trùng này lại hoạt động hiệu quả trên phần cứng giới hạn, chúng ta hãy cùng phân tích các ưu điểm vượt trội của từng công cụ:

1. Gitea - Nền tảng Git tự lưu trữ tinh gọn

Gitea là một giải pháp quản trị mã nguồn được viết bằng ngôn ngữ Go (Golang). Nhờ đặc tính biên dịch trực tiếp ra mã máy của Go, Gitea có tốc độ thực thi cực kỳ nhanh và mức chiếm dụng bộ nhớ RAM thấp đến kinh ngạc (chỉ khoảng 50MB - 100MB ở trạng thái chờ). Gitea cung cấp đầy đủ các tính năng cốt lõi tương tự như GitHub bao gồm: Quản lý kho mã nguồn (Repositories), Kiểm soát nhánh (Branch protection), Quản lý lỗi (Issues tracking), và Quy trình phê duyệt mã (Pull Requests).

2. Woodpecker CI - Công cụ CI/CD kế thừa tinh hoa

Được phát triển từ nhánh rẽ (fork) của dự án Drone CI (phiên bản mã nguồn mở trước khi chuyển sang mô hình thương mại), Woodpecker CI duy trì triết lý đơn giản và hiệu quả. Hệ thống này sử dụng các container Docker để cô lập và thực thi các pipeline. Điểm mạnh của Woodpecker CI là kiến trúc tách biệt giữa Server (điều phối) và Agent (thực thi), cho phép cấu hình linh hoạt và chỉ tiêu tốn tài nguyên khi có pipeline kích hoạt.

Kiến trúc tổng quan của hệ thống

Mô hình triển khai tối ưu trên một máy chủ VPS đơn lẻ sẽ bao gồm các thành phần được đóng gói hoàn toàn trong môi trường Docker để dễ dàng quản lý và cô lập tài nguyên:

  • Nginx Proxy Manager / Traefik: Đóng vai trò làm Reverse Proxy, tiếp nhận các yêu cầu HTTPS từ ngoài Internet và điều hướng vào nội bộ, đồng thời tự động gia hạn chứng chỉ SSL Let's Encrypt.
  • Gitea Server: Lưu trữ mã nguồn, xử lý các thao tác Git và cung cấp giao diện Web UI cho lập trình viên.
  • Woodpecker Server & Agent: Server lắng nghe Webhook từ Gitea khi có sự kiện (Push, PR), sau đó ra lệnh cho Agent tạo ra các Docker container tạm thời để biên dịch, kiểm thử (Test) và đóng gói ứng dụng.
  • Database (PostgreSQL hoặc SQLite): Để tối ưu hóa cho cấu hình 1GB RAM, SQLite là sự lựa chọn hợp lý nhất vì không chạy tiến trình ngầm tốn RAM. Đối với VPS 2GB RAM, PostgreSQL sẽ mang lại hiệu năng truy vấn tốt hơn và an toàn dữ liệu cao hơn.

Hướng dẫn các bước triển khai chi tiết

Dưới đây là quy trình từng bước để hiện thực hóa hệ thống CI/CD siêu nhẹ này trên hệ điều hành Ubuntu Server.

Bước 1: Chuẩn bị môi trường máy chủ

Trước tiên, hãy cập nhật hệ thống và cài đặt Docker cùng Docker Compose. Đây là nền tảng giúp việc khởi chạy Gitea và Woodpecker trở nên đồng bộ và nhanh chóng.

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose -y
sudo systemctl enable --now docker

Bước 2: Cấu hình File docker-compose.yml

Tạo một thư mục dự án và thiết lập tệp cấu hình hợp nhất cho cả Gitea và Woodpecker CI. Việc đặt chung vào một tệp Docker Compose giúp chúng chia sẻ chung một mạng nội bộ (Docker Network), tăng tính bảo mật và tốc độ giao tiếp.

version: '3'

services:
  gitea:
    image: gitea/gitea:latest
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3000:3000"
      - "222:22"
    restart: always

  woodpecker-server:
    image: woodpeckerci/woodpecker-server:latest
    container_name: woodpecker-server
    volumes:
      - ./woodpecker-server:/var/lib/woodpecker
    ports:
      - "8000:8000"
    environment:
      - WOODPECKER_GITEA=true
      - WOODPECKER_GITEA_URL=http://gitea:3000
      - WOODPECKER_GITEA_CLIENT=your_oauth_client_id
      - WOODPECKER_GITEA_SECRET=your_oauth_client_secret
      - WOODPECKER_AGENT_SECRET=a_secure_random_string
    restart: always

  woodpecker-agent:
    image: woodpeckerci/woodpecker-agent:latest
    container_name: woodpecker-agent
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WOODPECKER_SERVER=woodpecker-server:8000
      - WOODPECKER_AGENT_SECRET=a_secure_random_string
    restart: always

Lưu ý quan trọng: Ở lần chạy đầu tiên, bạn cần comment (ẩn) phần cấu hình liên quan đến OAuth của Woodpecker, khởi chạy Gitea trước để tạo tài khoản Admin, sau đó tạo OAuth2 Application trong cài đặt của Gitea để lấy Client ID và Secret điền ngược lại vào cấu hình Woodpecker.

Bước 3: Khởi chạy và thiết lập Webhook

Chạy lệnh docker-compose up -d để khởi động toàn bộ dịch vụ. Truy cập giao diện Gitea qua cổng 3000 để hoàn tất cài đặt ban đầu. Sau khi cấu hình xong Woodpecker Server kết nối với Gitea thông qua OAuth2, khi bạn đăng nhập vào Woodpecker, hệ thống sẽ tự động đồng bộ danh sách repo từ Gitea sang. Bạn chỉ cần bật kích hoạt (Enable) repo mong muốn, Woodpecker sẽ tự động thêm Webhook vào Gitea.

Viết Pipeline đầu tiên với Woodpecker CI

Để kiểm tra hệ thống hoạt động chính xác, hãy tạo một tệp có tên .woodpecker.yml ở thư mục gốc của kho mã nguồn của bạn. Cú pháp cấu hình của Woodpecker vô cùng thân quen nếu bạn đã từng làm việc với Drone hoặc GitHub Actions:

clone:
  git:
    image: woodpeckerci/plugin-git:latest

pipeline:
  test:
    image: node:18-alpine
    commands:
      - npm install
      - npm run test

  build:
    image: docker:alpine
    commands:
      - echo "Ứng dụng đã biên dịch thành công!"

Khi bạn thực hiện một lệnh git push lên Gitea, một tín hiệu webhook sẽ ngay lập tức được gửi tới Woodpecker Server. Server sẽ phân tích tệp .woodpecker.yml và giao việc cho Agent. Agent lập tức tải các Docker image tương ứng (như Node.js hoặc Docker Alpine) để chạy các câu lệnh kiểm thử và biên dịch theo trình tự một cách tự động.

Bí quyết tối ưu hóa tài nguyên cho VPS cấu hình thấp

Mặc dù Gitea và Woodpecker đã rất nhẹ, nhưng để đảm bảo hệ thống không bao giờ gặp tình trạng sập nguồn do tràn bộ nhớ (Out of Memory - OOM), bạn nên áp dụng các quy tắc vàng sau:

  1. Kích hoạt Swap Memory: Luôn tạo thêm từ 2GB đến 4GB Swap trên ổ cứng SSD của VPS. Tạo Swap đóng vai trò như một chiếc phao cứu sinh, giúp hệ thống không bị đứng hoàn toàn khi lượng RAM vật lý bị quá tải đột biến trong lúc build code.
  2. Giới hạn số lượng tiến trình song song: Cấu hình biến môi trường WOODPECKER_MAX_WORKERS=1 hoặc 2 trong Woodpecker Agent. Việc giới hạn này đảm bảo hệ thống chỉ thực hiện tối đa 1 hoặc 2 job cùng một thời điểm, tránh việc sinh ra quá nhiều container cùng lúc làm cạn kiệt tài nguyên CPU và RAM.
  3. Định kỳ dọn dẹp Docker: Các tiến trình CI/CD liên tục sinh ra các image rác và container vô danh (dangling images). Hãy thiết lập một tác vụ tự động (Cronjob) định kỳ hàng tuần chạy lệnh docker system prune -f để giải phóng dung lượng ổ cứng.

Kết luận

Việc kết hợp Gitea và Woodpecker CI tạo ra một hệ sinh thái DevOps tự lưu trữ đỉnh cao, đáp ứng toàn diện các tiêu chí: Rẻ - Nhẹ - Bảo mật. Chỉ với một chiếc VPS chi phí thấp, doanh nghiệp hoàn toàn có thể sở hữu một hạ tầng quản lý mã nguồn và tự động hóa chuyên nghiệp không thua kém các công cụ đắt tiền trên thị trường. Đây là bước đi chiến lược giúp các đội ngũ kỹ thuật tối ưu hóa chi phí vận hành mà vẫn duy trì được tốc độ phát triển phần mềm nhanh chóng và an toàn.

Tối ưu hóa chi phí DevOps: Triển khai Gitea và Woodpecker CI trên VPS cấu hình tối giản | DPTCloud