Quay lại danh sách
DevOps & Hệ thống

Hướng dẫn cấu hình Gitea Actions tự động đóng gói và đẩy Docker image lên GitHub Container Registry GHCR từ VPS riêng 1

Hướng dẫn chi tiết cách thiết lập Gitea Actions trên VPS riêng để tự động xây dựng, đóng gói và đẩy Docker image lên GitHub Container Registry (GHCR). Bao gồm cấu hình file...

DPTCloud Engineering4 phút đọc
Hướng dẫn cấu hình Gitea Actions tự động đóng gói và đẩy Docker image lên GitHub Container Registry GHCR từ VPS riêng 1

Giới thiệu

Trong môi trường phát triển phần mềm hiện đại, việc tự động hóa quy trình xây dựng, đóng gói và triển khai ứng dụng là yếu tố then chốt để đảm bảo hiệu suất và độ tin cậy. Gitea Actions, tương tự như GitHub Actions, cho phép bạn tạo các quy trình tự động (workflow) trên máy chủ Gitea của riêng mình, ví dụ như một VPS riêng 1. Hướng dẫn này sẽ hướng dẫn bạn cách cấu hình Gitea Actions để tự động xây dựng Docker image từ mã nguồn, đóng gói và đẩy lên GitHub Container Registry (GHCR).

Yêu cầu và chuẩn bị

  • Một máy chủ VPS riêng 1 (có thể tham khảo Cloud VPS NVMe cho Docker, Nginx & Database).
  • Giá trị SSH hoặc quyền truy cập root vào VPS.
  • Git và Gitea đã được cài đặt và cấu hình trên VPS.
  • GitHub account với quyền truy cập vào GitHub Container Registry (GHCR).
  • GitHub personal access token (PAT) với quyền repo và packages.
  • Mã nguồn ứng dụng chứa Dockerfile.

Thiết lập Gitea Actions trên VPS

Để sử dụng Gitea Actions, bạn cần đảm bảo Gitea được cấu hình để hỗ trợ hành động (actions). Trên VPS riêng 1, hãy thực hiện các bước sau:

  1. Đảm bảo Gitea phiên bản mới nhất được cài đặt. Gitea Actions được hỗ trợ từ phiên bản 1.15 trở lên.
  2. Tạo thư mục .gitea/workflows trong repository mã nguồn của bạn.
  3. Tạo file docker-build-push.yml trong thư mục này với nội dung sau:
name: Build and Push Docker Image

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  build-and-push:
    runs-on: self-hosted
    steps:
    - name: Checkout code
      uses: actions/checkout@v4

    - name: Set up Docker Buildx
      uses: docker/setup-qemu-action@v3
      with:
        platforms: linux/amd64

    - name: Set up Docker Buildx
      uses: docker/setup-buildx-action@v3

    - name: Login to GitHub Container Registry
      uses: docker/login-action@v3
      with:
        registry: ghcr.io
        username: ${{ secrets.GHCR_USERNAME }}
        password: ${{ secrets.GHCR_TOKEN }}

    - name: Build and push Docker image
      uses: docker/build-push-action@v5
      with:
        context: .
        push: true
        tags: ghcr.io/${{ github.repository }}:latest
        build-args: |
          VERSION=${{ github.sha }}

Trong file này:

  • on: push và on: pull_request định nghĩa khi nào workflow sẽ chạy.
  • runs-on: self-hosted chỉ định rằng job sẽ chạy trên máy chủ tự host (VPS riêng 1).
  • login to GitHub Container Registry sử dụng biến môi trường GHCR_USERNAME và GHCR_TOKEN.
  • build-push-action xây dựng và đẩy Docker image lên GHCR.

Thiết lập biến môi trường và xác thực

Để workflow có thể đăng nhập vào GHCR, bạn cần thiết lập các biến môi trường (secrets) trong Gitea:

  1. Truy cập vào repository trên Gitea.
  2. Chọn Settings > Repository settings > Actions.
  3. Chọn Secrets và thêm hai biến:
  • GHCR_USERNAME: Tên người dùng GitHub của bạn.
  • GHCR_TOKEN: GitHub personal access token với quyền repo và packages.

Đảm bảo token có quyền truy cập vào GHCR. Bạn có thể tạo token mới tại GitHub Settings > Developer settings > Personal access tokens.

Kiểm tra và xác thực

Sau khi cấu hình xong, đẩy một commit mới lên branch main để kích hoạt workflow. Bạn có thể theo dõi tiến trình trong tab Actions của repository trên Gitea.

Để kiểm tra xem Docker image đã được đẩy thành công lên GHCR hay chưa, hãy thực hiện lệnh sau trên VPS riêng 1:

docker pull ghcr.io/your-username/your-repo:latest

Thay your-username và your-repo bằng tên thực tế của bạn. Nếu lệnh chạy thành công, image đã được đẩy lên GHCR.

Giải quyết sự cố

  • Workflow không chạy: Kiểm tra xem Gitea có hỗ trợ Actions không và phiên bản Gitea có đủ mới không. Kiểm tra log của job để tìm lỗi.
  • Không thể đăng nhập vào GHCR: Đảm bảo token có quyền packages và repo. Kiểm tra lại biến môi trường GHCR_USERNAME và GHCR_TOKEN trong Gitea.
  • Image không xuất hiện trên GHCR: Kiểm tra log của job để xem có lỗi xây dựng Docker image không. Đảm bảo Dockerfile tồn tại và đúng định dạng.

Tài liệu tham khảo

Chú ý: Hướng dẫn này được xây dựng dựa trên kiến thức chung về Gitea Actions và GitHub Container Registry. Không có tài liệu web cụ thể được trích dẫn trong kết quả tìm kiếm, do đó các bước được trình bày là tổng hợp từ kiến thức kỹ thuật phổ biến và cấu hình thực tế.

Tham khảo hạ tầng & bài viết liên quan: MeshCentral: Trung tâm điều khiển và hỗ trợ IT từ xa cấp doanh nghiệp qua trình duyệt

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

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

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478