1. Đặt vấn đề: Bài toán tối ưu chi phí và bảo mật mã nguồn cho doanh nghiệp nhỏ

Trong kỷ nguyên chuyển đổi số, việc quản trị mã nguồn (Source Code Management) và tự động hóa quy trình triển khai (CI/CD) là xương sống của mọi đội ngũ phát triển phần mềm. Tuy nhiên, đối với các doanh nghiệp vừa và nhỏ (SMEs) hoặc các nhóm khởi nghiệp, việc sử dụng các nền tảng đám mây lớn như GitHub Enterprise, GitLab SaaS hay Bitbucket thường đi kèm với hai thách thức lớn: chi phí bản quyền theo đầu người (per-user license) tăng cao và nguy cơ rò rỉ dữ liệu nhạy cảm khi lưu trữ trên đám mây công cộng.

Một giải pháp thay thế phổ biến là tự vận hành (Self-hosted) hệ thống riêng. Thế nhưng, nếu lựa chọn GitLab tự lưu trữ, doanh nghiệp sẽ cần một máy chủ VPS có cấu hình tối thiểu từ 4GB đến 8GB RAM để vận hành mượt mà. Đây là một khoản chi phí không hề nhỏ khi nhân rộng hệ thống. Câu hỏi đặt ra là: Liệu có giải pháp nào vừa đảm bảo tính năng quản trị mã nguồn hiện đại, vừa có khả năng chạy CI/CD tự động mà chỉ tiêu tốn chưa đến 1GB RAM?

Câu trả lời chính là sự kết hợp hoàn hảo giữa Gitea và Woodpecker CI. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách xây dựng hệ thống DevOps siêu nhẹ này trên một máy chủ VPS cấu hình tối giản.

2. Tại sao lại là Gitea và Woodpecker CI?

Để hiểu tại sao cặp đôi này lại là "vũ khí hạng nhẹ" tối ưu nhất hiện nay, hãy cùng điểm qua các ưu điểm vượt trội của chúng:

Gitea - Bản sao siêu nhẹ của GitHub

Gitea là một giải pháp quản trị mã nguồn Git được viết bằng ngôn ngữ Go. Nó kế thừa giao diện thân thiện, trực quan của GitHub nhưng lại có hiệu năng cực kỳ ấn tượng. Gitea có thể chạy mượt mà trên một máy sấy tóc (nói vui) hoặc cụ thể là một bo mạch Raspberry Pi hay một VPS có chỉ 512MB RAM. Dù nhẹ, Gitea vẫn cung cấp đầy đủ các tính năng cốt lõi: Quản lý Repository, Pull Request, Review Code, Quản lý Issue, và Phân quyền tổ chức (Organizations/Teams).

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

Trước đây, Drone CI là lựa chọn hàng đầu cho CI/CD gọn nhẹ. Tuy nhiên, sau khi Drone thay đổi mô hình cấp phép, cộng đồng đã fork và phát triển thành Woodpecker CI hoàn toàn mã nguồn mở (MIT License). Woodpecker hoạt động dựa trên cơ chế Container-native: mọi bước (step) trong pipeline đều chạy biệt lập trong các Docker container. Điều này giúp tối ưu hóa tài nguyên hệ thống và đảm bảo môi trường build luôn sạch sẽ.

3. Kiến trúc hệ thống và chuẩn bị tài nguyên

Mô hình triển khai của chúng ta sẽ bao gồm một máy chủ duy nhất đóng vai trò điều phối. Để hệ thống hoạt động ổn định, cấu hình khuyến nghị như sau:

CPU: 1 vCPU hoặc 2 vCPU
RAM: 1GB hoặc 2GB (Hệ thống có thể chạy ở mức 1GB RAM bao gồm cả hệ điều hành nếu tối ưu tốt)
Hệ điều hành: Ubuntu Server 22.04 LTS hoặc 24.04 LTS
Công cụ bổ sung: Docker và Docker Compose

Lưu ý quan trọng: Để đảm bảo VPS không bị tràn bộ nhớ khi thực hiện các tác vụ build mã nguồn nặng, bạn bắt buộc phải cấu hình Swap Space (khuyến nghị từ 2GB đến 4GB Swap).

4. Hướng dẫn triển khai từng bước bằng Docker Compose

Phương pháp triển khai tối ưu và dễ quản lý nhất là sử dụng Docker Compose. Chúng ta sẽ gom cả Gitea, Woodpecker Server và Woodpecker Agent vào chung một file cấu hình.

Bước 1: Cài đặt Docker và Docker Compose

Truy cập vào VPS qua SSH và chạy lệnh cập nhật hệ thống cùng cài đặt Docker:

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

Bước 2: Tạo cấu hình Docker Compose

