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

Xây dựng hệ thống phân tích và chấm điểm mã nguồn tự động SAST bằng SonarQube trên VPS

Guide này hướng dẫn chi tiết cách triển khai hệ thống phân tích mã nguồn tự động (SAST) bằng SonarQube trên máy chủ VPS, bao gồm cài đặt, cấu hình, tích hợp CI/CD và kiểm tra chất...

DPTCloud Engineering4 phút đọc
Xây dựng hệ thống phân tích và chấm điểm mã nguồn tự động SAST bằng SonarQube trên VPS

Guide này hướng dẫn chi tiết cách triển khai hệ thống phân tích mã nguồn tự động (SAST) bằng SonarQube trên máy chủ VPS, bao gồm cài đặt, cấu hình, tích hợp CI/CD và kiểm tra chất lượng mã. Hướng dẫn này phù hợp với các tổ chức muốn xây dựng quy trình kiểm tra mã tự động, phát hiện lỗi bảo mật và cải thiện chất lượng mã nguồn trong môi trường DevOps với ngân sách hạn chế.

Tổng quan về SonarQube và SAST

SonarQube là một nền tảng mã nguồn mở mạnh mẽ để phân tích và đánh giá chất lượng mã nguồn, hỗ trợ nhiều ngôn ngữ lập trình như Java, Python, JavaScript, C#, và hơn 30 ngôn ngữ khác. Với khả năng phát hiện lỗi bảo mật, quy chuẩn mã, và đo lường chất lượng mã, SonarQube là công cụ thiết yếu trong quy trình DevOps. SAST (Static Application Security Testing) là phương pháp phân tích mã nguồn mà không cần chạy ứng dụng, giúp phát hiện lỗ hổng bảo mật sớm trong quá trình phát triển.

Triển khai SonarQube trên VPS cho phép tổ chức kiểm soát hoàn toàn hệ thống, tùy chỉnh theo nhu cầu và giảm chi phí so với các giải pháp đám mây. Hướng dẫn này sử dụng VPS NVMe từ Cloud VPS NVMe cho Docker, Nginx & Database, cung cấp hiệu năng cao và khả năng mở rộng linh hoạt.

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

Để triển khai thành công, bạn cần:

  • Một máy chủ VPS với tối thiểu 4GB RAM, 2 CPU cores và 50GB SSD (tối ưu hơn với NVMe).
  • Hệ điều hành Linux (Ubuntu 20.04/22.04 hoặc CentOS 8/9).
  • Access SSH với quyền root hoặc user có sudo.
  • Đã cài đặt Docker và Docker Compose (dùng để triển khai SonarQube và PostgreSQL).

Đảm bảo VPS đã được cập nhật hệ thống:

sudo apt update && sudo apt upgrade -y

Khởi tạo Docker nếu chưa có:

sudo apt install docker.io docker-compose -y

Triển khai SonarQube và PostgreSQL

SonarQube yêu cầu cơ sở dữ liệu để lưu trữ thông tin phân tích. Chúng ta sẽ sử dụng PostgreSQL qua Docker Compose. Tạo file `docker-compose.yml`:

version: '3.8'
services:
  sonarqube:
    image: sonarqube:latest
    container_name: sonarqube
    ports:
      - "9000:9000"
    volumes:
      - sonarqube_data:/opt/sonarqube/data
      - sonarqube_logs:/opt/sonarqube/logs
      - sonarqube_extensions:/opt/sonarqube/extensions
    environment:
      - SONARQUBE_JDBC_URL=jdbc:postgresql://postgres:5432/sonar
      - SONARQUBE_JDBC_USERNAME=sonar
      - SONARQUBE_JDBC_PASSWORD=sonar
    depends_on:
      - postgres
  postgres:
    image: postgres:13
    container_name: sonarqube_postgres
    environment:
      - POSTGRES_DB=sonar
      - POSTGRES_USER=sonar
      - POSTGRES_PASSWORD=sonar
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"
volumes:
  sonarqube_data:
  sonarqube_logs:
  sonarqube_extensions:
  postgres_data:

Chạy lệnh để khởi động:

docker-compose up -d

Sau khi khởi động, truy cập http://your-vps-ip:9000 để đăng nhập (mật khẩu mặc định: admin/admin). Thay đổi mật khẩu ngay lập tức.

Tích hợp CI/CD và phân tích mã tự động

Để phân tích mã tự động, bạn cần tích hợp SonarQube với CI/CD như GitHub Actions, GitLab CI hoặc Jenkins. Dưới đây là ví dụ với GitHub Actions:

Tạo file `.github/workflows/sonarqube.yml`:

name: SonarQube Analysis
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]
jobs:
  sonarqube:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    - name: SonarQube Scan
      uses: sonarqube/sonarqube-scan-action@v1
      with:
        projectKey: my-project
        organization: my-organization
        token: ${{ secrets.SONAR_TOKEN }}

Trong SonarQube, tạo một project mới và lấy token từ http://your-vps-ip:9000 (User Settings → Security → Tokens).

Kiểm tra và bảo trì

Để đảm bảo hệ thống hoạt động ổn định, thực hiện các bước sau:

  • Thường xuyên kiểm tra log của SonarQube: docker logs sonarqube
  • Backup cơ sở dữ liệu PostgreSQL định kỳ.
  • Cập nhật SonarQube và plugin định kỳ để nhận các bản vá bảo mật.
  • Giám sát tài nguyên VPS (RAM, CPU, disk) để tránh quá tải.

Tham khảo thêm các hướng dẫn chuyên sâu về DevOps tại Kubernetes trên VPS: Hướng dẫn xây dựng K8s cluster chuyên nghiệp với ngân sách dưới 50 USD/tháng và Chiến lược Green DevOps: Cấu hình Keda để tự động tắt bot Node.js trên VPS khi thấp điểm.

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