Hướng dẫn Setup Jenkins cho hệ thống Monolith - Bài 7: Xây dựng Jenkins Job đầu tiên dạng Freestyle cho dự án Monolith

Trước khi bước sang dạng Scripted/Declarative Pipeline nâng cao, Freestyle Project là loại Job trực quan (giao diện click-and-configure) hoàn hảo nhất để làm quen với cách Jenkins tiếp nhận mã nguồn, thực thi lệnh và trả kết quả.

1. Freestyle Job là gì và vai trò đối với Monolith?

• Bản chất: Là loại job cơ bản nhất trong Jenkins, cho phép bạn cấu hình từng bước (step-by-step) thông qua các form giao diện web mà không cần viết mã lệnh Pipeline ngay.

• Ứng dụng với Monolith: Rất thích hợp để kiểm tra nhanh tính tương thích của mã nguồn nguyên khối (Monolith) với môi trường Jenkins trước khi chuẩn hóa thành code dài hạn trong Jenkinsfile.

2. Các bước cấu hình một Freestyle Job hoàn chỉnh cho Monolith

Bước 1: Tạo mới Item trong Jenkins

1. Đăng nhập vào giao diện Jenkins, chọn New Item ở menu bên trái.

2. Nhập tên dự án (ví dụ: monolith-app-freestyle).

3. Chọn Freestyle project và bấm OK ở cuối trang.

Bước 2: Cấu hình Source Code Management (Kết nối Git)

1. Chuyển đến tab General, bạn có thể viết mô tả ngắn gọn cho Job.

2. Cuộn xuống phần Source Code Management:

   • Tích chọn Git.

   • Repository URL: Dán đường dẫn SSH tới kho chứa mã nguồn Monolith của bạn (ví dụ: git@github.com:your-org/monolith-backend.git).

   • Credentials: Chọn đúng định danh SSH Key (jenkins-git-ssh-key) đã thiết lập ở Bài 5.

   • Branches to build: Nhập nhánh cần build (ví dụ: */main hoặc */master).

Bước 3: Cấu hình Build Triggers (Kích hoạt bản dựng)

Chọn thời điểm Jenkins sẽ tự động chạy Job này:

• Poll SCM: Kiểm tra định kỳ xem Git có code mới hay không (ví dụ: H/5 * * * * nghĩa là cứ 5 phút check một lần).

• Hoặc để trống nếu bạn muốn tự bấm thủ công (Build Now) trong giai đoạn thử nghiệm.

Bước 4: Thêm các bước thực thi (Build Steps)

Cuộn xuống phần Build, bấm Add build step và chọn Execute shell (nếu chạy trên Linux Agent): Dán tập lệnh build phù hợp với công nghệ Monolith của bạn. Ví dụ:

• Đối với Java Spring Boot Monolith (Maven):

  Bash

  echo "=== Bat dau build Monolith Java ==="
  mvn clean package -DskipTests
  echo "=== Build thanh cong! ==="
  
  

• Đối với Node.js / PHP Monolith:

  Bash

  echo "=== Cai dat dependencies ==="
  npm install # hoặc composer install
  echo "=== Chạy build hoàn tất ==="
  
  

Bước 5: Lưu và Chạy thử (Build Now)

1. Bấm Save ở cuối trang để lưu lại cấu hình Job.

2. Tại màn hình quản lý Job vừa tạo, bấm vào nút Build Now ở thanh menu bên trái.

3. Quan sát mục Build History xuất hiện một vòng tròn màu xám/xanh đang chạy.

3. Kiểm tra kết quả qua Console Output

• Click vào số thứ tự lần build vừa rồi (ví dụ: #1).

• Chọn Console Output để xem toàn bộ log thời gian thực: Jenkins clone code từ Git thế nào, chạy lệnh build ra sao và kết quả trả về có thành công hay gặp lỗi.