Skip to content

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 ​

FileVai 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.devJob nhánh dev: check → build:image → deploy:dev
JenkinsfileJob nhánh main: check → build:image
docker-compose.ymlBuild + chạy thử image production ở local (docker compose up --build)
docker-compose.dev.ymlDùng bởi stage deploy:dev — không chạy tay
docker-compose.prod.ymlDùng bởi scripts/deploy-prod.sh trên máy prod
scripts/deploy-prod.shDeploy 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 script

Mỗ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 IMAGE trong Jenkinsfile, Jenkinsfile.dev và scripts/deploy-prod.sh cho khớp project Harbor (mặc định <registry>/tasco/<tên-app>).
  • Đổi DEPLOY_SERVER, DEPLOY_PATH, NUXT_AUTH_BASE_URL, NUXT_API_PROXY_TARGET trong Jenkinsfile.dev nế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 IDKiểuÝ nghĩa
registry-credentials.idUsername/passwordPush image lên registry (Harbor) — đổi theo credential thật của team
dev-server-ssh.idSSH keySSH vào máy dev để deploy — đổi theo credential thật của team
<tên-app>.nuxt-session-secret.dev.idSecret textKhoá 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>