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

Tích hợp VPS với GitHub Actions: Xây dựng CI/CD pipeline chuyên nghiệp cho dự án cá nhân

Đây là hướng dẫn chi tiết về cách tích hợp VPS với GitHub Actions để xây dựng một pipeline CI/CD chuyên nghiệp, tự động hóa quy trình phát triển, kiểm thử và triển khai cho các dự...

DPTCloud Engineering4 phút đọc
Tích hợp VPS với GitHub Actions: Xây dựng CI/CD pipeline chuyên nghiệp cho dự án cá nhân

Đây là hướng dẫn chi tiết về cách tích hợp VPS với GitHub Actions để xây dựng một pipeline CI/CD chuyên nghiệp, tự động hóa quy trình phát triển, kiểm thử và triển khai cho các dự án cá nhân. Hướng dẫn này bao gồm thiết lập SSH key, cấu hình workflow, triển khai ứng dụng tự động và các bước kiểm tra, đảm bảo tính ổn định và bảo mật cho hệ thống.

Giới thiệu về CI/CD và lợi ích với dự án cá nhân

CI/CD (Continuous Integration / Continuous Deployment) là một phần quan trọng trong DevOps, giúp tự động hóa các bước kiểm thử và triển khai mã nguồn. Với dự án cá nhân, việc xây dựng một pipeline CI/CD chuyên nghiệp giúp giảm thiểu lỗi, tăng tốc độ phát triển và đảm bảo mã nguồn luôn ở trạng thái ổn định. GitHub Actions là nền tảng CI/CD tích hợp sẵn với GitHub, cho phép bạn tạo các workflow tự động chạy khi có thay đổi trên repository.

Tích hợp VPS với GitHub Actions cho phép bạn triển khai mã nguồn trực tiếp lên máy chủ của mình mà không cần phải thực hiện các thao tác thủ công. Điều này đặc biệt hữu ích khi bạn muốn kiểm soát hoàn toàn môi trường triển khai, sử dụng các công nghệ như Docker, Nginx, hoặc cơ sở dữ liệu trên VPS. Với các VPS NVMe như được giới thiệu tại Cloud VPS NVMe cho Docker, Nginx & Database, bạn có thể tận dụng hiệu năng cao để chạy các ứng dụng và pipeline CI/CD một cách mượt mà.

Thiết lập SSH key để kết nối GitHub Actions với VPS

Để GitHub Actions có thể kết nối và triển khai mã lên VPS, bạn cần tạo SSH key và thêm public key vào VPS. Bước đầu tiên là tạo cặp SSH key trên máy tính của bạn:

ssh-keygen -t ed25519 -C "github-actions@vps" -f ~/.ssh/github_actions

Sau khi tạo xong, bạn cần thêm public key vào file ~/.ssh/authorized_keys trên VPS. Bạn có thể sử dụng lệnh sau để sao chép public key:

ssh-copy-id -i ~/.ssh/github_actions.pub user@your-vps-ip

Thay user bằng tên người dùng trên VPS và your-vps-ip bằng địa chỉ IP của VPS. Sau khi kết nối thành công, bạn cần thêm SSH key vào GitHub Actions bằng cách tạo một secret trong repository của bạn.

Cấu hình GitHub Actions workflow

Trong repository của bạn, tạo thư mục .github/workflows và tạo tệp deploy.yml. Dưới đây là một ví dụ về workflow đơn giản để triển khai một ứng dụng Node.js lên VPS:

name: Deploy to VPS

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Deploy to VPS
        uses: appleboy/ssh-action@v1
        with:
          host: ${{ secrets.VPS_HOST }}
          username: ${{ secrets.VPS_USER }}
          key: ${{ secrets.VPS_SSH_KEY }}
          port: 22
          script: |
            cd /home/user/myproject
            git pull origin main
            npm install
            npm run build
            pm2 restart app

Trong ví dụ trên, bạn cần tạo các secret sau trong GitHub repository:

  • VPS_HOST: Địa chỉ IP hoặc tên miền của VPS.
  • VPS_USER: Tên người dùng trên VPS.
  • VPS_SSH_KEY: Private key SSH được mã hóa base64.

Để tạo secret, vào repository của bạn, chọn Settings → Secrets and variables → Actions → New repository secret. Nhập tên secret và giá trị tương ứng.

Thực hiện kiểm tra và triển khai tự động

Sau khi cấu hình workflow, mỗi lần bạn push mã lên branch main, GitHub Actions sẽ tự động chạy pipeline. Quy trình bao gồm:

  1. Checkout mã nguồn từ repository.
  2. Kết nối đến VPS qua SSH.
  3. Tự động cập nhật mã, cài đặt dependencies và khởi động lại ứng dụng.

Để kiểm tra xem pipeline có hoạt động đúng không, bạn có thể tạo một commit nhỏ và kiểm tra trạng thái của workflow trong tab Actions của repository. Nếu mọi thứ hoạt động, bạn sẽ thấy log triển khai thành công trên VPS.

Giải quyết sự cố và bảo mật

Trong quá trình triển khai, bạn có thể gặp một số lỗi như kết nối SSH bị từ chối, không có quyền truy cập hoặc lỗi khi chạy lệnh trên VPS. Để khắc phục:

  • Đảm bảo SSH key được thêm đúng vào VPS.
  • Kiểm tra firewall trên VPS cho phép kết nối từ GitHub Actions.
  • Đảm bảo các lệnh trong script chạy được trên VPS.

Để tăng bảo mật, bạn nên:

  • Không lưu SSH key trong mã nguồn.
  • Sử dụng các secret thay vì hardcode thông tin nhạy cảm.
  • Đặt giới hạn quyền truy cập cho các key SSH.

Việc tích hợp VPS với GitHub Actions giúp bạn xây dựng một pipeline CI/CD chuyên nghiệp, tự động hóa quy trình phát triển và triển khai cho dự án cá nhân. Với các công nghệ như Docker và Nginx được hỗ trợ trên VPS NVMe, bạn có thể triển khai các ứng dụng quy mô lớn một cách hiệu quả và ổn định.

Tham khảo hạ tầng & bài viết liên quan: Đánh giá top control panel quản lý VPS tốt nhất hiện nay

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