Giao diện
CI/CD & Deploy
App scaffold từ @tasco-fe/cli đi kèm sẵn CI/CD chạy trên Jenkins (agent Kubernetes): build image bằng kaniko, push lên registry image của team (Harbor), deploy máy dev qua SSH bằng Docker Compose.
File sinh ra
| File | Vai trò |
|---|---|
Dockerfile | Đa stage: base (cài deps bằng pnpm) → check (lint+typecheck, dùng cho CI) → builder (Nitro build) → runner (image production, chỉ copy .output) |
Jenkinsfile.dev | Job nhánh dev: check → build:image → deploy:dev |
Jenkinsfile | Job nhánh main: check → build:image |
docker-compose.yml | Build + chạy thử image production ở local (docker compose up --build) |
docker-compose.dev.yml | Dùng bởi stage deploy:dev — không chạy tay |
docker-compose.prod.yml | Dùng bởi scripts/deploy-prod.sh trên máy prod |
scripts/deploy-prod.sh | Deploy prod thủ công khi máy prod bị cô lập khỏi CI |
Luồng CI
dev → check → build+push image (tag SHA + dev) → deploy lên máy dev (tự động)
main → check → build+push image (tag SHA + main) — prod pull thủ công qua scriptMỗi nhánh là một Pipeline job riêng trên Jenkins, trỏ tới Jenkinsfile tương ứng. Package @tasco-fe/* công khai trên npmjs.org nên build không cần token registry. App dùng thêm package riêng cần auth thì ghi token tạm vào .npmrc trong build context rồi trả lại như cũ (không để lọt vào image runner).
Trước khi dùng — bắt buộc chỉnh theo hạ tầng thật của team
- Đổi
IMAGEtrongJenkinsfile,Jenkinsfile.devvàscripts/deploy-prod.shcho khớp project Harbor (mặc định<registry>/tasco/<tên-app>). - Đổi
DEPLOY_SERVER,DEPLOY_PATH,NUXT_AUTH_BASE_URL,NUXT_API_PROXY_TARGETtrongJenkinsfile.devnếu team dùng máy dev hoặc gateway khác. - Đổi cổng map trong
docker-compose.dev.yml(3001:3000) nếu máy dev đã có app khác chiếm cổng.
Credential Jenkins
| Credential ID | Kiểu | Ý nghĩa |
|---|---|---|
registry-credentials.id | Username/password | Push image lên registry (Harbor) — đổi theo credential thật của team |
dev-server-ssh.id | SSH key | SSH vào máy dev để deploy — đổi theo credential thật của team |
<tên-app>.nuxt-session-secret.dev.id | Secret text | Khoá ký cookie session của môi trường dev |
Deploy prod thủ công
bash
# Trên máy prod, cạnh docker-compose.prod.yml + .env (xem .env.example)
./scripts/deploy-prod.sh <SHA ngắn | main>