🔧 CI/CD với Jenkins

Nhiệm vụ của CI không phải là "deploy". Nhiệm vụ của nó là biến một commit thành một artifact đáng tin cậy — đã test, đã quét, đã gắn tag bất biến — rồi ghi ý định deploy vào Git. Việc đưa lên cluster là của ArgoCD. Tách hai việc này là điểm then chốt.

Mười mục: nguyên lý và ranh giới CI/CD (1) → Jenkins trên Kubernetes (2) → Jenkinsfile đầy đủ (3) → build theo runtime (4) → cổng chất lượng (5) → ECR và cập nhật GitOps (6) → shared library (7) → credentials (8) → GitHub Actions / GitLab CI (9) → checklist (10).

Nguyên lý: CI làm gì, CD làm gì

Ranh giới cần giữ rõ: Jenkins không gọi kubectl apply và không gọi helm upgrade vào production. Nó build, test, quét, push ảnh, rồi commit một dòng vào repo cấu hình. ArgoCD thấy commit đó và đồng bộ cluster.

Luồng đầy đủ — bấm từng bước

➜
➜
➜
➜
➜
➜

Vì sao không để Jenkins deploy trực tiếp

Jenkins gọi helm upgradeJenkins commit vào Git, ArgoCD sync
Jenkins cần credential có quyền ghi vào cluster production. Jenkins bị chiếm quyền là cluster bị chiếm quyền. Jenkins chỉ cần quyền ghi vào một repo Git. Không có credential cluster nào trong Jenkins.
Không biết cluster đang chạy gì. Ai đó sửa bằng kubectl thì không ai phát hiện. Git là nguồn sự thật. ArgoCD liên tục so sánh và báo sai lệch.
Rollback là chạy lại job cũ — mà job cũ có thể đã không còn tái lập được. Rollback là git revert. Luôn tái lập được.
Lịch sử deploy nằm trong log Jenkins, bị xoá theo retention. Lịch sử deploy là git log của repo cấu hình. Vĩnh viễn, có review, có người phê duyệt.
Tạo lại cluster từ đầu phải chạy lại hàng chục job theo đúng thứ tự. Trỏ ArgoCD vào repo là cluster tự dựng lại.

Hai repo, hai vai trò

order-service/                    ← repo CODE. Developer làm việc ở đây.
├── src/
├── pom.xml
├── Dockerfile
└── Jenkinsfile                   ← pipeline CI

gitops-config/                    ← repo CẤU HÌNH. Jenkins và người vận hành ghi vào.
├── apps/
│   └── order-service/
│       ├── base.yaml
│       ├── dev.yaml              ← Jenkins tự bump image.tag ở đây
│       ├── staging.yaml          ← Jenkins bump sau khi test staging xong
│       └── prod.yaml             ← người phê duyệt bump, qua pull request
└── argocd/
    └── applicationset.yaml
Vì sao tách hai repo:
  • Phân quyền khác nhau. Developer merge được vào repo code; chỉ người được phê duyệt mới merge được prod.yaml.
  • Tránh vòng lặp CI. Nếu cấu hình nằm cùng repo code, Jenkins commit bump tag sẽ kích hoạt lại chính pipeline đó. Phải thêm [skip ci] và logic loại trừ — phức tạp và dễ sai.
  • Một repo cấu hình cho nhiều service. Nhìn một chỗ biết toàn bộ cluster đang chạy gì.

Nguyên tắc thiết kế pipeline

Nguyên tắcLý do
Fail nhanh Xếp bước nhanh và hay fail lên trước: lint, unit test, quét secret. Đừng để developer chờ 15 phút mới biết sai một dấu phẩy.
Build một lần Một artifact đi qua mọi môi trường. Build lại cho từng môi trường là mất ý nghĩa của việc test.
Tag bất biến Git SHA. Không bao giờ deploy latest.
Pipeline là code Jenkinsfile trong repo, review qua pull request. Không cấu hình job bằng giao diện web — không ai biết ai đổi gì lúc nào.
Không trạng thái Agent động, build xong là xoá. Build không được phụ thuộc vào thứ gì còn lại từ build trước.
Idempotent Chạy lại cùng commit phải ra cùng kết quả. Dùng lockfile, ghim phiên bản base image.
Lợi ích lớn nhất của việc Jenkins commit vào Git thay vì gọi helm upgrade?
◀ Chặng trước05 · Helm Chart Chặng tiếp theo ▶07 · ArgoCD & GitOps