Triển khai
Thứ gì chạy ở đâu. Hai stack ShopNexus trên một cluster k3d, được Argo CD giữ khớp với repo, và tài liệu trên GitHub Pages.
Server, website, tài liệu và console chạy trên một cluster k3d, chia thành hai stack là dev và prod. Mỗi stack có namespace riêng và có Postgres, Restate, RustFS và hub AI (ai-gateway và ai-models, từ repo ai) của riêng nó. Mọi thứ cluster cần đều nằm trong infra/ ở repo tổng. App Android được build và cài bằng Gradle, không thuộc cluster.
| Stack | Tên miền | Namespace | Theo dõi |
|---|---|---|---|
| dev | dev.shopnexus.id.vn | shopnexus-dev | :main, theo digest |
| prod | shopnexus.id.vn | shopnexus-prod | một bản phát hành của repo tổng, vX.Y.Z |
Mỗi stack phục vụ website trên tên miền của nó và bốn host bên dưới: api. cho server, media. cho object store, docs. cho tài liệu và console. cho console.
Hệ thống đã được build và kiểm tra trên một cluster k3d chạy cục bộ. Việc dựng nó trên server của tác giả và chạy các bài diễn tập failover là bước tiếp theo, nên các host public ở trên chưa hoạt động.
Từ git push tới pod
flowchart TB push[git push lên main] --> ci[GitHub Actions build.yml] ci --> ghcr["GHCR ghcr.io/shopnexus/*<br/>:main và sha-#lt;commit#gt;"] ghcr --> iu[Argo CD Image Updater] iu --> argo[Argo CD] rel["release.yml của repo tổng<br/>X.Y.Z, tag vX.Y.Z"] --> argo argo --> devns[shopnexus-dev] argo --> prodns[shopnexus-prod] devns --> traefik[Traefik] prodns --> traefik
Repo của từng thành phần (server, website, docs, console) có một file .github/workflows/build.yml. Mỗi lần push lên main, workflow build image rồi đẩy lên GHCR với hai tag main và sha-<commit>. Khi phát hành lên prod, workflow Release của repo tổng thêm tag X.Y.Z vào image sha-<commit> của các commit mà submodule của nó trỏ tới. Các package để public, vì cluster kéo image về mà không có credential.
Argo CD Image Updater theo dõi GHCR cho dev. Nó theo digest của :main, ghi tag mới thành một tham số Helm trên stack-dev, rồi Argo CD sync chart trong infra/stack vào shopnexus-dev. Prod không dùng Image Updater: workflow Release ghi phiên bản vào infra/ và gắn tag vX.Y.Z cho repo tổng, rồi stack-prod render infra/stack ở tag đó. CI không bao giờ kết nối tới cluster. Traefik, đi kèm k3s, định tuyến mỗi request theo header Host tới các Service của stack.
Cluster
Tài liệu trên GitHub Pages
Tài liệu có thêm một bản triển khai bên ngoài cluster. Mỗi lần push lên main của repo docs, .github/workflows/pages.yml build trang Astro bằng Bun và xuất bản trên GitHub Pages tại https://shopnexus.github.io/docs/. Bản build đó đặt DOCS_BASE theo tiền tố đường dẫn của Pages và bỏ tab Developers nội bộ. Image trong mỗi stack được build với DOCS_BASE=/ và phục vụ trang ở gốc của docs.<domain>.
Server kiểm tra gì ở production
Server từ chối khởi động với APP_ENV=prod khi:
RESTATE_IDENTITY_KEYđể trống;FCM_CREDENTIALSđể trống, khi đó push chỉ được ghi log;PNV_TEST_NUMBERS=true, khi đó số test của PNV đăng nhập được.
Ở mọi môi trường, server cũng từ chối khởi động khi còn migration chưa chạy, vì vậy Job migrate chạy trước server trong mỗi stack. Chart đặt APP_ENV theo appEnv trong file values, đặt PNV_TEST_NUMBERS=false trong values-prod.yaml và LOG_FORMAT=json ở cả hai stack; các biến khác của server nằm ở trang Cấu hình.