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...
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ị
SSHhoặc quyền truy cậprootvà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
repovà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:
- Đả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.
- Tạo thư mục
.gitea/workflowstrong repository mã nguồn của bạn. - Tạo file
docker-build-push.ymltrong 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: pushvàon: pull_requestđịnh nghĩa khi nào workflow sẽ chạy.runs-on: self-hostedchỉ định rằng job sẽ chạy trên máy chủ tự host (VPS riêng 1).login to GitHub Container Registrysử dụng biến môi trườngGHCR_USERNAMEvàGHCR_TOKEN.build-push-actionxâ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:
- Truy cập vào repository trên Gitea.
- Chọn
Settings>Repository settings>Actions. - Chọn
Secretsvà 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ềnrepovà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
packagesvàrepo. Kiểm tra lại biến môi trườngGHCR_USERNAMEvàGHCR_TOKENtrong 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
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%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