Tạo một thư mục mới có tên devops-stack và tạo file docker-compose.yml bên trong thư mục đó với nội dung cấu hình chuẩn hóa sau:

version: '3.8'

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

  woodpecker-server:
    image: woodpeckerci/woodpecker-server:latest
    container_name: woodpecker-server
    ports:
      - "8000:8000"
    volumes:
      - ./woodpecker-server-data:/var/lib/woodpecker
    environment:
      - WOODPECKER_GITEA=true
      - WOODPECKER_GITEA_URL=http://gitea:3000
      - WOODPECKER_GITEA_CLIENT=${GITEA_CLIENT_ID}
      - WOODPECKER_GITEA_SECRET=${GITEA_CLIENT_SECRET}
      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
      - WOODPECKER_HOST=http://:8000
    restart: always

  woodpecker-agent:
    image: woodpeckerci/woodpecker-agent:latest
    container_name: woodpecker-agent
    command: agent
    restart: always
    depends_on:
      - woodpecker-server
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WOODPECKER_SERVER=woodpecker-server:8000
      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
      - WOODPECKER_MAX_WORKERS=1

5. Liên kết Woodpecker CI với Gitea thông qua OAuth2

Để hai hệ thống này có thể giao tiếp an toàn với nhau, chúng ta cần thiết lập kết nối OAuth2:

Khởi chạy Gitea bằng lệnh docker-compose up -d gitea và truy cập vào giao diện web qua cổng 3000 để hoàn tất cài đặt ban đầu.
Đăng nhập vào Gitea, đi đến phần Settings (Cài đặt) -> Applications (Ứng dụng) -> Manage OAuth2 Applications.
Tạo một ứng dụng mới với tên "Woodpecker CI". Tại ô Redirect URI, điền chính xác địa chỉ: http://:8000/login.
Hệ thống sẽ cấp cho bạn một Client ID và Client Secret. Hãy sao chép thông tin này điền vào file môi trường hoặc cập nhật trực tiếp vào file docker-compose.yml ở bước trên cùng với một chuỗi ký tự ngẫu nhiên cho WOODPECKER_AGENT_SECRET.
Chạy lệnh docker-compose up -d để khởi động toàn bộ hệ thống.

6. Trải nghiệm thực tế và tối ưu hóa hiệu năng cho VPS yếu

Sau khi hệ thống vận hành, bạn sẽ thấy một sự ngạc nhiên lớn về mặt hiệu năng. Khi ở trạng thái nghỉ (Idle), Gitea chỉ tiêu thụ khoảng 100MB - 150MB RAM, trong khi Woodpecker Server và Agent chỉ tốn thêm khoảng 50MB RAM nữa. Tổng dung lượng tài nguyên chiếm dụng chưa tới 250MB RAM — một con số không tưởng nếu so sánh với gã khổng lồ GitLab (thường ngốn tối thiểu 2.5GB RAM ngay khi vừa khởi động).

Để hệ thống hoạt động bền bỉ dài lâu trên các dòng VPS giá rẻ, hãy áp dụng các mẹo tối ưu hóa sau:

Giới hạn Worker: Trong file cấu hình Agent, hãy đặt thuộc tính WOODPECKER_MAX_WORKERS=1. Việc này đảm bảo tại một thời điểm, hệ thống chỉ xử lý duy nhất một tác vụ build, tránh tình trạng CPU bị quá tải (100% load) dẫn đến treo máy chủ.
Tận dụng Docker Cache: Trong các file cấu hình pipeline .woodpecker.yml, luôn sử dụng các plugin hỗ trợ cache (như cache cho node_modules hoặc các gói thư viện Maven/Go) để giảm thời gian build và giảm tải cho ổ đĩa I/O của VPS.
Sử dụng Reverse Proxy chuyên dụng: Nên cấu hình thêm Nginx hoặc Caddy phía trước để xử lý chứng chỉ SSL (HTTPS) miễn phí từ Let's Encrypt, giúp bảo mật toàn bộ luồng dữ liệu truyền tải giữa người dùng và hệ thống nội bộ.

7. Lời kết

Xây dựng một hệ thống DevOps tự chủ không nhất thiết phải đi đôi với hóa đơn chi phí hạ tầng đắt đỏ. Sự kết hợp giữa Gitea và Woodpecker CI đã chứng minh rằng một giải pháp mã nguồn mở, tinh gọn hoàn toàn có thể đáp ứng xuất sắc nhu cầu quản trị và tự động hóa của doanh nghiệp trên một hạ tầng phần cứng tối giản. Hãy bắt tay vào triển khai ngay hôm nay để làm chủ công nghệ và tối ưu hóa quy trình làm việc cho đội ngũ của bạn.

Tối Ưu Hóa Chi Phí DevOps: Triển Khai Gitea Kết Hợp Woodpecker CI Trên VPS Cấu Hình Thấp